certificates

Documentation

Overview

Package certificates manages TLS certificates on KraftCloud.

Index

• Constants
• type CertificatesService
  • func NewCertificatesClientFromOptions(opts *options.Options) CertificatesService
• type DeleteResponseItem
• type GetResponseItem
• type GetResponseServiceGroup
• type ListResponseItem

Constants

const Endpoint = "/certificates"

Endpoint is the public path for the certificates service.

Types

type CertificatesService

type CertificatesService interface {
	kcclient.ServiceClient[CertificatesService]

	// GetByUUIDs returns the current status and the properties of one or more
	// certificate(s) by their UUID(s).
	//
	// See: https://docs.kraft.cloud/api/v1/certificates/#getting-the-status-of-a-certificate
	GetByUUIDs(ctx context.Context, uuids ...string) ([]GetResponseItem, error)

	// GetByNames returns the current status and the properties of one or more
	// certificate(s) by their names(s).
	//
	// See: https://docs.kraft.cloud/api/v1/certificates/#getting-the-status-of-a-certificate
	GetByNames(ctx context.Context, names ...string) ([]GetResponseItem, error)

	// DeleteByUUIDs deletes one or more certificate(s) by their UUID(s).
	//
	// See: https://docs.kraft.cloud/api/v1/certificates/#deleting-a-certificate
	DeleteByUUIDs(ctx context.Context, uuids ...string) ([]DeleteResponseItem, error)

	// DeleteByNames deletes one or more certificate(s) by their UUID(s).
	//
	// See: https://docs.kraft.cloud/api/v1/certificates/#deleting-a-certificate
	DeleteByNames(ctx context.Context, names ...string) ([]DeleteResponseItem, error)

	// List all existing certificates.
	//
	// See: https://docs.kraft.cloud/api/v1/certificates/#list-existing-certificates
	List(ctx context.Context) ([]ListResponseItem, error)
}

func NewCertificatesClientFromOptions

func NewCertificatesClientFromOptions(opts *options.Options) CertificatesService

NewCertificatesClientFromOptions instantiates a new certificates service client based on the provided pre-existing options.

type DeleteResponseItem

type DeleteResponseItem struct {
	Status string `json:"status"`
	UUID   string `json:"uuid"`
	Name   string `json:"name"`

	kcclient.APIResponseCommon
}

DeleteResponseItem is a data item from a response to a DELETE /certificates request. https://docs.kraft.cloud/api/v1/certificates/#deleting-a-certificate

type GetResponseItem

type GetResponseItem struct {
	Status        string                    `json:"status"`
	UUID          string                    `json:"uuid"`
	Name          string                    `json:"name"`
	CreatedAt     string                    `json:"created_at"`
	CommonName    string                    `json:"common_name"`
	State         string                    `json:"state"`
	Subject       string                    `json:"subject"`
	Issuer        string                    `json:"issuer"`
	SerialNumber  string                    `json:"serial_number"`
	NotBefore     string                    `json:"not_before"`
	NotAfter      string                    `json:"not_after"`
	ServiceGroups []GetResponseServiceGroup `json:"service_groups"`

	kcclient.APIResponseCommon
}

GetResponseItem is a data item from a response to a GET /certificates request. https://docs.kraft.cloud/api/v1/certificates/#getting-the-status-of-a-certificate

type GetResponseServiceGroup

type GetResponseServiceGroup struct {
	UUID string `json:"uuid"`
	Name string `json:"name"`
}

type ListResponseItem

type ListResponseItem struct {
	UUID string `json:"uuid"`
	Name string `json:"name"`

	kcclient.APIResponseCommon
}

ListResponseItem is a data item from a response to a GET /certificates/list request. https://docs.kraft.cloud/api/v1/certificates/#list-existing-certificates