certificate_authorities

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

Overview

Name	certificate_authorities
Type	Resource
Id	confluent.iam.certificate_authorities

Fields

Name	Datatype	Description
id	string	ID is the "natural identifier" for an object within its scope/namespace; it is normally unique across time but not space. That is, you can assume that the ID will not be reclaimed and reused after an object is deleted ("time"); however, it may collide with IDs for other object kinds or objects of the same kind within a different scope/namespace ("space").
description	string	A description of the certificate authority.
api_version	string	APIVersion defines the schema version of this representation of a resource.
certificate_chain_filename	string	The file name of the uploaded pem file for this certificate authority.
crl_source	string	The source specifies whether the Certificate Revocation List (CRL) is updated from either local file uploaded (LOCAL) or from url of CRL (URL).
crl_updated_at	string	The timestamp for when CRL was last updated.
crl_url	string	The url from which to fetch the CRL for the certificate authority if crl_source is URL.
display_name	string	The human-readable name of the certificate authority.
expiration_dates	array	The expiration dates of certificates in the chain.
fingerprints	array	The fingerprints for each certificate in the certificate chain. These are SHA-1 encoded strings that act as unique identifiers for the certificates in the chain.
kind	string	Kind defines the object this REST resource represents.
metadata	``	ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
serial_numbers	array	The serial numbers for each certificate in the certificate chain.
state	string	The current state of the certificate authority.

Methods

Name	Accessible by	Required Params	Description
get_iam_v2certificate_authority	SELECT	id	Make a request to read a certificate authority.
list_iam_v2certificate_authorities	SELECT		Retrieve a sorted, filtered, paginated list of all certificate authorities.
create_iam_v2certificate_authority	INSERT		Make a request to create a certificate authority.
delete_iam_v2certificate_authority	DELETE	id	Make a request to delete a certificate authority.
update_iam_v2certificate_authority	EXEC	id	Make a request to update a certificate authority.

SELECT examples

Retrieve a sorted, filtered, paginated list of all certificate authorities.

SELECT
id,
description,
api_version,
certificate_chain_filename,
crl_source,
crl_updated_at,
crl_url,
display_name,
expiration_dates,
fingerprints,
kind,
metadata,
serial_numbers,
state
FROM confluent.iam.certificate_authorities
;

INSERT example

Use the following StackQL query and manifest file to create a new certificate_authorities resource.

All Properties

/*+ create */
INSERT INTO confluent.iam.certificate_authorities (
data__display_name,
data__description,
data__certificate_chain,
data__certificate_chain_filename,
data__crl_url,
data__crl_chain
)
SELECT 
'{{ display_name }}',
'{{ description }}',
'{{ certificate_chain }}',
'{{ certificate_chain_filename }}',
'{{ crl_url }}',
'{{ crl_chain }}'
;

Manifest

- name: certificate_authorities
  props:
    - name: display_name
      value: string
    - name: description
      value: string
    - name: certificate_chain
      value: string
    - name: certificate_chain_filename
      value: string
    - name: crl_url
      value: string
    - name: crl_chain
      value: string

DELETE example

Deletes the specified certificate_authorities resource.

/*+ delete */
DELETE FROM confluent.iam.certificate_authorities
WHERE id = '{{ id }}';