Class CertificateManagerClient (2.23.0-rc)

API Overview.

Certificates Manager API allows customers to see and manage all their TLS certificates.

Certificates Manager API service provides methods to manage certificates, group them into collections, and create serving configuration that can be easily applied to other Cloud resources e.g. Target Proxies.

Data Model

The Certificates Manager service exposes the following resources:

  • Certificate that describes a single TLS certificate.
  • CertificateMap that describes a collection of certificates that can be attached to a target resource.
  • CertificateMapEntry that describes a single configuration entry that consists of a SNI and a group of certificates. It's a subresource of CertificateMap.

Certificate, CertificateMap and CertificateMapEntry IDs have to fully match the regexp [a-z0-9-]{1,63}. In other words,

  • only lower case letters, digits, and hyphen are allowed
  • length of the resource ID has to be in [1,63] range.

Provides methods to manage Cloud Certificate Manager entities.

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

CertificateManagerClient(CertificateManagerClient const &)

Copy and move support

Parameter
NameDescription
CertificateManagerClient const &

CertificateManagerClient(CertificateManagerClient &&)

Copy and move support

Parameter
NameDescription
CertificateManagerClient &&

CertificateManagerClient(std::shared_ptr< CertificateManagerConnection >, Options)

Parameters
NameDescription
connection std::shared_ptr< CertificateManagerConnection >
opts Options

Operators

operator=(CertificateManagerClient const &)

Copy and move support

Parameter
NameDescription
CertificateManagerClient const &
Returns
TypeDescription
CertificateManagerClient &

operator=(CertificateManagerClient &&)

Copy and move support

Parameter
NameDescription
CertificateManagerClient &&
Returns
TypeDescription
CertificateManagerClient &

Functions

ListCertificates(std::string const &, Options)

Lists Certificates in a given project and location.

Parameters
NameDescription
parent std::string const &

Required. The project and location from which the certificate should be listed, specified in the format projects/*/locations/*.

opts Options

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

Returns
TypeDescription
StreamRange< google::cloud::certificatemanager::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.certificatemanager.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::certificatemanager::v1::ListCertificatesRequest, Options)

Lists Certificates in a given project and location.

Parameters
NameDescription
request google::cloud::certificatemanager::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.certificatemanager.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
TypeDescription
StreamRange< google::cloud::certificatemanager::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.certificatemanager.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.

GetCertificate(std::string const &, Options)

Gets details of a single Certificate.

Parameters
NameDescription
name std::string const &

Required. A name of the certificate to describe. Must be in the format projects/*/locations/*/certificates/*.

opts Options

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

Returns
TypeDescription
StatusOr< google::cloud::certificatemanager::v1::Certificate >

the result of the RPC. The response message type (google.cloud.certificatemanager.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::certificatemanager::v1::GetCertificateRequest const &, Options)

Gets details of a single Certificate.

Parameters
NameDescription
request google::cloud::certificatemanager::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.certificatemanager.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
TypeDescription
StatusOr< google::cloud::certificatemanager::v1::Certificate >

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

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

Creates a new Certificate in a given project and location.

Parameters
NameDescription
parent std::string const &

Required. The parent resource of the certificate. Must be in the format projects/*/locations/*.

certificate google::cloud::certificatemanager::v1::Certificate const &

Required. A definition of the certificate to create.

certificate_id std::string const &

Required. A user-provided name of the certificate.

opts Options

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

Returns
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::Certificate > >

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.certificatemanager.v1.Certificate proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

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

Creates a new Certificate in a given project and location.

Parameters
NameDescription
request google::cloud::certificatemanager::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.certificatemanager.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
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::Certificate > >

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.certificatemanager.v1.Certificate proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

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

Updates a Certificate.

Parameters
NameDescription
certificate google::cloud::certificatemanager::v1::Certificate const &

Required. A definition of the certificate to update.

update_mask google::protobuf::FieldMask const &

Required. The update mask applies to the resource. For the FieldMask definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask.

opts Options

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

Returns
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::Certificate > >

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.certificatemanager.v1.Certificate proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

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

Updates a Certificate.

Parameters
NameDescription
request google::cloud::certificatemanager::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.certificatemanager.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
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::Certificate > >

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.certificatemanager.v1.Certificate proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteCertificate(std::string const &, Options)

Deletes a single Certificate.

Parameters
NameDescription
name std::string const &

Required. A name of the certificate to delete. Must be in the format projects/*/locations/*/certificates/*.

opts Options

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

Returns
TypeDescription
future< StatusOr< google::cloud::certificatemanager::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.certificatemanager.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteCertificate(google::cloud::certificatemanager::v1::DeleteCertificateRequest const &, Options)

Deletes a single Certificate.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::DeleteCertificateRequest 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.certificatemanager.v1.DeleteCertificateRequest. 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
TypeDescription
future< StatusOr< google::cloud::certificatemanager::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.certificatemanager.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

ListCertificateMaps(std::string const &, Options)

Lists CertificateMaps in a given project and location.

Parameters
NameDescription
parent std::string const &

Required. The project and location from which the certificate maps should be listed, specified in the format projects/*/locations/*.

opts Options

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

Returns
TypeDescription
StreamRange< google::cloud::certificatemanager::v1::CertificateMap >

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.certificatemanager.v1.CertificateMap, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListCertificateMaps(google::cloud::certificatemanager::v1::ListCertificateMapsRequest, Options)

Lists CertificateMaps in a given project and location.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::ListCertificateMapsRequest

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.certificatemanager.v1.ListCertificateMapsRequest. 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
TypeDescription
StreamRange< google::cloud::certificatemanager::v1::CertificateMap >

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.certificatemanager.v1.CertificateMap, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetCertificateMap(std::string const &, Options)

Gets details of a single CertificateMap.

Parameters
NameDescription
name std::string const &

Required. A name of the certificate map to describe. Must be in the format projects/*/locations/*/certificateMaps/*.

opts Options

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

Returns
TypeDescription
StatusOr< google::cloud::certificatemanager::v1::CertificateMap >

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

GetCertificateMap(google::cloud::certificatemanager::v1::GetCertificateMapRequest const &, Options)

Gets details of a single CertificateMap.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::GetCertificateMapRequest 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.certificatemanager.v1.GetCertificateMapRequest. 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
TypeDescription
StatusOr< google::cloud::certificatemanager::v1::CertificateMap >

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

CreateCertificateMap(std::string const &, google::cloud::certificatemanager::v1::CertificateMap const &, std::string const &, Options)

Creates a new CertificateMap in a given project and location.

Parameters
NameDescription
parent std::string const &

Required. The parent resource of the certificate map. Must be in the format projects/*/locations/*.

certificate_map google::cloud::certificatemanager::v1::CertificateMap const &

Required. A definition of the certificate map to create.

certificate_map_id std::string const &

Required. A user-provided name of the certificate map.

opts Options

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

Returns
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::CertificateMap > >

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.certificatemanager.v1.CertificateMap proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateCertificateMap(google::cloud::certificatemanager::v1::CreateCertificateMapRequest const &, Options)

Creates a new CertificateMap in a given project and location.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::CreateCertificateMapRequest 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.certificatemanager.v1.CreateCertificateMapRequest. 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
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::CertificateMap > >

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.certificatemanager.v1.CertificateMap proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateCertificateMap(google::cloud::certificatemanager::v1::CertificateMap const &, google::protobuf::FieldMask const &, Options)

Updates a CertificateMap.

Parameters
NameDescription
certificate_map google::cloud::certificatemanager::v1::CertificateMap const &

Required. A definition of the certificate map to update.

update_mask google::protobuf::FieldMask const &

Required. The update mask applies to the resource. For the FieldMask definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask.

opts Options

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

Returns
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::CertificateMap > >

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.certificatemanager.v1.CertificateMap proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateCertificateMap(google::cloud::certificatemanager::v1::UpdateCertificateMapRequest const &, Options)

Updates a CertificateMap.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::UpdateCertificateMapRequest 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.certificatemanager.v1.UpdateCertificateMapRequest. 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
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::CertificateMap > >

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.certificatemanager.v1.CertificateMap proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteCertificateMap(std::string const &, Options)

Deletes a single CertificateMap.

A Certificate Map can't be deleted if it contains Certificate Map Entries. Remove all the entries from the map before calling this method.

Parameters
NameDescription
name std::string const &

Required. A name of the certificate map to delete. Must be in the format projects/*/locations/*/certificateMaps/*.

opts Options

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

Returns
TypeDescription
future< StatusOr< google::cloud::certificatemanager::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.certificatemanager.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteCertificateMap(google::cloud::certificatemanager::v1::DeleteCertificateMapRequest const &, Options)

Deletes a single CertificateMap.

A Certificate Map can't be deleted if it contains Certificate Map Entries. Remove all the entries from the map before calling this method.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::DeleteCertificateMapRequest 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.certificatemanager.v1.DeleteCertificateMapRequest. 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
TypeDescription
future< StatusOr< google::cloud::certificatemanager::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.certificatemanager.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

ListCertificateMapEntries(std::string const &, Options)

Lists CertificateMapEntries in a given project and location.

Parameters
NameDescription
parent std::string const &

Required. The project, location and certificate map from which the certificate map entries should be listed, specified in the format projects/*/locations/*/certificateMaps/*.

opts Options

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

Returns
TypeDescription
StreamRange< google::cloud::certificatemanager::v1::CertificateMapEntry >

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.certificatemanager.v1.CertificateMapEntry, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListCertificateMapEntries(google::cloud::certificatemanager::v1::ListCertificateMapEntriesRequest, Options)

Lists CertificateMapEntries in a given project and location.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::ListCertificateMapEntriesRequest

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.certificatemanager.v1.ListCertificateMapEntriesRequest. 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
TypeDescription
StreamRange< google::cloud::certificatemanager::v1::CertificateMapEntry >

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.certificatemanager.v1.CertificateMapEntry, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetCertificateMapEntry(std::string const &, Options)

Gets details of a single CertificateMapEntry.

Parameters
NameDescription
name std::string const &

Required. A name of the certificate map entry to describe. Must be in the format projects/*/locations/*/certificateMaps/*/certificateMapEntries/*.

opts Options

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

Returns
TypeDescription
StatusOr< google::cloud::certificatemanager::v1::CertificateMapEntry >

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

GetCertificateMapEntry(google::cloud::certificatemanager::v1::GetCertificateMapEntryRequest const &, Options)

Gets details of a single CertificateMapEntry.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::GetCertificateMapEntryRequest 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.certificatemanager.v1.GetCertificateMapEntryRequest. 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
TypeDescription
StatusOr< google::cloud::certificatemanager::v1::CertificateMapEntry >

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

CreateCertificateMapEntry(std::string const &, google::cloud::certificatemanager::v1::CertificateMapEntry const &, std::string const &, Options)

Creates a new CertificateMapEntry in a given project and location.

Parameters
NameDescription
parent std::string const &

Required. The parent resource of the certificate map entry. Must be in the format projects/*/locations/*/certificateMaps/*.

certificate_map_entry google::cloud::certificatemanager::v1::CertificateMapEntry const &

Required. A definition of the certificate map entry to create.

certificate_map_entry_id std::string const &

Required. A user-provided name of the certificate map entry.

opts Options

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

Returns
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::CertificateMapEntry > >

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.certificatemanager.v1.CertificateMapEntry proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateCertificateMapEntry(google::cloud::certificatemanager::v1::CreateCertificateMapEntryRequest const &, Options)

Creates a new CertificateMapEntry in a given project and location.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::CreateCertificateMapEntryRequest 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.certificatemanager.v1.CreateCertificateMapEntryRequest. 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
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::CertificateMapEntry > >

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.certificatemanager.v1.CertificateMapEntry proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateCertificateMapEntry(google::cloud::certificatemanager::v1::CertificateMapEntry const &, google::protobuf::FieldMask const &, Options)

Updates a CertificateMapEntry.

Parameters
NameDescription
certificate_map_entry google::cloud::certificatemanager::v1::CertificateMapEntry const &

Required. A definition of the certificate map entry to create map entry.

update_mask google::protobuf::FieldMask const &

Required. The update mask applies to the resource. For the FieldMask definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask.

opts Options

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

Returns
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::CertificateMapEntry > >

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.certificatemanager.v1.CertificateMapEntry proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateCertificateMapEntry(google::cloud::certificatemanager::v1::UpdateCertificateMapEntryRequest const &, Options)

Updates a CertificateMapEntry.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::UpdateCertificateMapEntryRequest 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.certificatemanager.v1.UpdateCertificateMapEntryRequest. 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
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::CertificateMapEntry > >

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.certificatemanager.v1.CertificateMapEntry proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteCertificateMapEntry(std::string const &, Options)

Deletes a single CertificateMapEntry.

Parameters
NameDescription
name std::string const &

Required. A name of the certificate map entry to delete. Must be in the format projects/*/locations/*/certificateMaps/*/certificateMapEntries/*.

opts Options

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

Returns
TypeDescription
future< StatusOr< google::cloud::certificatemanager::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.certificatemanager.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteCertificateMapEntry(google::cloud::certificatemanager::v1::DeleteCertificateMapEntryRequest const &, Options)

Deletes a single CertificateMapEntry.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::DeleteCertificateMapEntryRequest 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.certificatemanager.v1.DeleteCertificateMapEntryRequest. 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
TypeDescription
future< StatusOr< google::cloud::certificatemanager::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.certificatemanager.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

ListDnsAuthorizations(std::string const &, Options)

Lists DnsAuthorizations in a given project and location.

Parameters
NameDescription
parent std::string const &

Required. The project and location from which the dns authorizations should be listed, specified in the format projects/*/locations/*.

opts Options

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

Returns
TypeDescription
StreamRange< google::cloud::certificatemanager::v1::DnsAuthorization >

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.certificatemanager.v1.DnsAuthorization, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListDnsAuthorizations(google::cloud::certificatemanager::v1::ListDnsAuthorizationsRequest, Options)

Lists DnsAuthorizations in a given project and location.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::ListDnsAuthorizationsRequest

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.certificatemanager.v1.ListDnsAuthorizationsRequest. 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
TypeDescription
StreamRange< google::cloud::certificatemanager::v1::DnsAuthorization >

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.certificatemanager.v1.DnsAuthorization, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetDnsAuthorization(std::string const &, Options)

Gets details of a single DnsAuthorization.

Parameters
NameDescription
name std::string const &

Required. A name of the dns authorization to describe. Must be in the format projects/*/locations/*/dnsAuthorizations/*.

opts Options

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

Returns
TypeDescription
StatusOr< google::cloud::certificatemanager::v1::DnsAuthorization >

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

GetDnsAuthorization(google::cloud::certificatemanager::v1::GetDnsAuthorizationRequest const &, Options)

Gets details of a single DnsAuthorization.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::GetDnsAuthorizationRequest 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.certificatemanager.v1.GetDnsAuthorizationRequest. 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
TypeDescription
StatusOr< google::cloud::certificatemanager::v1::DnsAuthorization >

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

CreateDnsAuthorization(std::string const &, google::cloud::certificatemanager::v1::DnsAuthorization const &, std::string const &, Options)

Creates a new DnsAuthorization in a given project and location.

Parameters
NameDescription
parent std::string const &

Required. The parent resource of the dns authorization. Must be in the format projects/*/locations/*.

dns_authorization google::cloud::certificatemanager::v1::DnsAuthorization const &

Required. A definition of the dns authorization to create.

dns_authorization_id std::string const &

Required. A user-provided name of the dns authorization.

opts Options

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

Returns
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::DnsAuthorization > >

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.certificatemanager.v1.DnsAuthorization proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateDnsAuthorization(google::cloud::certificatemanager::v1::CreateDnsAuthorizationRequest const &, Options)

Creates a new DnsAuthorization in a given project and location.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::CreateDnsAuthorizationRequest 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.certificatemanager.v1.CreateDnsAuthorizationRequest. 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
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::DnsAuthorization > >

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.certificatemanager.v1.DnsAuthorization proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateDnsAuthorization(google::cloud::certificatemanager::v1::DnsAuthorization const &, google::protobuf::FieldMask const &, Options)

Updates a DnsAuthorization.

Parameters
NameDescription
dns_authorization google::cloud::certificatemanager::v1::DnsAuthorization const &

Required. A definition of the dns authorization to update.

update_mask google::protobuf::FieldMask const &

Required. The update mask applies to the resource. For the FieldMask definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask.

opts Options

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

Returns
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::DnsAuthorization > >

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.certificatemanager.v1.DnsAuthorization proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateDnsAuthorization(google::cloud::certificatemanager::v1::UpdateDnsAuthorizationRequest const &, Options)

Updates a DnsAuthorization.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::UpdateDnsAuthorizationRequest 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.certificatemanager.v1.UpdateDnsAuthorizationRequest. 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
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::DnsAuthorization > >

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.certificatemanager.v1.DnsAuthorization proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteDnsAuthorization(std::string const &, Options)

Deletes a single DnsAuthorization.

Parameters
NameDescription
name std::string const &

Required. A name of the dns authorization to delete. Must be in the format projects/*/locations/*/dnsAuthorizations/*.

opts Options

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

Returns
TypeDescription
future< StatusOr< google::cloud::certificatemanager::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.certificatemanager.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteDnsAuthorization(google::cloud::certificatemanager::v1::DeleteDnsAuthorizationRequest const &, Options)

Deletes a single DnsAuthorization.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::DeleteDnsAuthorizationRequest 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.certificatemanager.v1.DeleteDnsAuthorizationRequest. 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
TypeDescription
future< StatusOr< google::cloud::certificatemanager::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.certificatemanager.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

ListCertificateIssuanceConfigs(std::string const &, Options)

Lists CertificateIssuanceConfigs in a given project and location.

Parameters
NameDescription
parent std::string const &

Required. The project and location from which the certificate should be listed, specified in the format projects/*/locations/*.

opts Options

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

Returns
TypeDescription
StreamRange< google::cloud::certificatemanager::v1::CertificateIssuanceConfig >

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.certificatemanager.v1.CertificateIssuanceConfig, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListCertificateIssuanceConfigs(google::cloud::certificatemanager::v1::ListCertificateIssuanceConfigsRequest, Options)

Lists CertificateIssuanceConfigs in a given project and location.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::ListCertificateIssuanceConfigsRequest

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.certificatemanager.v1.ListCertificateIssuanceConfigsRequest. 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
TypeDescription
StreamRange< google::cloud::certificatemanager::v1::CertificateIssuanceConfig >

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.certificatemanager.v1.CertificateIssuanceConfig, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetCertificateIssuanceConfig(std::string const &, Options)

Gets details of a single CertificateIssuanceConfig.

Parameters
NameDescription
name std::string const &

Required. A name of the certificate issuance config to describe. Must be in the format projects/*/locations/*/certificateIssuanceConfigs/*.

opts Options

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

Returns
TypeDescription
StatusOr< google::cloud::certificatemanager::v1::CertificateIssuanceConfig >

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

GetCertificateIssuanceConfig(google::cloud::certificatemanager::v1::GetCertificateIssuanceConfigRequest const &, Options)

Gets details of a single CertificateIssuanceConfig.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::GetCertificateIssuanceConfigRequest 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.certificatemanager.v1.GetCertificateIssuanceConfigRequest. 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
TypeDescription
StatusOr< google::cloud::certificatemanager::v1::CertificateIssuanceConfig >

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

CreateCertificateIssuanceConfig(std::string const &, google::cloud::certificatemanager::v1::CertificateIssuanceConfig const &, std::string const &, Options)

Creates a new CertificateIssuanceConfig in a given project and location.

Parameters
NameDescription
parent std::string const &

Required. The parent resource of the certificate issuance config. Must be in the format projects/*/locations/*.

certificate_issuance_config google::cloud::certificatemanager::v1::CertificateIssuanceConfig const &

Required. A definition of the certificate issuance config to create.

certificate_issuance_config_id std::string const &

Required. A user-provided name of the certificate config.

opts Options

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

Returns
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::CertificateIssuanceConfig > >

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.certificatemanager.v1.CertificateIssuanceConfig proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateCertificateIssuanceConfig(google::cloud::certificatemanager::v1::CreateCertificateIssuanceConfigRequest const &, Options)

Creates a new CertificateIssuanceConfig in a given project and location.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::CreateCertificateIssuanceConfigRequest 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.certificatemanager.v1.CreateCertificateIssuanceConfigRequest. 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
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::CertificateIssuanceConfig > >

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.certificatemanager.v1.CertificateIssuanceConfig proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteCertificateIssuanceConfig(std::string const &, Options)

Deletes a single CertificateIssuanceConfig.

Parameters
NameDescription
name std::string const &

Required. A name of the certificate issuance config to delete. Must be in the format projects/*/locations/*/certificateIssuanceConfigs/*.

opts Options

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

Returns
TypeDescription
future< StatusOr< google::cloud::certificatemanager::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.certificatemanager.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteCertificateIssuanceConfig(google::cloud::certificatemanager::v1::DeleteCertificateIssuanceConfigRequest const &, Options)

Deletes a single CertificateIssuanceConfig.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::DeleteCertificateIssuanceConfigRequest 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.certificatemanager.v1.DeleteCertificateIssuanceConfigRequest. 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
TypeDescription
future< StatusOr< google::cloud::certificatemanager::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.certificatemanager.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

ListTrustConfigs(std::string const &, Options)

Lists TrustConfigs in a given project and location.

Parameters
NameDescription
parent std::string const &

Required. The project and location from which the TrustConfigs should be listed, specified in the format projects/*/locations/*.

opts Options

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

Returns
TypeDescription
StreamRange< google::cloud::certificatemanager::v1::TrustConfig >

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.certificatemanager.v1.TrustConfig, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListTrustConfigs(google::cloud::certificatemanager::v1::ListTrustConfigsRequest, Options)

Lists TrustConfigs in a given project and location.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::ListTrustConfigsRequest

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.certificatemanager.v1.ListTrustConfigsRequest. 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
TypeDescription
StreamRange< google::cloud::certificatemanager::v1::TrustConfig >

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.certificatemanager.v1.TrustConfig, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetTrustConfig(std::string const &, Options)

Gets details of a single TrustConfig.

Parameters
NameDescription
name std::string const &

Required. A name of the TrustConfig to describe. Must be in the format projects/*/locations/*/trustConfigs/*.

opts Options

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

Returns
TypeDescription
StatusOr< google::cloud::certificatemanager::v1::TrustConfig >

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

GetTrustConfig(google::cloud::certificatemanager::v1::GetTrustConfigRequest const &, Options)

Gets details of a single TrustConfig.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::GetTrustConfigRequest 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.certificatemanager.v1.GetTrustConfigRequest. 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
TypeDescription
StatusOr< google::cloud::certificatemanager::v1::TrustConfig >

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

CreateTrustConfig(std::string const &, google::cloud::certificatemanager::v1::TrustConfig const &, std::string const &, Options)

Creates a new TrustConfig in a given project and location.

Parameters
NameDescription
parent std::string const &

Required. The parent resource of the TrustConfig. Must be in the format projects/*/locations/*.

trust_config google::cloud::certificatemanager::v1::TrustConfig const &

Required. A definition of the TrustConfig to create.

trust_config_id std::string const &

Required. A user-provided name of the TrustConfig. Must match the regexp [a-z0-9-]{1,63}.

opts Options

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

Returns
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::TrustConfig > >

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.certificatemanager.v1.TrustConfig proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateTrustConfig(google::cloud::certificatemanager::v1::CreateTrustConfigRequest const &, Options)

Creates a new TrustConfig in a given project and location.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::CreateTrustConfigRequest 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.certificatemanager.v1.CreateTrustConfigRequest. 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
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::TrustConfig > >

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.certificatemanager.v1.TrustConfig proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateTrustConfig(google::cloud::certificatemanager::v1::TrustConfig const &, google::protobuf::FieldMask const &, Options)

Updates a TrustConfig.

Parameters
NameDescription
trust_config google::cloud::certificatemanager::v1::TrustConfig const &

Required. A definition of the TrustConfig to update.

update_mask google::protobuf::FieldMask const &

Required. The update mask applies to the resource. For the FieldMask definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask.

opts Options

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

Returns
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::TrustConfig > >

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.certificatemanager.v1.TrustConfig proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateTrustConfig(google::cloud::certificatemanager::v1::UpdateTrustConfigRequest const &, Options)

Updates a TrustConfig.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::UpdateTrustConfigRequest 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.certificatemanager.v1.UpdateTrustConfigRequest. 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
TypeDescription
future< StatusOr< google::cloud::certificatemanager::v1::TrustConfig > >

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.certificatemanager.v1.TrustConfig proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteTrustConfig(std::string const &, Options)

Deletes a single TrustConfig.

Parameters
NameDescription
name std::string const &

Required. A name of the TrustConfig to delete. Must be in the format projects/*/locations/*/trustConfigs/*.

opts Options

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

Returns
TypeDescription
future< StatusOr< google::cloud::certificatemanager::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.certificatemanager.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteTrustConfig(google::cloud::certificatemanager::v1::DeleteTrustConfigRequest const &, Options)

Deletes a single TrustConfig.

Parameters
NameDescription
request google::cloud::certificatemanager::v1::DeleteTrustConfigRequest 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.certificatemanager.v1.DeleteTrustConfigRequest. 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
TypeDescription
future< StatusOr< google::cloud::certificatemanager::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.certificatemanager.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.