Add a TLS/SSL certificate to a bucket

post

https://api.linode.com/{apiVersion}/object-storage/buckets/{regionId}/{bucket}/ssl

Upload a TLS/SSL certificate and private key to be served when you visit your Object Storage bucket via HTTPS. Your TLS/SSL certificate and private key are encrypted and stored at rest.

To replace an expired certificate, delete your current certificates and upload a new one.

📘
TLS/SSL certificates are only supported with legacy endpoints (E0 and E1).

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

OAuth scopes. Your user needs these scopes assigned. Learn more.
- Scopes: object_storage:read_write

CLI

linode-cli object-storage ssl-upload \
  us-east-1 example-bucket \
  --certificate "-----BEGIN CERTIFICATE-----
                 CERTIFICATE_INFORMATION
                 -----END CERTIFICATE-----" \
  --private_key "-----BEGIN PRIVATE KEY-----
                 PRIVATE_KEY_INFORMATION
                 -----END PRIVATE KEY-----"

Learn more

Path Params

apiVersion

string

enum

required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:

regionId

string

required

Identifies a region where this bucket lives.

📘
You can use a clusterId in place of regionId in requests for buckets that you created using the legacy version of the API. Run List clusters to see each cluster id.

bucket

string

required

The bucket name.

Body Params

Upload a TLS/SSL certificate and private key to be served when you visit your Object Storage bucket via HTTPS.

certificate

string

required

Your Base64-encoded and PEM formatted SSL certificate. Include line breaks as \n in the string for requests, but not when using the Linode CLI.

private_key

string

required

The private key associated with this TLS/SSL certificate. Include line breaks as \n in the string for requests, but not when using the Linode CLI.

Responses

200The response indicates whether this bucket has a corresponding TLS/SSL certificate that was uploaded by a user.

defaultSee Errors for the range of possible error response codes.