ssl_certificates

Creates, updates, deletes, gets or lists a ssl_certificates resource.

Overview

Name	ssl_certificates
Type	Resource
Id	linode.object_storage.ssl_certificates

Fields

The following fields are returned by SELECT queries:

get

Returns a boolean value indicating if this bucket has a corresponding TLS/SSL certificate that was uploaded by an Account user.

Name	Datatype	Description
ssl	boolean	Read-only A boolean indicating if this Bucket has a corresponding TLS/SSL certificate that was uploaded by an Account user.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	regionId, bucket		Returns a boolean value indicating if this bucket has a corresponding TLS/SSL certificate that was uploaded by an Account user. Learn more... Learn more...
create	insert	regionId, bucket, certificate, private_key		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 stored encrypted at rest. To replace an expired certificate, delete your current certificates and upload a new one. Learn more... Learn more...
delete	delete	regionId, bucket		Deletes this Object Storage bucket's user uploaded TLS/SSL certificate and private key. Learn more... Learn more...

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
bucket	string	The bucket name. (example: {{bucket}})
regionId	string	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.

SELECT examples

get

Returns a boolean value indicating if this bucket has a corresponding TLS/SSL certificate that was uploaded by an Account user.

Learn more...

Learn more...

SELECT
ssl
FROM linode.object_storage.ssl_certificates
WHERE regionId = '{{ regionId }}' -- required
AND bucket = '{{ bucket }}' -- required
;

INSERT examples

create

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 stored encrypted at rest.

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

Learn more...

Learn more...

INSERT INTO linode.object_storage.ssl_certificates (
certificate,
private_key,
regionId,
bucket
)
SELECT 
'{{ certificate }}' /* required */,
'{{ private_key }}' /* required */,
'{{ regionId }}',
'{{ bucket }}'
RETURNING
ssl
;

Manifest

# Description fields are for documentation purposes
- name: ssl_certificates
props:
  - name: regionId
    value: "{{ regionId }}"
    description: Required parameter for the ssl_certificates resource.
  - name: bucket
    value: "{{ bucket }}"
    description: Required parameter for the ssl_certificates resource.
  - name: certificate
    value: "{{ certificate }}"
    description: |
      Your Base64 encoded and PEM formatted SSL certificate.
      Line breaks must be represented as `
` in the string for requests (but not when using the Linode CLI)
  - name: private_key
    value: "{{ private_key }}"
    description: |
      The private key associated with this TLS/SSL certificate.
      Line breaks must be represented as `
` in the string for requests (but not when using the Linode CLI)

DELETE examples

delete

Deletes this Object Storage bucket's user uploaded TLS/SSL certificate and private key.

Learn more...

Learn more...

DELETE FROM linode.object_storage.ssl_certificates
WHERE regionId = '{{ regionId }}' --required
AND bucket = '{{ bucket }}' --required
;