custom_trust_store

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

Overview

Name	custom_trust_store
Type	Resource
Id	cloudflare.acm.custom_trust_store

Fields

The following fields are returned by SELECT queries:

get

Custom Origin Trust Store Details response

Name	Datatype	Description
id	string	Identifier. (example: 023e105f4ecef8ad9ca31a8372d0c353)
certificate	string	The zone's SSL certificate or certificate and the intermediate(s). (example: -----BEGIN CERTIFICATE----- MIIDdjCCAl6gAwIBAgIJAPnMg0Fs+/B0MA0GCSqGSIb3DQEBCwUAMFsx... -----END CERTIFICATE----- )
expires_on	string (date-time)	When the certificate expires. (example: 2122-10-29T16:59:47Z)
issuer	string	The certificate authority that issued the certificate. (example: GlobalSign)
signature	string	The type of hash used for the certificate. (example: SHA256WithRSA)
status	string	Status of the zone's custom SSL. (initializing, pending_deployment, active, pending_deletion, deleted, expired) (example: active)
updated_at	string (date-time)	When the certificate was last modified. (example: 2014-01-01T05:20:00Z)
uploaded_on	string (date-time)	When the certificate was uploaded to Cloudflare. (example: 2014-01-01T05:20:00Z)

list

Custom Origin Trust Store Details response

Name	Datatype	Description
id	string	Identifier. (example: 023e105f4ecef8ad9ca31a8372d0c353)
certificate	string	The zone's SSL certificate or certificate and the intermediate(s). (example: -----BEGIN CERTIFICATE----- MIIDdjCCAl6gAwIBAgIJAPnMg0Fs+/B0MA0GCSqGSIb3DQEBCwUAMFsx... -----END CERTIFICATE----- )
expires_on	string (date-time)	When the certificate expires. (example: 2122-10-29T16:59:47Z)
issuer	string	The certificate authority that issued the certificate. (example: GlobalSign)
signature	string	The type of hash used for the certificate. (example: SHA256WithRSA)
status	string	Status of the zone's custom SSL. (initializing, pending_deployment, active, pending_deletion, deleted, expired) (example: active)
updated_at	string (date-time)	When the certificate was last modified. (example: 2014-01-01T05:20:00Z)
uploaded_on	string (date-time)	When the certificate was uploaded to Cloudflare. (example: 2014-01-01T05:20:00Z)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	custom_origin_trust_store_id, zone_id		Retrieves details about a specific certificate in the custom origin trust store, including expiration and subject information.
list	select	zone_id	page, per_page, limit, offset	Get Custom Origin Trust Store for a Zone.
create	insert	zone_id, certificate		Add Custom Origin Trust Store for a Zone.
delete	delete	custom_origin_trust_store_id, zone_id		Removes a CA certificate from the custom origin trust store. Origins using certificates signed by this CA will no longer be trusted.

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
custom_origin_trust_store_id	string
zone_id	string	The Cloudflare zone ID.
limit	integer
offset	integer
page	number
per_page	number

SELECT examples

get

Retrieves details about a specific certificate in the custom origin trust store, including expiration and subject information.

SELECT
id,
certificate,
expires_on,
issuer,
signature,
status,
updated_at,
uploaded_on
FROM cloudflare.acm.custom_trust_store
WHERE custom_origin_trust_store_id = '{{ custom_origin_trust_store_id }}' -- required
AND zone_id = '{{ zone_id }}' -- required
;

list

Get Custom Origin Trust Store for a Zone.

SELECT
id,
certificate,
expires_on,
issuer,
signature,
status,
updated_at,
uploaded_on
FROM cloudflare.acm.custom_trust_store
WHERE zone_id = '{{ zone_id }}' -- required
AND page = '{{ page }}'
AND per_page = '{{ per_page }}'
AND limit = '{{ limit }}'
AND offset = '{{ offset }}'
;

INSERT examples

create

Add Custom Origin Trust Store for a Zone.

INSERT INTO cloudflare.acm.custom_trust_store (
certificate,
zone_id
)
SELECT 
'{{ certificate }}' /* required */,
'{{ zone_id }}'
RETURNING
errors,
messages,
result,
success
;

Manifest

# Description fields are for documentation purposes
- name: custom_trust_store
props:
  - name: zone_id
    value: "{{ zone_id }}"
    description: Required parameter for the custom_trust_store resource.
  - name: certificate
    value: "{{ certificate }}"
    description: |
      The zone's SSL certificate or certificate and the intermediate(s).

DELETE examples

delete

Removes a CA certificate from the custom origin trust store. Origins using certificates signed by this CA will no longer be trusted.

DELETE FROM cloudflare.acm.custom_trust_store
WHERE custom_origin_trust_store_id = '{{ custom_origin_trust_store_id }}' --required
AND zone_id = '{{ zone_id }}' --required
;