Add a TLS/SSL certificate to a bucket

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.

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
string
enum
required

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

Allowed:
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.

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.

string
required

Your Base64 encoded and PEM formatted SSL certificate.

Line breaks must be represented as \n in the string for requests (but not when using the Linode CLI)

string
required

The private key associated with this TLS/SSL certificate.

Line breaks must be represented as \n in the string for requests (but not when using the Linode CLI)

Responses

Language
Credentials
LoadingLoading…
Response
Choose an example:
application/json