Reference documentation and code samples for the Certificate Manager V1 API class Google::Cloud::CertificateManager::V1::CertificateManager::Client.
Client for the CertificateManager service.
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
which describes a single TLS certificate.CertificateMap
which describes a collection of certificates that can be attached to a target resource.CertificateMapEntry
which 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 match "^[a-z0-9-]{1,63}$" regexp, which means that
- 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.
Inherits
- Object
Methods
.configure
def self.configure() { |config| ... } -> Client::Configuration
Configure the CertificateManager Client class.
See Configuration for a description of the configuration fields.
- (config) — Configure the Client client.
- config (Client::Configuration)
# Modify the configuration for all CertificateManager clients ::Google::Cloud::CertificateManager::V1::CertificateManager::Client.configure do |config| config.timeout = 10.0 end
#configure
def configure() { |config| ... } -> Client::Configuration
Configure the CertificateManager Client instance.
The configuration is set to the derived mode, meaning that values can be changed, but structural changes (adding new fields, etc.) are not allowed. Structural changes should be made on Client.configure.
See Configuration for a description of the configuration fields.
- (config) — Configure the Client client.
- config (Client::Configuration)
#create_certificate
def create_certificate(request, options = nil) -> ::Gapic::Operation
def create_certificate(parent: nil, certificate_id: nil, certificate: nil) -> ::Gapic::Operation
Creates a new Certificate in a given project and location.
def create_certificate(request, options = nil) -> ::Gapic::Operation
create_certificate
via a request object, either of type
Google::Cloud::CertificateManager::V1::CreateCertificateRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::CreateCertificateRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def create_certificate(parent: nil, certificate_id: nil, certificate: nil) -> ::Gapic::Operation
create_certificate
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
-
parent (::String) — Required. The parent resource of the certificate. Must be in the format
projects/*/locations/*
. - certificate_id (::String) — Required. A user-provided name of the certificate.
- certificate (::Google::Cloud::CertificateManager::V1::Certificate, ::Hash) — Required. A definition of the certificate to create.
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::Operation)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::CreateCertificateRequest.new # Call the create_certificate method. result = client.create_certificate request # The returned object is of type Gapic::Operation. You can use this # object to check the status of an operation, cancel it, or wait # for results. Here is how to block until completion: result.wait_until_done! timeout: 60 if result.response? p result.response else puts "Error!" end
#create_certificate_map
def create_certificate_map(request, options = nil) -> ::Gapic::Operation
def create_certificate_map(parent: nil, certificate_map_id: nil, certificate_map: nil) -> ::Gapic::Operation
Creates a new CertificateMap in a given project and location.
def create_certificate_map(request, options = nil) -> ::Gapic::Operation
create_certificate_map
via a request object, either of type
Google::Cloud::CertificateManager::V1::CreateCertificateMapRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::CreateCertificateMapRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def create_certificate_map(parent: nil, certificate_map_id: nil, certificate_map: nil) -> ::Gapic::Operation
create_certificate_map
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
-
parent (::String) — Required. The parent resource of the certificate map. Must be in the format
projects/*/locations/*
. - certificate_map_id (::String) — Required. A user-provided name of the certificate map.
- certificate_map (::Google::Cloud::CertificateManager::V1::CertificateMap, ::Hash) — Required. A definition of the certificate map to create.
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::Operation)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::CreateCertificateMapRequest.new # Call the create_certificate_map method. result = client.create_certificate_map request # The returned object is of type Gapic::Operation. You can use this # object to check the status of an operation, cancel it, or wait # for results. Here is how to block until completion: result.wait_until_done! timeout: 60 if result.response? p result.response else puts "Error!" end
#create_certificate_map_entry
def create_certificate_map_entry(request, options = nil) -> ::Gapic::Operation
def create_certificate_map_entry(parent: nil, certificate_map_entry_id: nil, certificate_map_entry: nil) -> ::Gapic::Operation
Creates a new CertificateMapEntry in a given project and location.
def create_certificate_map_entry(request, options = nil) -> ::Gapic::Operation
create_certificate_map_entry
via a request object, either of type
Google::Cloud::CertificateManager::V1::CreateCertificateMapEntryRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::CreateCertificateMapEntryRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def create_certificate_map_entry(parent: nil, certificate_map_entry_id: nil, certificate_map_entry: nil) -> ::Gapic::Operation
create_certificate_map_entry
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
-
parent (::String) — Required. The parent resource of the certificate map entry. Must be in the
format
projects/*/locations/*/certificateMaps/*
. - certificate_map_entry_id (::String) — Required. A user-provided name of the certificate map entry.
- certificate_map_entry (::Google::Cloud::CertificateManager::V1::CertificateMapEntry, ::Hash) — Required. A definition of the certificate map entry to create.
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::Operation)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::CreateCertificateMapEntryRequest.new # Call the create_certificate_map_entry method. result = client.create_certificate_map_entry request # The returned object is of type Gapic::Operation. You can use this # object to check the status of an operation, cancel it, or wait # for results. Here is how to block until completion: result.wait_until_done! timeout: 60 if result.response? p result.response else puts "Error!" end
#create_dns_authorization
def create_dns_authorization(request, options = nil) -> ::Gapic::Operation
def create_dns_authorization(parent: nil, dns_authorization_id: nil, dns_authorization: nil) -> ::Gapic::Operation
Creates a new DnsAuthorization in a given project and location.
def create_dns_authorization(request, options = nil) -> ::Gapic::Operation
create_dns_authorization
via a request object, either of type
Google::Cloud::CertificateManager::V1::CreateDnsAuthorizationRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::CreateDnsAuthorizationRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def create_dns_authorization(parent: nil, dns_authorization_id: nil, dns_authorization: nil) -> ::Gapic::Operation
create_dns_authorization
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
-
parent (::String) — Required. The parent resource of the dns authorization. Must be in the format
projects/*/locations/*
. - dns_authorization_id (::String) — Required. A user-provided name of the dns authorization.
- dns_authorization (::Google::Cloud::CertificateManager::V1::DnsAuthorization, ::Hash) — Required. A definition of the dns authorization to create.
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::Operation)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::CreateDnsAuthorizationRequest.new # Call the create_dns_authorization method. result = client.create_dns_authorization request # The returned object is of type Gapic::Operation. You can use this # object to check the status of an operation, cancel it, or wait # for results. Here is how to block until completion: result.wait_until_done! timeout: 60 if result.response? p result.response else puts "Error!" end
#delete_certificate
def delete_certificate(request, options = nil) -> ::Gapic::Operation
def delete_certificate(name: nil) -> ::Gapic::Operation
Deletes a single Certificate.
def delete_certificate(request, options = nil) -> ::Gapic::Operation
delete_certificate
via a request object, either of type
DeleteCertificateRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::DeleteCertificateRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def delete_certificate(name: nil) -> ::Gapic::Operation
delete_certificate
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
-
name (::String) — Required. A name of the certificate to delete. Must be in the format
projects/*/locations/*/certificates/*
.
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::Operation)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::DeleteCertificateRequest.new # Call the delete_certificate method. result = client.delete_certificate request # The returned object is of type Gapic::Operation. You can use this # object to check the status of an operation, cancel it, or wait # for results. Here is how to block until completion: result.wait_until_done! timeout: 60 if result.response? p result.response else puts "Error!" end
#delete_certificate_map
def delete_certificate_map(request, options = nil) -> ::Gapic::Operation
def delete_certificate_map(name: nil) -> ::Gapic::Operation
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.
def delete_certificate_map(request, options = nil) -> ::Gapic::Operation
delete_certificate_map
via a request object, either of type
DeleteCertificateMapRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::DeleteCertificateMapRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def delete_certificate_map(name: nil) -> ::Gapic::Operation
delete_certificate_map
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
-
name (::String) — Required. A name of the certificate map to delete. Must be in the format
projects/*/locations/*/certificateMaps/*
.
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::Operation)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::DeleteCertificateMapRequest.new # Call the delete_certificate_map method. result = client.delete_certificate_map request # The returned object is of type Gapic::Operation. You can use this # object to check the status of an operation, cancel it, or wait # for results. Here is how to block until completion: result.wait_until_done! timeout: 60 if result.response? p result.response else puts "Error!" end
#delete_certificate_map_entry
def delete_certificate_map_entry(request, options = nil) -> ::Gapic::Operation
def delete_certificate_map_entry(name: nil) -> ::Gapic::Operation
Deletes a single CertificateMapEntry.
def delete_certificate_map_entry(request, options = nil) -> ::Gapic::Operation
delete_certificate_map_entry
via a request object, either of type
DeleteCertificateMapEntryRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::DeleteCertificateMapEntryRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def delete_certificate_map_entry(name: nil) -> ::Gapic::Operation
delete_certificate_map_entry
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
-
name (::String) — Required. A name of the certificate map entry to delete. Must be in the format
projects/*/locations/*/certificateMaps/*/certificateMapEntries/*
.
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::Operation)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::DeleteCertificateMapEntryRequest.new # Call the delete_certificate_map_entry method. result = client.delete_certificate_map_entry request # The returned object is of type Gapic::Operation. You can use this # object to check the status of an operation, cancel it, or wait # for results. Here is how to block until completion: result.wait_until_done! timeout: 60 if result.response? p result.response else puts "Error!" end
#delete_dns_authorization
def delete_dns_authorization(request, options = nil) -> ::Gapic::Operation
def delete_dns_authorization(name: nil) -> ::Gapic::Operation
Deletes a single DnsAuthorization.
def delete_dns_authorization(request, options = nil) -> ::Gapic::Operation
delete_dns_authorization
via a request object, either of type
DeleteDnsAuthorizationRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::DeleteDnsAuthorizationRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def delete_dns_authorization(name: nil) -> ::Gapic::Operation
delete_dns_authorization
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
-
name (::String) — Required. A name of the dns authorization to delete. Must be in the format
projects/*/locations/*/dnsAuthorizations/*
.
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::Operation)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::DeleteDnsAuthorizationRequest.new # Call the delete_dns_authorization method. result = client.delete_dns_authorization request # The returned object is of type Gapic::Operation. You can use this # object to check the status of an operation, cancel it, or wait # for results. Here is how to block until completion: result.wait_until_done! timeout: 60 if result.response? p result.response else puts "Error!" end
#get_certificate
def get_certificate(request, options = nil) -> ::Google::Cloud::CertificateManager::V1::Certificate
def get_certificate(name: nil) -> ::Google::Cloud::CertificateManager::V1::Certificate
Gets details of a single Certificate.
def get_certificate(request, options = nil) -> ::Google::Cloud::CertificateManager::V1::Certificate
get_certificate
via a request object, either of type
GetCertificateRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::GetCertificateRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def get_certificate(name: nil) -> ::Google::Cloud::CertificateManager::V1::Certificate
get_certificate
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
-
name (::String) — Required. A name of the certificate to describe. Must be in the format
projects/*/locations/*/certificates/*
.
- (response, operation) — Access the result along with the RPC operation
- response (::Google::Cloud::CertificateManager::V1::Certificate)
- operation (::GRPC::ActiveCall::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::GetCertificateRequest.new # Call the get_certificate method. result = client.get_certificate request # The returned object is of type Google::Cloud::CertificateManager::V1::Certificate. p result
#get_certificate_map
def get_certificate_map(request, options = nil) -> ::Google::Cloud::CertificateManager::V1::CertificateMap
def get_certificate_map(name: nil) -> ::Google::Cloud::CertificateManager::V1::CertificateMap
Gets details of a single CertificateMap.
def get_certificate_map(request, options = nil) -> ::Google::Cloud::CertificateManager::V1::CertificateMap
get_certificate_map
via a request object, either of type
GetCertificateMapRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::GetCertificateMapRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def get_certificate_map(name: nil) -> ::Google::Cloud::CertificateManager::V1::CertificateMap
get_certificate_map
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
-
name (::String) — Required. A name of the certificate map to describe. Must be in the format
projects/*/locations/*/certificateMaps/*
.
- (response, operation) — Access the result along with the RPC operation
- response (::Google::Cloud::CertificateManager::V1::CertificateMap)
- operation (::GRPC::ActiveCall::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::GetCertificateMapRequest.new # Call the get_certificate_map method. result = client.get_certificate_map request # The returned object is of type Google::Cloud::CertificateManager::V1::CertificateMap. p result
#get_certificate_map_entry
def get_certificate_map_entry(request, options = nil) -> ::Google::Cloud::CertificateManager::V1::CertificateMapEntry
def get_certificate_map_entry(name: nil) -> ::Google::Cloud::CertificateManager::V1::CertificateMapEntry
Gets details of a single CertificateMapEntry.
def get_certificate_map_entry(request, options = nil) -> ::Google::Cloud::CertificateManager::V1::CertificateMapEntry
get_certificate_map_entry
via a request object, either of type
GetCertificateMapEntryRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::GetCertificateMapEntryRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def get_certificate_map_entry(name: nil) -> ::Google::Cloud::CertificateManager::V1::CertificateMapEntry
get_certificate_map_entry
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
-
name (::String) — Required. A name of the certificate map entry to describe. Must be in the
format
projects/*/locations/*/certificateMaps/*/certificateMapEntries/*
.
- (response, operation) — Access the result along with the RPC operation
- response (::Google::Cloud::CertificateManager::V1::CertificateMapEntry)
- operation (::GRPC::ActiveCall::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::GetCertificateMapEntryRequest.new # Call the get_certificate_map_entry method. result = client.get_certificate_map_entry request # The returned object is of type Google::Cloud::CertificateManager::V1::CertificateMapEntry. p result
#get_dns_authorization
def get_dns_authorization(request, options = nil) -> ::Google::Cloud::CertificateManager::V1::DnsAuthorization
def get_dns_authorization(name: nil) -> ::Google::Cloud::CertificateManager::V1::DnsAuthorization
Gets details of a single DnsAuthorization.
def get_dns_authorization(request, options = nil) -> ::Google::Cloud::CertificateManager::V1::DnsAuthorization
get_dns_authorization
via a request object, either of type
GetDnsAuthorizationRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::GetDnsAuthorizationRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def get_dns_authorization(name: nil) -> ::Google::Cloud::CertificateManager::V1::DnsAuthorization
get_dns_authorization
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
-
name (::String) — Required. A name of the dns authorization to describe. Must be in the format
projects/*/locations/*/dnsAuthorizations/*
.
- (response, operation) — Access the result along with the RPC operation
- response (::Google::Cloud::CertificateManager::V1::DnsAuthorization)
- operation (::GRPC::ActiveCall::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::GetDnsAuthorizationRequest.new # Call the get_dns_authorization method. result = client.get_dns_authorization request # The returned object is of type Google::Cloud::CertificateManager::V1::DnsAuthorization. p result
#initialize
def initialize() { |config| ... } -> Client
Create a new CertificateManager client object.
- (config) — Configure the CertificateManager client.
- config (Client::Configuration)
- (Client) — a new instance of Client
# Create a client using the default configuration client = ::Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a client using a custom configuration client = ::Google::Cloud::CertificateManager::V1::CertificateManager::Client.new do |config| config.timeout = 10.0 end
#list_certificate_map_entries
def list_certificate_map_entries(request, options = nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::CertificateMapEntry>
def list_certificate_map_entries(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::CertificateMapEntry>
Lists CertificateMapEntries in a given project and location.
def list_certificate_map_entries(request, options = nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::CertificateMapEntry>
list_certificate_map_entries
via a request object, either of type
ListCertificateMapEntriesRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::ListCertificateMapEntriesRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def list_certificate_map_entries(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::CertificateMapEntry>
list_certificate_map_entries
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
-
parent (::String) — Required. The project, location and certificate map from which the certificate map
entries should be listed, specified in the format
projects/*/locations/*/certificateMaps/*
. - page_size (::Integer) — Maximum number of certificate map entries to return. The service may return fewer than this value. If unspecified, at most 50 certificate map entries will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
-
page_token (::String) — The value returned by the last
ListCertificateMapEntriesResponse
. Indicates that this is a continuation of a priorListCertificateMapEntries
call, and that the system should return the next page of data. - filter (::String) — Filter expression to restrict the returned Certificate Map Entries.
- order_by (::String) — A list of Certificate Map Entry field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix " desc".
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::CertificateMapEntry>)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::CertificateMapEntry>)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::ListCertificateMapEntriesRequest.new # Call the list_certificate_map_entries method. result = client.list_certificate_map_entries request # The returned object is of type Gapic::PagedEnumerable. You can # iterate over all elements by calling #each, and the enumerable # will lazily make API calls to fetch subsequent pages. Other # methods are also available for managing paging directly. result.each do |response| # Each element is of type ::Google::Cloud::CertificateManager::V1::CertificateMapEntry. p response end
#list_certificate_maps
def list_certificate_maps(request, options = nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::CertificateMap>
def list_certificate_maps(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::CertificateMap>
Lists CertificateMaps in a given project and location.
def list_certificate_maps(request, options = nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::CertificateMap>
list_certificate_maps
via a request object, either of type
ListCertificateMapsRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::ListCertificateMapsRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def list_certificate_maps(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::CertificateMap>
list_certificate_maps
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
-
parent (::String) — Required. The project and location from which the certificate maps should be listed,
specified in the format
projects/*/locations/*
. - page_size (::Integer) — Maximum number of certificate maps to return per call.
-
page_token (::String) — The value returned by the last
ListCertificateMapsResponse
. Indicates that this is a continuation of a priorListCertificateMaps
call, and that the system should return the next page of data. - filter (::String) — Filter expression to restrict the Certificates Maps returned.
- order_by (::String) — A list of Certificate Map field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix " desc".
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::CertificateMap>)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::CertificateMap>)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::ListCertificateMapsRequest.new # Call the list_certificate_maps method. result = client.list_certificate_maps request # The returned object is of type Gapic::PagedEnumerable. You can # iterate over all elements by calling #each, and the enumerable # will lazily make API calls to fetch subsequent pages. Other # methods are also available for managing paging directly. result.each do |response| # Each element is of type ::Google::Cloud::CertificateManager::V1::CertificateMap. p response end
#list_certificates
def list_certificates(request, options = nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::Certificate>
def list_certificates(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::Certificate>
Lists Certificates in a given project and location.
def list_certificates(request, options = nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::Certificate>
list_certificates
via a request object, either of type
ListCertificatesRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::ListCertificatesRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def list_certificates(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::Certificate>
list_certificates
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
-
parent (::String) — Required. The project and location from which the certificate should be listed,
specified in the format
projects/*/locations/*
. - page_size (::Integer) — Maximum number of certificates to return per call.
-
page_token (::String) — The value returned by the last
ListCertificatesResponse
. Indicates that this is a continuation of a priorListCertificates
call, and that the system should return the next page of data. - filter (::String) — Filter expression to restrict the Certificates returned.
- order_by (::String) — A list of Certificate field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix " desc".
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::Certificate>)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::Certificate>)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::ListCertificatesRequest.new # Call the list_certificates method. result = client.list_certificates request # The returned object is of type Gapic::PagedEnumerable. You can # iterate over all elements by calling #each, and the enumerable # will lazily make API calls to fetch subsequent pages. Other # methods are also available for managing paging directly. result.each do |response| # Each element is of type ::Google::Cloud::CertificateManager::V1::Certificate. p response end
#list_dns_authorizations
def list_dns_authorizations(request, options = nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::DnsAuthorization>
def list_dns_authorizations(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::DnsAuthorization>
Lists DnsAuthorizations in a given project and location.
def list_dns_authorizations(request, options = nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::DnsAuthorization>
list_dns_authorizations
via a request object, either of type
ListDnsAuthorizationsRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::ListDnsAuthorizationsRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def list_dns_authorizations(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::DnsAuthorization>
list_dns_authorizations
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
-
parent (::String) — Required. The project and location from which the dns authorizations should be
listed, specified in the format
projects/*/locations/*
. - page_size (::Integer) — Maximum number of dns authorizations to return per call.
-
page_token (::String) — The value returned by the last
ListDnsAuthorizationsResponse
. Indicates that this is a continuation of a priorListDnsAuthorizations
call, and that the system should return the next page of data. - filter (::String) — Filter expression to restrict the Dns Authorizations returned.
- order_by (::String) — A list of Dns Authorization field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix " desc".
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::DnsAuthorization>)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::DnsAuthorization>)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::ListDnsAuthorizationsRequest.new # Call the list_dns_authorizations method. result = client.list_dns_authorizations request # The returned object is of type Gapic::PagedEnumerable. You can # iterate over all elements by calling #each, and the enumerable # will lazily make API calls to fetch subsequent pages. Other # methods are also available for managing paging directly. result.each do |response| # Each element is of type ::Google::Cloud::CertificateManager::V1::DnsAuthorization. p response end
#operations_client
def operations_client() -> ::Google::Cloud::CertificateManager::V1::CertificateManager::Operations
Get the associated client for long-running operations.
#update_certificate
def update_certificate(request, options = nil) -> ::Gapic::Operation
def update_certificate(certificate: nil, update_mask: nil) -> ::Gapic::Operation
Updates a Certificate.
def update_certificate(request, options = nil) -> ::Gapic::Operation
update_certificate
via a request object, either of type
UpdateCertificateRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::UpdateCertificateRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def update_certificate(certificate: nil, update_mask: nil) -> ::Gapic::Operation
update_certificate
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
- certificate (::Google::Cloud::CertificateManager::V1::Certificate, ::Hash) — Required. A definition of the certificate to update.
-
update_mask (::Google::Protobuf::FieldMask, ::Hash) — Required. The update mask applies to the resource. For the
FieldMask
definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask.
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::Operation)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::UpdateCertificateRequest.new # Call the update_certificate method. result = client.update_certificate request # The returned object is of type Gapic::Operation. You can use this # object to check the status of an operation, cancel it, or wait # for results. Here is how to block until completion: result.wait_until_done! timeout: 60 if result.response? p result.response else puts "Error!" end
#update_certificate_map
def update_certificate_map(request, options = nil) -> ::Gapic::Operation
def update_certificate_map(certificate_map: nil, update_mask: nil) -> ::Gapic::Operation
Updates a CertificateMap.
def update_certificate_map(request, options = nil) -> ::Gapic::Operation
update_certificate_map
via a request object, either of type
UpdateCertificateMapRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::UpdateCertificateMapRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def update_certificate_map(certificate_map: nil, update_mask: nil) -> ::Gapic::Operation
update_certificate_map
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
- certificate_map (::Google::Cloud::CertificateManager::V1::CertificateMap, ::Hash) — Required. A definition of the certificate map to update.
-
update_mask (::Google::Protobuf::FieldMask, ::Hash) — Required. The update mask applies to the resource. For the
FieldMask
definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask.
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::Operation)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::UpdateCertificateMapRequest.new # Call the update_certificate_map method. result = client.update_certificate_map request # The returned object is of type Gapic::Operation. You can use this # object to check the status of an operation, cancel it, or wait # for results. Here is how to block until completion: result.wait_until_done! timeout: 60 if result.response? p result.response else puts "Error!" end
#update_certificate_map_entry
def update_certificate_map_entry(request, options = nil) -> ::Gapic::Operation
def update_certificate_map_entry(certificate_map_entry: nil, update_mask: nil) -> ::Gapic::Operation
Updates a CertificateMapEntry.
def update_certificate_map_entry(request, options = nil) -> ::Gapic::Operation
update_certificate_map_entry
via a request object, either of type
UpdateCertificateMapEntryRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::UpdateCertificateMapEntryRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def update_certificate_map_entry(certificate_map_entry: nil, update_mask: nil) -> ::Gapic::Operation
update_certificate_map_entry
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
- certificate_map_entry (::Google::Cloud::CertificateManager::V1::CertificateMapEntry, ::Hash) — Required. A definition of the certificate map entry to create map entry.
-
update_mask (::Google::Protobuf::FieldMask, ::Hash) — Required. The update mask applies to the resource. For the
FieldMask
definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask.
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::Operation)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::UpdateCertificateMapEntryRequest.new # Call the update_certificate_map_entry method. result = client.update_certificate_map_entry request # The returned object is of type Gapic::Operation. You can use this # object to check the status of an operation, cancel it, or wait # for results. Here is how to block until completion: result.wait_until_done! timeout: 60 if result.response? p result.response else puts "Error!" end
#update_dns_authorization
def update_dns_authorization(request, options = nil) -> ::Gapic::Operation
def update_dns_authorization(dns_authorization: nil, update_mask: nil) -> ::Gapic::Operation
Updates a DnsAuthorization.
def update_dns_authorization(request, options = nil) -> ::Gapic::Operation
update_dns_authorization
via a request object, either of type
UpdateDnsAuthorizationRequest or an equivalent Hash.
- request (::Google::Cloud::CertificateManager::V1::UpdateDnsAuthorizationRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
- options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def update_dns_authorization(dns_authorization: nil, update_mask: nil) -> ::Gapic::Operation
update_dns_authorization
via keyword arguments. Note that at
least one keyword argument is required. To specify no parameters, or to keep all
the default parameter values, pass an empty Hash as a request object (see above).
- dns_authorization (::Google::Cloud::CertificateManager::V1::DnsAuthorization, ::Hash) — Required. A definition of the dns authorization to update.
-
update_mask (::Google::Protobuf::FieldMask, ::Hash) — Required. The update mask applies to the resource. For the
FieldMask
definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask.
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::Operation)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/certificate_manager/v1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::CertificateManager::V1::UpdateDnsAuthorizationRequest.new # Call the update_dns_authorization method. result = client.update_dns_authorization request # The returned object is of type Gapic::Operation. You can use this # object to check the status of an operation, cancel it, or wait # for results. Here is how to block until completion: result.wait_until_done! timeout: 60 if result.response? p result.response else puts "Error!" end