Skip to main content

certificate_authorities

Overview

Namecertificate_authorities
TypeResource
Idgoogle.privateca.certificate_authorities

Fields

NameDatatypeDescription
namestringOutput only. The resource name for this CertificateAuthority in the format projects/*/locations/*/caPools/*/certificateAuthorities/*.
accessUrlsobjectURLs where a CertificateAuthority will publish content.
caCertificateDescriptionsarrayOutput only. A structured description of this CertificateAuthority's CA certificate and its issuers. Ordered as self-to-root.
configobjectA CertificateConfig describes an X.509 certificate or CSR that is to be created, as an alternative to using ASN.1.
createTimestringOutput only. The time at which this CertificateAuthority was created.
deleteTimestringOutput only. The time at which this CertificateAuthority was soft deleted, if it is in the DELETED state.
expireTimestringOutput only. The time at which this CertificateAuthority will be permanently purged, if it is in the DELETED state.
gcsBucketstringImmutable. The name of a Cloud Storage bucket where this CertificateAuthority will publish content, such as the CA certificate and CRLs. This must be a bucket name, without any prefixes (such as gs://) or suffixes (such as .googleapis.com). For example, to use a bucket named my-bucket, you would simply specify my-bucket. If not specified, a managed bucket will be created.
keySpecobjectA Cloud KMS key configuration that a CertificateAuthority will use.
labelsobjectOptional. Labels with user-defined metadata.
lifetimestringRequired. Immutable. The desired lifetime of the CA certificate. Used to create the "not_before_time" and "not_after_time" fields inside an X.509 certificate.
pemCaCertificatesarrayOutput only. This CertificateAuthority's certificate chain, including the current CertificateAuthority's certificate. Ordered such that the root issuer is the final element (consistent with RFC 5246). For a self-signed CA, this will only list the current CertificateAuthority's certificate.
statestringOutput only. The State for this CertificateAuthority.
subordinateConfigobjectDescribes a subordinate CA's issuers. This is either a resource name to a known issuing CertificateAuthority, or a PEM issuer certificate chain.
tierstringOutput only. The CaPool.Tier of the CaPool that includes this CertificateAuthority.
typestringRequired. Immutable. The Type of this CertificateAuthority.
updateTimestringOutput only. The time at which this CertificateAuthority was last updated.

Methods

NameAccessible byRequired ParamsDescription
getSELECTcaPoolsId, certificateAuthoritiesId, locationsId, projectsIdReturns a CertificateAuthority.
listSELECTcaPoolsId, locationsId, projectsIdLists CertificateAuthorities.
createINSERTcaPoolsId, locationsId, projectsIdCreate a new CertificateAuthority in a given Project and Location.
deleteDELETEcaPoolsId, certificateAuthoritiesId, locationsId, projectsIdDelete a CertificateAuthority.
_listEXECcaPoolsId, locationsId, projectsIdLists CertificateAuthorities.
activateEXECcaPoolsId, certificateAuthoritiesId, locationsId, projectsIdActivate a CertificateAuthority that is in state AWAITING_USER_ACTIVATION and is of type SUBORDINATE. After the parent Certificate Authority signs a certificate signing request from FetchCertificateAuthorityCsr, this method can complete the activation process.
disableEXECcaPoolsId, certificateAuthoritiesId, locationsId, projectsIdDisable a CertificateAuthority.
enableEXECcaPoolsId, certificateAuthoritiesId, locationsId, projectsIdEnable a CertificateAuthority.
fetchEXECcaPoolsId, certificateAuthoritiesId, locationsId, projectsIdFetch a certificate signing request (CSR) from a CertificateAuthority that is in state AWAITING_USER_ACTIVATION and is of type SUBORDINATE. The CSR must then be signed by the desired parent Certificate Authority, which could be another CertificateAuthority resource, or could be an on-prem certificate authority. See also ActivateCertificateAuthority.
patchEXECcaPoolsId, certificateAuthoritiesId, locationsId, projectsIdUpdate a CertificateAuthority.
undeleteEXECcaPoolsId, certificateAuthoritiesId, locationsId, projectsIdUndelete a CertificateAuthority that has been deleted.