Class CertificateAuthorityServiceClient (2.31.0)

Version 2.31.0

• 2.33.0-rc (latest)
• 2.32.0
• 2.31.0
• 2.30.0
• 2.29.0
• 2.28.0
• 2.27.0
• 2.26.0
• 2.25.1
• 2.24.0
• 2.23.0
• 2.22.0
• 2.21.0
• 2.20.0
• 2.19.0
• 2.18.0
• 2.17.0
• 2.16.0
• 2.15.1
• 2.14.0
• 2.13.0
• 2.12.0
• 2.11.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(NoAwaitTag, std::string const &, Options)

Activate a CertificateAuthority that is in state AWAITING_USER_ACTIVATION and is of type SUBORDINATE.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
name	std::string const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

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.

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

Activate a CertificateAuthority that is in state AWAITING_USER_ACTIVATION and is of type SUBORDINATE.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

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

Returns
Type	Description
StatusOr< google::longrunning::Operation >

ActivateCertificateAuthority(google::longrunning::Operation const &, Options)

Activate a CertificateAuthority that is in state AWAITING_USER_ACTIVATION and is of type SUBORDINATE.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

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

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(NoAwaitTag, std::string const &, google::cloud::security::privateca::v1::CertificateAuthority const &, std::string const &, Options)

Create a new CertificateAuthority in a given Project and Location.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
parent	std::string const &
certificate_authority	google::cloud::security::privateca::v1::CertificateAuthority const &
certificate_authority_id	std::string const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

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.

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

Create a new CertificateAuthority in a given Project and Location.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

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

Returns
Type	Description
StatusOr< google::longrunning::Operation >

CreateCertificateAuthority(google::longrunning::Operation const &, Options)

Create a new CertificateAuthority in a given Project and Location.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

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

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(NoAwaitTag, std::string const &, Options)

Disable a CertificateAuthority.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
name	std::string const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

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.

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

Disable a CertificateAuthority.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

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

Returns
Type	Description
StatusOr< google::longrunning::Operation >

DisableCertificateAuthority(google::longrunning::Operation const &, Options)

Disable a CertificateAuthority.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

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

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(NoAwaitTag, std::string const &, Options)

Enable a CertificateAuthority.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
name	std::string const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

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.

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

Enable a CertificateAuthority.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

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

Returns
Type	Description
StatusOr< google::longrunning::Operation >

EnableCertificateAuthority(google::longrunning::Operation const &, Options)

Enable a CertificateAuthority.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

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

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(NoAwaitTag, std::string const &, Options)

Undelete a CertificateAuthority that has been deleted.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
name	std::string const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

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.

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

Undelete a CertificateAuthority that has been deleted.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

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

Returns
Type	Description
StatusOr< google::longrunning::Operation >

UndeleteCertificateAuthority(google::longrunning::Operation const &, Options)

Undelete a CertificateAuthority that has been deleted.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

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

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(NoAwaitTag, std::string const &, Options)

Delete a CertificateAuthority.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
name	std::string const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

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.

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

Delete a CertificateAuthority.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

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

Returns
Type	Description
StatusOr< google::longrunning::Operation >

DeleteCertificateAuthority(google::longrunning::Operation const &, Options)

Delete a CertificateAuthority.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

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

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(NoAwaitTag, google::cloud::security::privateca::v1::CertificateAuthority const &, google::protobuf::FieldMask const &, Options)

Update a CertificateAuthority.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
certificate_authority	google::cloud::security::privateca::v1::CertificateAuthority const &
update_mask	google::protobuf::FieldMask const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

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.

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

Update a CertificateAuthority.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

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

Returns
Type	Description
StatusOr< google::longrunning::Operation >

UpdateCertificateAuthority(google::longrunning::Operation const &, Options)

Update a CertificateAuthority.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

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

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(NoAwaitTag, std::string const &, google::cloud::security::privateca::v1::CaPool const &, std::string const &, Options)

Create a CaPool.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
parent	std::string const &
ca_pool	google::cloud::security::privateca::v1::CaPool const &
ca_pool_id	std::string const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

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.

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

Create a CaPool.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

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

Returns
Type	Description
StatusOr< google::longrunning::Operation >

CreateCaPool(google::longrunning::Operation const &, Options)

Create a CaPool.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

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

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(NoAwaitTag, google::cloud::security::privateca::v1::CaPool const &, google::protobuf::FieldMask const &, Options)

Update a CaPool.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
ca_pool	google::cloud::security::privateca::v1::CaPool const &
update_mask	google::protobuf::FieldMask const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

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.

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

Update a CaPool.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

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

Returns
Type	Description
StatusOr< google::longrunning::Operation >

UpdateCaPool(google::longrunning::Operation const &, Options)

Update a CaPool.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

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

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(NoAwaitTag, std::string const &, Options)

Delete a CaPool.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
name	std::string const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

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.

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

Delete a CaPool.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

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

Returns
Type	Description
StatusOr< google::longrunning::Operation >

DeleteCaPool(google::longrunning::Operation const &, Options)

Delete a CaPool.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

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

FetchCaCerts(std::string const &, Options)

FetchCaCerts returns the current trust anchor for the CaPool.

This will include CA certificate chains for all certificate authorities in the ENABLED, DISABLED, or STAGED states.

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 certificate authorities in the ENABLED, DISABLED, or STAGED states.

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(NoAwaitTag, google::cloud::security::privateca::v1::CertificateRevocationList const &, google::protobuf::FieldMask const &, Options)

Update a CertificateRevocationList.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
certificate_revocation_list	google::cloud::security::privateca::v1::CertificateRevocationList const &
update_mask	google::protobuf::FieldMask const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

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.

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

Update a CertificateRevocationList.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

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

Returns
Type	Description
StatusOr< google::longrunning::Operation >

UpdateCertificateRevocationList(google::longrunning::Operation const &, Options)

Update a CertificateRevocationList.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

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

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(NoAwaitTag, std::string const &, google::cloud::security::privateca::v1::CertificateTemplate const &, std::string const &, Options)

Create a new CertificateTemplate in a given Project and Location.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
parent	std::string const &
certificate_template	google::cloud::security::privateca::v1::CertificateTemplate const &
certificate_template_id	std::string const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

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.

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

Create a new CertificateTemplate in a given Project and Location.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

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

Returns
Type	Description
StatusOr< google::longrunning::Operation >

CreateCertificateTemplate(google::longrunning::Operation const &, Options)

Create a new CertificateTemplate in a given Project and Location.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

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

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(NoAwaitTag, std::string const &, Options)

DeleteCertificateTemplate deletes a CertificateTemplate.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
name	std::string const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

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.

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

DeleteCertificateTemplate deletes a CertificateTemplate.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

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

Returns
Type	Description
StatusOr< google::longrunning::Operation >

DeleteCertificateTemplate(google::longrunning::Operation const &, Options)

DeleteCertificateTemplate deletes a CertificateTemplate.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

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

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(NoAwaitTag, google::cloud::security::privateca::v1::CertificateTemplate const &, google::protobuf::FieldMask const &, Options)

Update a CertificateTemplate.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
certificate_template	google::cloud::security::privateca::v1::CertificateTemplate const &
update_mask	google::protobuf::FieldMask const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

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.

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

Update a CertificateTemplate.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

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

Returns
Type	Description
StatusOr< google::longrunning::Operation >

UpdateCertificateTemplate(google::longrunning::Operation const &, Options)

Update a CertificateTemplate.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

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

ListLocations(google::cloud::location::ListLocationsRequest, Options)

Lists information about the supported locations for this service.

Parameters
Name	Description
request	google::cloud::location::ListLocationsRequest 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.location.ListLocationsRequest. 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::location::Location >	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.location.Location, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetLocation(google::cloud::location::GetLocationRequest const &, Options)

Gets information about a location.

Parameters
Name	Description
request	google::cloud::location::GetLocationRequest 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.location.GetLocationRequest. 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::location::Location >	the result of the RPC. The response message type (google.cloud.location.Location) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

SetIamPolicy(google::iam::v1::SetIamPolicyRequest const &, Options)

Sets the access control policy on the specified resource.

Replaces any existing policy.

Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.

Parameters
Name	Description
request	google::iam::v1::SetIamPolicyRequest 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.iam.v1.SetIamPolicyRequest. 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::iam::v1::Policy >	the result of the RPC. The response message type (google.iam.v1.Policy) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetIamPolicy(google::iam::v1::GetIamPolicyRequest const &, Options)

Gets the access control policy for a resource.

Returns an empty policy if the resource exists and does not have a policy set.

Parameters
Name	Description
request	google::iam::v1::GetIamPolicyRequest 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.iam.v1.GetIamPolicyRequest. 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::iam::v1::Policy >	the result of the RPC. The response message type (google.iam.v1.Policy) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

TestIamPermissions(google::iam::v1::TestIamPermissionsRequest const &, Options)

Returns permissions that a caller has on the specified resource.

If the resource does not exist, this will return an empty set of permissions, not a NOT_FOUND error.

Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning.

Parameters
Name	Description
request	google::iam::v1::TestIamPermissionsRequest 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.iam.v1.TestIamPermissionsRequest. 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::iam::v1::TestIamPermissionsResponse >	the result of the RPC. The response message type (google.iam.v1.TestIamPermissionsResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

ListOperations(std::string const &, std::string const &, Options)

Lists operations that match the specified filter in the request.

If the server doesn't support this method, it returns UNIMPLEMENTED.

NOTE: the name binding allows API services to override the binding to use different resource name schemes, such as users/*/operations. To override the binding, API services can add a binding such as "/v1/{name=users/*}/operations" to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id.

Parameters
Name	Description
name	std::string const & The name of the operation's parent resource.
filter	std::string const & The standard list filter.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StreamRange< google::longrunning::Operation >	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.longrunning.Operation, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListOperations(google::longrunning::ListOperationsRequest, Options)

Lists operations that match the specified filter in the request.

If the server doesn't support this method, it returns UNIMPLEMENTED.

NOTE: the name binding allows API services to override the binding to use different resource name schemes, such as users/*/operations. To override the binding, API services can add a binding such as "/v1/{name=users/*}/operations" to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id.

Parameters
Name	Description
request	google::longrunning::ListOperationsRequest 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.longrunning.ListOperationsRequest. 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::longrunning::Operation >	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.longrunning.Operation, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetOperation(std::string const &, Options)

Gets the latest state of a long-running operation.

Clients can use this method to poll the operation result at intervals as recommended by the API service.

Parameters
Name	Description
name	std::string const & The name of the operation resource.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::longrunning::Operation >	the result of the RPC. The response message type (google.longrunning.Operation) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetOperation(google::longrunning::GetOperationRequest const &, Options)

Gets the latest state of a long-running operation.

Clients can use this method to poll the operation result at intervals as recommended by the API service.

Parameters
Name	Description
request	google::longrunning::GetOperationRequest 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.longrunning.GetOperationRequest. 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::longrunning::Operation >	the result of the RPC. The response message type (google.longrunning.Operation) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

DeleteOperation(std::string const &, Options)

Deletes a long-running operation.

This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.

Parameters
Name	Description
name	std::string const & The name of the operation resource to be deleted.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
Status	a Status object. If the request failed, the status contains the details of the failure.

DeleteOperation(google::longrunning::DeleteOperationRequest const &, Options)

Deletes a long-running operation.

This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.

Parameters
Name	Description
request	google::longrunning::DeleteOperationRequest 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.longrunning.DeleteOperationRequest. 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
Status	a Status object. If the request failed, the status contains the details of the failure.

CancelOperation(std::string const &, Options)

Starts asynchronous cancellation on a long-running operation.

The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to Code.CANCELLED.

Parameters
Name	Description
name	std::string const & The name of the operation resource to be cancelled.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
Status	a Status object. If the request failed, the status contains the details of the failure.

CancelOperation(google::longrunning::CancelOperationRequest const &, Options)

Starts asynchronous cancellation on a long-running operation.

The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to Code.CANCELLED.

Parameters
Name	Description
request	google::longrunning::CancelOperationRequest 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.longrunning.CancelOperationRequest. 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
Status	a Status object. If the request failed, the status contains the details of the failure.