ByCloud Docs
GuidesCLIAPISDK

Create certificate

bycloud certificates create --name <name> --type <type> [flags]

Create a new certificate. Supports two types: - **ACME**: Automatically issues a certificate using DNS-01 challenge. Supports multi-domain and wildcard certificates. After creation, configure the DNS CNAME records as specified in the response, then call the validate endpoint. - **Uploaded**: Upload your own certificate, private key, and optional chain.

Options

--output

(-o)

stringoptional

Output format: text, json, or yaml

Values: "text", "json", "yaml"

Default: "text"

Body Options

--name

stringrequired

Name of the certificate

--type

stringrequired

Values: "acme", "uploaded"

--certificate

stringoptional

PEM-encoded certificate (required when type is 'uploaded')

--chain

stringoptional

PEM-encoded certificate chain (optional for uploaded certificates)

--domains

arrayoptional

List of domains for ACME certificate (supports multi-domain and wildcard certs)

--private_key

stringoptional

PEM-encoded private key (required when type is 'uploaded')

Command

bycloud certificates create \
  --name "my-resource" \
  --type acme

Output

ID              550e8400-e29b-41d4-a716-446655440000
CRN             crn:sao1:certificate:certificate:550e8400-e29b-41d4-a716-446655440000
NAME            my-certificate
TYPE            acme
DOMAINS         example.com, *.example.com
STATUS          active
EXPIRES_AT      2024-01-15T10:30:00Z
RENEW_AFTER     2024-01-15T10:30:00Z
ERROR_MESSAGE   string
CREATED_AT      2024-01-15T10:30:00Z
UPDATED_AT      2024-01-15T10:30:00Z
DNS_SETUP
  RECORDS
    [0]
      RECORD_NAME     _acme-challenge.example.com
      RECORD_TYPE     CNAME
      RECORD_VALUE    example.com.acme.bycloud.io
    [1]
      RECORD_NAME     _acme-challenge.example.com
      RECORD_TYPE     CNAME
      RECORD_VALUE    example.com.acme.bycloud.io
  INSTRUCTIONS    Create the following CNAME records to validate domain ownership
BINDINGS
  [0]
    ID              550e8400-e29b-41d4-a716-446655440000
    CRN             crn:sao1:certificate:binding:550e8400-e29b-41d4-a716-446655440000
    CERTIFICATE_ID  550e8400-e29b-41d4-a716-446655440001
    RESOURCE_TYPE   octavia:listener
    RESOURCE_ID     550e8400-e29b-41d4-a716-446655440002
    OPTIONS
      SNI             false
    STATUS          active
    ERROR_MESSAGE   string
    CREATED_AT      2024-01-15T10:30:00Z
    UPDATED_AT      2024-01-15T10:30:00Z
  [1]
    ID              550e8400-e29b-41d4-a716-446655440000
    CRN             crn:sao1:certificate:binding:550e8400-e29b-41d4-a716-446655440000
    CERTIFICATE_ID  550e8400-e29b-41d4-a716-446655440001
    RESOURCE_TYPE   octavia:listener
    RESOURCE_ID     550e8400-e29b-41d4-a716-446655440002
    OPTIONS
      SNI             false
    STATUS          active
    ERROR_MESSAGE   string
    CREATED_AT      2024-01-15T10:30:00Z
    UPDATED_AT      2024-01-15T10:30:00Z