Class CertificateAuthorityServiceClient (2.20.0)

Certificate Authority Service manages private certificate authorities and issued certificates.

Equality

Instances of this class created via copy-construction or copy-assignment always compare equal. Instances created with equal std::shared_ptr<*Connection> objects compare equal. Objects that compare equal share the same underlying resources.

Performance

Creating a new instance of this class is a relatively expensive operation, new objects establish new connections to the service. In contrast, copy-construction, move-construction, and the corresponding assignment operations are relatively efficient as the copies share all underlying resources.

Thread Safety

Concurrent access to different instances of this class, even if they compare equal, is guaranteed to work. Two or more threads operating on the same instance of this class is not guaranteed to work. Since copy-construction and move-construction is a relatively efficient operation, consider using such a copy when using this class from multiple threads.

Constructors

CertificateAuthorityServiceClient(CertificateAuthorityServiceClient const &)

Copy and move support

Parameter
Name Description
CertificateAuthorityServiceClient const &

CertificateAuthorityServiceClient(CertificateAuthorityServiceClient &&)

Copy and move support

Parameter
Name Description
CertificateAuthorityServiceClient &&

CertificateAuthorityServiceClient(std::shared_ptr< CertificateAuthorityServiceConnection >, Options)

Parameters
Name Description
connection std::shared_ptr< CertificateAuthorityServiceConnection >
opts Options

Operators

operator=(CertificateAuthorityServiceClient const &)

Copy and move support

Parameter
Name Description
CertificateAuthorityServiceClient const &
Returns
Type Description
CertificateAuthorityServiceClient &

operator=(CertificateAuthorityServiceClient &&)

Copy and move support

Parameter
Name Description
CertificateAuthorityServiceClient &&
Returns
Type Description
CertificateAuthorityServiceClient &

Functions

CreateCertificate(std::string const &, google::cloud::security::privateca::v1::Certificate const &, std::string const &, Options)

Create a new Certificate in a given Project, Location from a particular CaPool.

Parameters
Name Description
parent std::string const &

Required. The resource name of the CaPool associated with the Certificate, in the format projects/*/locations/*/caPools/*.

certificate google::cloud::security::privateca::v1::Certificate const &

Required. A Certificate with initial field values.

certificate_id std::string const &

Optional. It must be unique within a location and match the regular expression [a-zA-Z0-9_-]{1,63}. This field is required when using a CertificateAuthority in the Enterprise [CertificateAuthority.Tier][], but is optional and its value is ignored otherwise.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::Certificate >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.Certificate) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

CreateCertificate(google::cloud::security::privateca::v1::CreateCertificateRequest const &, Options)

Create a new Certificate in a given Project, Location from a particular CaPool.

Parameters
Name Description
request google::cloud::security::privateca::v1::CreateCertificateRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.CreateCertificateRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::Certificate >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.Certificate) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetCertificate(std::string const &, Options)

Returns a Certificate.

Parameters
Name Description
name std::string const &

Required. The name of the Certificate to get.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::Certificate >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.Certificate) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetCertificate(google::cloud::security::privateca::v1::GetCertificateRequest const &, Options)

Returns a Certificate.

Parameters
Name Description
request google::cloud::security::privateca::v1::GetCertificateRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.GetCertificateRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::Certificate >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.Certificate) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

ListCertificates(std::string const &, Options)

Lists Certificates.

Parameters
Name Description
parent std::string const &

Required. The resource name of the location associated with the Certificates, in the format projects/*/locations/*/caPools/*.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StreamRange< google::cloud::security::privateca::v1::Certificate >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.security.privateca.v1.Certificate, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListCertificates(google::cloud::security::privateca::v1::ListCertificatesRequest, Options)

Lists Certificates.

Parameters
Name Description
request google::cloud::security::privateca::v1::ListCertificatesRequest

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.ListCertificatesRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StreamRange< google::cloud::security::privateca::v1::Certificate >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.security.privateca.v1.Certificate, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

RevokeCertificate(std::string const &, Options)

Revoke a Certificate.

Parameters
Name Description
name std::string const &

Required. The resource name for this Certificate in the format projects/*/locations/*/caPools/*/certificates/*.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::Certificate >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.Certificate) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

RevokeCertificate(google::cloud::security::privateca::v1::RevokeCertificateRequest const &, Options)

Revoke a Certificate.

Parameters
Name Description
request google::cloud::security::privateca::v1::RevokeCertificateRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.RevokeCertificateRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::Certificate >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.Certificate) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

UpdateCertificate(google::cloud::security::privateca::v1::Certificate const &, google::protobuf::FieldMask const &, Options)

Update a Certificate.

Currently, the only field you can update is the labels field.

Parameters
Name Description
certificate google::cloud::security::privateca::v1::Certificate const &

Required. Certificate with updated values.

update_mask google::protobuf::FieldMask const &

Required. A list of fields to be updated in this request.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::Certificate >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.Certificate) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

UpdateCertificate(google::cloud::security::privateca::v1::UpdateCertificateRequest const &, Options)

Update a Certificate.

Currently, the only field you can update is the labels field.

Parameters
Name Description
request google::cloud::security::privateca::v1::UpdateCertificateRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.UpdateCertificateRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::Certificate >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.Certificate) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

ActivateCertificateAuthority(std::string const &, Options)

Activate 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.

Parameters
Name Description
name std::string const &

Required. The resource name for this CertificateAuthority in the format projects/*/locations/*/caPools/*/certificateAuthorities/*.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateAuthority > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateAuthority proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

ActivateCertificateAuthority(google::cloud::security::privateca::v1::ActivateCertificateAuthorityRequest const &, Options)

Activate 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.

Parameters
Name Description
request google::cloud::security::privateca::v1::ActivateCertificateAuthorityRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.ActivateCertificateAuthorityRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateAuthority > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateAuthority proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateCertificateAuthority(std::string const &, google::cloud::security::privateca::v1::CertificateAuthority const &, std::string const &, Options)

Create a new CertificateAuthority in a given Project and Location.

Parameters
Name Description
parent std::string const &

Required. The resource name of the CaPool associated with the CertificateAuthorities, in the format projects/*/locations/*/caPools/*.

certificate_authority google::cloud::security::privateca::v1::CertificateAuthority const &

Required. A CertificateAuthority with initial field values.

certificate_authority_id std::string const &

Required. It must be unique within a location and match the regular expression [a-zA-Z0-9_-]{1,63}
opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateAuthority > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateAuthority proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateCertificateAuthority(google::cloud::security::privateca::v1::CreateCertificateAuthorityRequest const &, Options)

Create a new CertificateAuthority in a given Project and Location.

Parameters
Name Description
request google::cloud::security::privateca::v1::CreateCertificateAuthorityRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.CreateCertificateAuthorityRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateAuthority > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateAuthority proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DisableCertificateAuthority(std::string const &, Options)

Disable a CertificateAuthority.

Parameters
Name Description
name std::string const &

Required. The resource name for this CertificateAuthority in the format projects/*/locations/*/caPools/*/certificateAuthorities/*.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateAuthority > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateAuthority proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DisableCertificateAuthority(google::cloud::security::privateca::v1::DisableCertificateAuthorityRequest const &, Options)

Disable a CertificateAuthority.

Parameters
Name Description
request google::cloud::security::privateca::v1::DisableCertificateAuthorityRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.DisableCertificateAuthorityRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateAuthority > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateAuthority proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

EnableCertificateAuthority(std::string const &, Options)

Enable a CertificateAuthority.

Parameters
Name Description
name std::string const &

Required. The resource name for this CertificateAuthority in the format projects/*/locations/*/caPools/*/certificateAuthorities/*.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateAuthority > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateAuthority proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

EnableCertificateAuthority(google::cloud::security::privateca::v1::EnableCertificateAuthorityRequest const &, Options)

Enable a CertificateAuthority.

Parameters
Name Description
request google::cloud::security::privateca::v1::EnableCertificateAuthorityRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.EnableCertificateAuthorityRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateAuthority > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateAuthority proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

FetchCertificateAuthorityCsr(std::string const &, Options)

Fetch 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.

Parameters
Name Description
name std::string const &

Required. The resource name for this CertificateAuthority in the format projects/*/locations/*/caPools/*/certificateAuthorities/*.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::FetchCertificateAuthorityCsrResponse >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.FetchCertificateAuthorityCsrResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

FetchCertificateAuthorityCsr(google::cloud::security::privateca::v1::FetchCertificateAuthorityCsrRequest const &, Options)

Fetch 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.

Parameters
Name Description
request google::cloud::security::privateca::v1::FetchCertificateAuthorityCsrRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.FetchCertificateAuthorityCsrRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::FetchCertificateAuthorityCsrResponse >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.FetchCertificateAuthorityCsrResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetCertificateAuthority(std::string const &, Options)

Returns a CertificateAuthority.

Parameters
Name Description
name std::string const &

Required. The name of the CertificateAuthority to get.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::CertificateAuthority >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.CertificateAuthority) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetCertificateAuthority(google::cloud::security::privateca::v1::GetCertificateAuthorityRequest const &, Options)

Returns a CertificateAuthority.

Parameters
Name Description
request google::cloud::security::privateca::v1::GetCertificateAuthorityRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.GetCertificateAuthorityRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::CertificateAuthority >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.CertificateAuthority) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

ListCertificateAuthorities(std::string const &, Options)

Lists CertificateAuthorities.

Parameters
Name Description
parent std::string const &

Required. The resource name of the CaPool associated with the CertificateAuthorities, in the format projects/*/locations/*/caPools/*.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StreamRange< google::cloud::security::privateca::v1::CertificateAuthority >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.security.privateca.v1.CertificateAuthority, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListCertificateAuthorities(google::cloud::security::privateca::v1::ListCertificateAuthoritiesRequest, Options)

Lists CertificateAuthorities.

Parameters
Name Description
request google::cloud::security::privateca::v1::ListCertificateAuthoritiesRequest

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.ListCertificateAuthoritiesRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StreamRange< google::cloud::security::privateca::v1::CertificateAuthority >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.security.privateca.v1.CertificateAuthority, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

UndeleteCertificateAuthority(std::string const &, Options)

Undelete a CertificateAuthority that has been deleted.

Parameters
Name Description
name std::string const &

Required. The resource name for this CertificateAuthority in the format projects/*/locations/*/caPools/*/certificateAuthorities/*.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateAuthority > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateAuthority proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UndeleteCertificateAuthority(google::cloud::security::privateca::v1::UndeleteCertificateAuthorityRequest const &, Options)

Undelete a CertificateAuthority that has been deleted.

Parameters
Name Description
request google::cloud::security::privateca::v1::UndeleteCertificateAuthorityRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.UndeleteCertificateAuthorityRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateAuthority > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateAuthority proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteCertificateAuthority(std::string const &, Options)

Delete a CertificateAuthority.

Parameters
Name Description
name std::string const &

Required. The resource name for this CertificateAuthority in the format projects/*/locations/*/caPools/*/certificateAuthorities/*.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateAuthority > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateAuthority proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteCertificateAuthority(google::cloud::security::privateca::v1::DeleteCertificateAuthorityRequest const &, Options)

Delete a CertificateAuthority.

Parameters
Name Description
request google::cloud::security::privateca::v1::DeleteCertificateAuthorityRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.DeleteCertificateAuthorityRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateAuthority > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateAuthority proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateCertificateAuthority(google::cloud::security::privateca::v1::CertificateAuthority const &, google::protobuf::FieldMask const &, Options)

Update a CertificateAuthority.

Parameters
Name Description
certificate_authority google::cloud::security::privateca::v1::CertificateAuthority const &

Required. CertificateAuthority with updated values.

update_mask google::protobuf::FieldMask const &

Required. A list of fields to be updated in this request.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateAuthority > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateAuthority proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateCertificateAuthority(google::cloud::security::privateca::v1::UpdateCertificateAuthorityRequest const &, Options)

Update a CertificateAuthority.

Parameters
Name Description
request google::cloud::security::privateca::v1::UpdateCertificateAuthorityRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.UpdateCertificateAuthorityRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateAuthority > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateAuthority proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateCaPool(std::string const &, google::cloud::security::privateca::v1::CaPool const &, std::string const &, Options)

Create a CaPool.

Parameters
Name Description
parent std::string const &

Required. The resource name of the location associated with the CaPool, in the format projects/*/locations/*.

ca_pool google::cloud::security::privateca::v1::CaPool const &

Required. A CaPool with initial field values.

ca_pool_id std::string const &

Required. It must be unique within a location and match the regular expression [a-zA-Z0-9_-]{1,63}
opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CaPool > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CaPool proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateCaPool(google::cloud::security::privateca::v1::CreateCaPoolRequest const &, Options)

Create a CaPool.

Parameters
Name Description
request google::cloud::security::privateca::v1::CreateCaPoolRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.CreateCaPoolRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CaPool > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CaPool proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateCaPool(google::cloud::security::privateca::v1::CaPool const &, google::protobuf::FieldMask const &, Options)

Update a CaPool.

Parameters
Name Description
ca_pool google::cloud::security::privateca::v1::CaPool const &

Required. CaPool with updated values.

update_mask google::protobuf::FieldMask const &

Required. A list of fields to be updated in this request.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CaPool > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CaPool proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateCaPool(google::cloud::security::privateca::v1::UpdateCaPoolRequest const &, Options)

Update a CaPool.

Parameters
Name Description
request google::cloud::security::privateca::v1::UpdateCaPoolRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.UpdateCaPoolRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CaPool > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CaPool proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

GetCaPool(std::string const &, Options)

Returns a CaPool.

Parameters
Name Description
name std::string const &

Required. The name of the CaPool to get.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::CaPool >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.CaPool) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetCaPool(google::cloud::security::privateca::v1::GetCaPoolRequest const &, Options)

Returns a CaPool.

Parameters
Name Description
request google::cloud::security::privateca::v1::GetCaPoolRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.GetCaPoolRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::CaPool >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.CaPool) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

ListCaPools(std::string const &, Options)

Lists CaPools.

Parameters
Name Description
parent std::string const &

Required. The resource name of the location associated with the CaPools, in the format projects/*/locations/*.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StreamRange< google::cloud::security::privateca::v1::CaPool >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.security.privateca.v1.CaPool, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListCaPools(google::cloud::security::privateca::v1::ListCaPoolsRequest, Options)

Lists CaPools.

Parameters
Name Description
request google::cloud::security::privateca::v1::ListCaPoolsRequest

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.ListCaPoolsRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StreamRange< google::cloud::security::privateca::v1::CaPool >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.security.privateca.v1.CaPool, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

DeleteCaPool(std::string const &, Options)

Delete a CaPool.

Parameters
Name Description
name std::string const &

Required. The resource name for this CaPool in the format projects/*/locations/*/caPools/*.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::OperationMetadata > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteCaPool(google::cloud::security::privateca::v1::DeleteCaPoolRequest const &, Options)

Delete a CaPool.

Parameters
Name Description
request google::cloud::security::privateca::v1::DeleteCaPoolRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.DeleteCaPoolRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::OperationMetadata > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

FetchCaCerts(std::string const &, Options)

FetchCaCerts returns the current trust anchor for the CaPool.

This will include CA certificate chains for all ACTIVE CertificateAuthority resources in the CaPool.

Parameters
Name Description
ca_pool std::string const &

Required. The resource name for the CaPool in the format projects/*/locations/*/caPools/*.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::FetchCaCertsResponse >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.FetchCaCertsResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

FetchCaCerts(google::cloud::security::privateca::v1::FetchCaCertsRequest const &, Options)

FetchCaCerts returns the current trust anchor for the CaPool.

This will include CA certificate chains for all ACTIVE CertificateAuthority resources in the CaPool.

Parameters
Name Description
request google::cloud::security::privateca::v1::FetchCaCertsRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.FetchCaCertsRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::FetchCaCertsResponse >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.FetchCaCertsResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetCertificateRevocationList(std::string const &, Options)

Returns a CertificateRevocationList.

Parameters
Name Description
name std::string const &

Required. The name of the CertificateRevocationList to get.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::CertificateRevocationList >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.CertificateRevocationList) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetCertificateRevocationList(google::cloud::security::privateca::v1::GetCertificateRevocationListRequest const &, Options)

Returns a CertificateRevocationList.

Parameters
Name Description
request google::cloud::security::privateca::v1::GetCertificateRevocationListRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.GetCertificateRevocationListRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::CertificateRevocationList >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.CertificateRevocationList) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

ListCertificateRevocationLists(std::string const &, Options)

Lists CertificateRevocationLists.

Parameters
Name Description
parent std::string const &

Required. The resource name of the location associated with the CertificateRevocationLists, in the format projects/*/locations/*/caPools/*/certificateAuthorities/*.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StreamRange< google::cloud::security::privateca::v1::CertificateRevocationList >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.security.privateca.v1.CertificateRevocationList, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListCertificateRevocationLists(google::cloud::security::privateca::v1::ListCertificateRevocationListsRequest, Options)

Lists CertificateRevocationLists.

Parameters
Name Description
request google::cloud::security::privateca::v1::ListCertificateRevocationListsRequest

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.ListCertificateRevocationListsRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StreamRange< google::cloud::security::privateca::v1::CertificateRevocationList >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.security.privateca.v1.CertificateRevocationList, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

UpdateCertificateRevocationList(google::cloud::security::privateca::v1::CertificateRevocationList const &, google::protobuf::FieldMask const &, Options)

Update a CertificateRevocationList.

Parameters
Name Description
certificate_revocation_list google::cloud::security::privateca::v1::CertificateRevocationList const &

Required. CertificateRevocationList with updated values.

update_mask google::protobuf::FieldMask const &

Required. A list of fields to be updated in this request.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateRevocationList > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateRevocationList proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateCertificateRevocationList(google::cloud::security::privateca::v1::UpdateCertificateRevocationListRequest const &, Options)

Update a CertificateRevocationList.

Parameters
Name Description
request google::cloud::security::privateca::v1::UpdateCertificateRevocationListRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.UpdateCertificateRevocationListRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateRevocationList > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateRevocationList proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateCertificateTemplate(std::string const &, google::cloud::security::privateca::v1::CertificateTemplate const &, std::string const &, Options)

Create a new CertificateTemplate in a given Project and Location.

Parameters
Name Description
parent std::string const &

Required. The resource name of the location associated with the CertificateTemplate, in the format projects/*/locations/*.

certificate_template google::cloud::security::privateca::v1::CertificateTemplate const &

Required. A CertificateTemplate with initial field values.

certificate_template_id std::string const &

Required. It must be unique within a location and match the regular expression [a-zA-Z0-9_-]{1,63}
opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateTemplate > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateTemplate proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateCertificateTemplate(google::cloud::security::privateca::v1::CreateCertificateTemplateRequest const &, Options)

Create a new CertificateTemplate in a given Project and Location.

Parameters
Name Description
request google::cloud::security::privateca::v1::CreateCertificateTemplateRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.CreateCertificateTemplateRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateTemplate > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateTemplate proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteCertificateTemplate(std::string const &, Options)

DeleteCertificateTemplate deletes a CertificateTemplate.

Parameters
Name Description
name std::string const &

Required. The resource name for this CertificateTemplate in the format projects/*/locations/*/certificateTemplates/*.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::OperationMetadata > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteCertificateTemplate(google::cloud::security::privateca::v1::DeleteCertificateTemplateRequest const &, Options)

DeleteCertificateTemplate deletes a CertificateTemplate.

Parameters
Name Description
request google::cloud::security::privateca::v1::DeleteCertificateTemplateRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.DeleteCertificateTemplateRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::OperationMetadata > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

GetCertificateTemplate(std::string const &, Options)

Returns a CertificateTemplate.

Parameters
Name Description
name std::string const &

Required. The name of the CertificateTemplate to get.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::CertificateTemplate >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.CertificateTemplate) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetCertificateTemplate(google::cloud::security::privateca::v1::GetCertificateTemplateRequest const &, Options)

Returns a CertificateTemplate.

Parameters
Name Description
request google::cloud::security::privateca::v1::GetCertificateTemplateRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.GetCertificateTemplateRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::security::privateca::v1::CertificateTemplate >

the result of the RPC. The response message type (google.cloud.security.privateca.v1.CertificateTemplate) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

ListCertificateTemplates(std::string const &, Options)

Lists CertificateTemplates.

Parameters
Name Description
parent std::string const &

Required. The resource name of the location associated with the CertificateTemplates, in the format projects/*/locations/*.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StreamRange< google::cloud::security::privateca::v1::CertificateTemplate >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.security.privateca.v1.CertificateTemplate, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListCertificateTemplates(google::cloud::security::privateca::v1::ListCertificateTemplatesRequest, Options)

Lists CertificateTemplates.

Parameters
Name Description
request google::cloud::security::privateca::v1::ListCertificateTemplatesRequest

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.ListCertificateTemplatesRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StreamRange< google::cloud::security::privateca::v1::CertificateTemplate >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.security.privateca.v1.CertificateTemplate, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

UpdateCertificateTemplate(google::cloud::security::privateca::v1::CertificateTemplate const &, google::protobuf::FieldMask const &, Options)

Update a CertificateTemplate.

Parameters
Name Description
certificate_template google::cloud::security::privateca::v1::CertificateTemplate const &

Required. CertificateTemplate with updated values.

update_mask google::protobuf::FieldMask const &

Required. A list of fields to be updated in this request.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateTemplate > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateTemplate proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateCertificateTemplate(google::cloud::security::privateca::v1::UpdateCertificateTemplateRequest const &, Options)

Update a CertificateTemplate.

Parameters
Name Description
request google::cloud::security::privateca::v1::UpdateCertificateTemplateRequest const &

Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.security.privateca.v1.UpdateCertificateTemplateRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
future< StatusOr< google::cloud::security::privateca::v1::CertificateTemplate > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.security.privateca.v1.CertificateTemplate proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.