Reference documentation and code samples for the Certificate Authority Service V1beta1 API class Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.
Client for the CertificateAuthorityService service.
Certificate Authority Service manages private certificate authorities and issued certificates.
Inherits
- Object
Methods
.configure
def self.configure() { |config| ... } -> Client::Configuration
Configure the CertificateAuthorityService Client class.
See Configuration for a description of the configuration fields.
- (config) — Configure the Client client.
- config (Client::Configuration)
# Modify the configuration for all CertificateAuthorityService clients ::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.configure do |config| config.timeout = 10.0 end
#activate_certificate_authority
def activate_certificate_authority(request, options = nil) -> ::Gapic::Operation
def activate_certificate_authority(name: nil, pem_ca_certificate: nil, subordinate_config: nil, request_id: nil) -> ::Gapic::Operation
Activate a CertificateAuthority that is in state PENDING_ACTIVATION and is of type SUBORDINATE. After the parent Certificate Authority signs a certificate signing request from FetchCertificateAuthorityCsr, this method can complete the activation process.
def activate_certificate_authority(request, options = nil) -> ::Gapic::Operation
activate_certificate_authority
via a request object, either of type
ActivateCertificateAuthorityRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::ActivateCertificateAuthorityRequest, ::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 activate_certificate_authority(name: nil, pem_ca_certificate: nil, subordinate_config: nil, request_id: nil) -> ::Gapic::Operation
activate_certificate_authority
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. The resource name for this CertificateAuthority in the
format
projects/*/locations/*/certificateAuthorities/*
. - pem_ca_certificate (::String) — Required. The signed CA certificate issued from FetchCertificateAuthorityCsrResponse.pem_csr.
- subordinate_config (::Google::Cloud::Security::PrivateCA::V1beta1::SubordinateConfig, ::Hash) — Required. Must include information about the issuer of 'pem_ca_certificate', and any further issuers until the self-signed CA.
-
request_id (::String) — Optional. An ID to identify requests. Specify a unique request ID so that if you must
retry your request, the server will know to ignore the request if it has
already been completed. The server will guarantee that for at least 60
minutes since the first request.
For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
- (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/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::ActivateCertificateAuthorityRequest.new # Call the activate_certificate_authority method. result = client.activate_certificate_authority 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
#configure
def configure() { |config| ... } -> Client::Configuration
Configure the CertificateAuthorityService 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) -> ::Google::Cloud::Security::PrivateCA::V1beta1::Certificate
def create_certificate(parent: nil, certificate_id: nil, certificate: nil, request_id: nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::Certificate
Create a new Certificate in a given Project, Location from a particular CertificateAuthority.
def create_certificate(request, options = nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::Certificate
create_certificate
via a request object, either of type
Google::Cloud::Security::PrivateCA::V1beta1::CreateCertificateRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::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, request_id: nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::Certificate
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 resource name of the location and CertificateAuthority
associated with the Certificate, in the format
projects/*/locations/*/certificateAuthorities/*
. -
certificate_id (::String) — Optional. It must be unique within a location and match the regular
expression
[a-zA-Z0-9_-]{1,63}
. This field is required when using a CertificateAuthority in the Enterprise CertificateAuthority.Tier, but is optional and its value is ignored otherwise. - certificate (::Google::Cloud::Security::PrivateCA::V1beta1::Certificate, ::Hash) — Required. A Certificate with initial field values.
-
request_id (::String) — Optional. An ID to identify requests. Specify a unique request ID so that if you must
retry your request, the server will know to ignore the request if it has
already been completed. The server will guarantee that for at least 60
minutes since the first request.
For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
- (response, operation) — Access the result along with the RPC operation
- response (::Google::Cloud::Security::PrivateCA::V1beta1::Certificate)
- operation (::GRPC::ActiveCall::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::CreateCertificateRequest.new # Call the create_certificate method. result = client.create_certificate request # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::Certificate. p result
#create_certificate_authority
def create_certificate_authority(request, options = nil) -> ::Gapic::Operation
def create_certificate_authority(parent: nil, certificate_authority_id: nil, certificate_authority: nil, request_id: nil) -> ::Gapic::Operation
Create a new CertificateAuthority in a given Project and Location.
def create_certificate_authority(request, options = nil) -> ::Gapic::Operation
create_certificate_authority
via a request object, either of type
Google::Cloud::Security::PrivateCA::V1beta1::CreateCertificateAuthorityRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::CreateCertificateAuthorityRequest, ::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_authority(parent: nil, certificate_authority_id: nil, certificate_authority: nil, request_id: nil) -> ::Gapic::Operation
create_certificate_authority
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 resource name of the location associated with the
CertificateAuthorities, in the format
projects/*/locations/*
. -
certificate_authority_id (::String) — Required. It must be unique within a location and match the regular
expression
[a-zA-Z0-9_-]{1,63}
- certificate_authority (::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthority, ::Hash) — Required. A CertificateAuthority with initial field values.
-
request_id (::String) — Optional. An ID to identify requests. Specify a unique request ID so that if you must
retry your request, the server will know to ignore the request if it has
already been completed. The server will guarantee that for at least 60
minutes since the first request.
For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
- (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/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::CreateCertificateAuthorityRequest.new # Call the create_certificate_authority method. result = client.create_certificate_authority 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
#disable_certificate_authority
def disable_certificate_authority(request, options = nil) -> ::Gapic::Operation
def disable_certificate_authority(name: nil, request_id: nil) -> ::Gapic::Operation
Disable a CertificateAuthority.
def disable_certificate_authority(request, options = nil) -> ::Gapic::Operation
disable_certificate_authority
via a request object, either of type
DisableCertificateAuthorityRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::DisableCertificateAuthorityRequest, ::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 disable_certificate_authority(name: nil, request_id: nil) -> ::Gapic::Operation
disable_certificate_authority
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. The resource name for this CertificateAuthority in the
format
projects/*/locations/*/certificateAuthorities/*
. -
request_id (::String) — Optional. An ID to identify requests. Specify a unique request ID so that if you must
retry your request, the server will know to ignore the request if it has
already been completed. The server will guarantee that for at least 60
minutes since the first request.
For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
- (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/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::DisableCertificateAuthorityRequest.new # Call the disable_certificate_authority method. result = client.disable_certificate_authority 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
#enable_certificate_authority
def enable_certificate_authority(request, options = nil) -> ::Gapic::Operation
def enable_certificate_authority(name: nil, request_id: nil) -> ::Gapic::Operation
Enable a CertificateAuthority.
def enable_certificate_authority(request, options = nil) -> ::Gapic::Operation
enable_certificate_authority
via a request object, either of type
EnableCertificateAuthorityRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::EnableCertificateAuthorityRequest, ::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 enable_certificate_authority(name: nil, request_id: nil) -> ::Gapic::Operation
enable_certificate_authority
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. The resource name for this CertificateAuthority in the
format
projects/*/locations/*/certificateAuthorities/*
. -
request_id (::String) — Optional. An ID to identify requests. Specify a unique request ID so that if you must
retry your request, the server will know to ignore the request if it has
already been completed. The server will guarantee that for at least 60
minutes since the first request.
For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
- (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/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::EnableCertificateAuthorityRequest.new # Call the enable_certificate_authority method. result = client.enable_certificate_authority 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
#fetch_certificate_authority_csr
def fetch_certificate_authority_csr(request, options = nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::FetchCertificateAuthorityCsrResponse
def fetch_certificate_authority_csr(name: nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::FetchCertificateAuthorityCsrResponse
Fetch a certificate signing request (CSR) from a CertificateAuthority that is in state PENDING_ACTIVATION and is of type SUBORDINATE. The CSR must then be signed by the desired parent Certificate Authority, which could be another CertificateAuthority resource, or could be an on-prem certificate authority. See also ActivateCertificateAuthority.
def fetch_certificate_authority_csr(request, options = nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::FetchCertificateAuthorityCsrResponse
fetch_certificate_authority_csr
via a request object, either of type
FetchCertificateAuthorityCsrRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::FetchCertificateAuthorityCsrRequest, ::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 fetch_certificate_authority_csr(name: nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::FetchCertificateAuthorityCsrResponse
fetch_certificate_authority_csr
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. The resource name for this CertificateAuthority in the
format
projects/*/locations/*/certificateAuthorities/*
.
- (response, operation) — Access the result along with the RPC operation
- response (::Google::Cloud::Security::PrivateCA::V1beta1::FetchCertificateAuthorityCsrResponse)
- operation (::GRPC::ActiveCall::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::FetchCertificateAuthorityCsrRequest.new # Call the fetch_certificate_authority_csr method. result = client.fetch_certificate_authority_csr request # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::FetchCertificateAuthorityCsrResponse. p result
#get_certificate
def get_certificate(request, options = nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::Certificate
def get_certificate(name: nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::Certificate
Returns a Certificate.
def get_certificate(request, options = nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::Certificate
get_certificate
via a request object, either of type
GetCertificateRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::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::Security::PrivateCA::V1beta1::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. The name of the Certificate to get.
- (response, operation) — Access the result along with the RPC operation
- response (::Google::Cloud::Security::PrivateCA::V1beta1::Certificate)
- operation (::GRPC::ActiveCall::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::GetCertificateRequest.new # Call the get_certificate method. result = client.get_certificate request # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::Certificate. p result
#get_certificate_authority
def get_certificate_authority(request, options = nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthority
def get_certificate_authority(name: nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthority
Returns a CertificateAuthority.
def get_certificate_authority(request, options = nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthority
get_certificate_authority
via a request object, either of type
GetCertificateAuthorityRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::GetCertificateAuthorityRequest, ::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_authority(name: nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthority
get_certificate_authority
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. The name of the CertificateAuthority to get.
- (response, operation) — Access the result along with the RPC operation
- response (::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthority)
- operation (::GRPC::ActiveCall::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::GetCertificateAuthorityRequest.new # Call the get_certificate_authority method. result = client.get_certificate_authority request # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthority. p result
#get_certificate_revocation_list
def get_certificate_revocation_list(request, options = nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::CertificateRevocationList
def get_certificate_revocation_list(name: nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::CertificateRevocationList
Returns a CertificateRevocationList.
def get_certificate_revocation_list(request, options = nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::CertificateRevocationList
get_certificate_revocation_list
via a request object, either of type
GetCertificateRevocationListRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::GetCertificateRevocationListRequest, ::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_revocation_list(name: nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::CertificateRevocationList
get_certificate_revocation_list
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. The name of the CertificateRevocationList to get.
- (response, operation) — Access the result along with the RPC operation
- response (::Google::Cloud::Security::PrivateCA::V1beta1::CertificateRevocationList)
- operation (::GRPC::ActiveCall::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::GetCertificateRevocationListRequest.new # Call the get_certificate_revocation_list method. result = client.get_certificate_revocation_list request # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::CertificateRevocationList. p result
#get_reusable_config
def get_reusable_config(request, options = nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::ReusableConfig
def get_reusable_config(name: nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::ReusableConfig
Returns a ReusableConfig.
def get_reusable_config(request, options = nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::ReusableConfig
get_reusable_config
via a request object, either of type
GetReusableConfigRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::GetReusableConfigRequest, ::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_reusable_config(name: nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::ReusableConfig
get_reusable_config
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. The [name][ReusableConfigs.name] of the [ReusableConfigs][] to get.
- (response, operation) — Access the result along with the RPC operation
- response (::Google::Cloud::Security::PrivateCA::V1beta1::ReusableConfig)
- operation (::GRPC::ActiveCall::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::GetReusableConfigRequest.new # Call the get_reusable_config method. result = client.get_reusable_config request # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::ReusableConfig. p result
#initialize
def initialize() { |config| ... } -> Client
Create a new CertificateAuthorityService client object.
- (config) — Configure the CertificateAuthorityService client.
- config (Client::Configuration)
- (Client) — a new instance of Client
# Create a client using the default configuration client = ::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a client using a custom configuration client = ::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new do |config| config.timeout = 10.0 end
#list_certificate_authorities
def list_certificate_authorities(request, options = nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthority>
def list_certificate_authorities(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthority>
Lists CertificateAuthorities.
def list_certificate_authorities(request, options = nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthority>
list_certificate_authorities
via a request object, either of type
ListCertificateAuthoritiesRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::ListCertificateAuthoritiesRequest, ::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_authorities(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthority>
list_certificate_authorities
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 resource name of the location associated with the
CertificateAuthorities, in the format
projects/*/locations/*
. - page_size (::Integer) — Optional. Limit on the number of CertificateAuthorities to include in the response. Further CertificateAuthorities can subsequently be obtained by including the ListCertificateAuthoritiesResponse.next_page_token in a subsequent request. If unspecified, the server will pick an appropriate default.
- page_token (::String) — Optional. Pagination token, returned earlier via ListCertificateAuthoritiesResponse.next_page_token.
- filter (::String) — Optional. Only include resources that match the filter in the response.
- order_by (::String) — Optional. Specify how the results should be sorted.
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthority>)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthority>)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::ListCertificateAuthoritiesRequest.new # Call the list_certificate_authorities method. result = client.list_certificate_authorities 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::Security::PrivateCA::V1beta1::CertificateAuthority. p response end
#list_certificate_revocation_lists
def list_certificate_revocation_lists(request, options = nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::CertificateRevocationList>
def list_certificate_revocation_lists(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::CertificateRevocationList>
Lists CertificateRevocationLists.
def list_certificate_revocation_lists(request, options = nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::CertificateRevocationList>
list_certificate_revocation_lists
via a request object, either of type
ListCertificateRevocationListsRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::ListCertificateRevocationListsRequest, ::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_revocation_lists(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::CertificateRevocationList>
list_certificate_revocation_lists
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 resource name of the location associated with the
CertificateRevocationLists, in the format
projects/*/locations/*/certificateauthorities/*
. - page_size (::Integer) — Optional. Limit on the number of CertificateRevocationLists to include in the response. Further CertificateRevocationLists can subsequently be obtained by including the ListCertificateRevocationListsResponse.next_page_token in a subsequent request. If unspecified, the server will pick an appropriate default.
- page_token (::String) — Optional. Pagination token, returned earlier via ListCertificateRevocationListsResponse.next_page_token.
- filter (::String) — Optional. Only include resources that match the filter in the response.
- order_by (::String) — Optional. Specify how the results should be sorted.
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::CertificateRevocationList>)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::CertificateRevocationList>)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::ListCertificateRevocationListsRequest.new # Call the list_certificate_revocation_lists method. result = client.list_certificate_revocation_lists 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::Security::PrivateCA::V1beta1::CertificateRevocationList. p response end
#list_certificates
def list_certificates(request, options = nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::Certificate>
def list_certificates(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::Certificate>
Lists Certificates.
def list_certificates(request, options = nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::Certificate>
list_certificates
via a request object, either of type
ListCertificatesRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::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::Security::PrivateCA::V1beta1::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 resource name of the location associated with the
Certificates, in the format
projects/*/locations/*/certificateauthorities/*
. - page_size (::Integer) — Optional. Limit on the number of Certificates to include in the response. Further Certificates can subsequently be obtained by including the ListCertificatesResponse.next_page_token in a subsequent request. If unspecified, the server will pick an appropriate default.
- page_token (::String) — Optional. Pagination token, returned earlier via ListCertificatesResponse.next_page_token.
- filter (::String) — Optional. Only include resources that match the filter in the response. For details on supported filters and syntax, see Certificates Filtering documentation.
- order_by (::String) — Optional. Specify how the results should be sorted. For details on supported fields and syntax, see Certificates Sorting documentation.
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::Certificate>)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::Certificate>)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::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::Security::PrivateCA::V1beta1::Certificate. p response end
#list_reusable_configs
def list_reusable_configs(request, options = nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::ReusableConfig>
def list_reusable_configs(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::ReusableConfig>
Lists ReusableConfigs.
def list_reusable_configs(request, options = nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::ReusableConfig>
list_reusable_configs
via a request object, either of type
ListReusableConfigsRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::ListReusableConfigsRequest, ::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_reusable_configs(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::ReusableConfig>
list_reusable_configs
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 resource name of the location associated with the
ReusableConfigs, in the format
projects/*/locations/*
. - page_size (::Integer) — Optional. Limit on the number of ReusableConfigs to include in the response. Further ReusableConfigs can subsequently be obtained by including the ListReusableConfigsResponse.next_page_token in a subsequent request. If unspecified, the server will pick an appropriate default.
- page_token (::String) — Optional. Pagination token, returned earlier via ListReusableConfigsResponse.next_page_token.
- filter (::String) — Optional. Only include resources that match the filter in the response.
- order_by (::String) — Optional. Specify how the results should be sorted.
- (response, operation) — Access the result along with the RPC operation
- response (::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::ReusableConfig>)
- operation (::GRPC::ActiveCall::Operation)
- (::Gapic::PagedEnumerable<::Google::Cloud::Security::PrivateCA::V1beta1::ReusableConfig>)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::ListReusableConfigsRequest.new # Call the list_reusable_configs method. result = client.list_reusable_configs 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::Security::PrivateCA::V1beta1::ReusableConfig. p response end
#operations_client
def operations_client() -> ::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Operations
Get the associated client for long-running operations.
#restore_certificate_authority
def restore_certificate_authority(request, options = nil) -> ::Gapic::Operation
def restore_certificate_authority(name: nil, request_id: nil) -> ::Gapic::Operation
Restore a CertificateAuthority that is scheduled for deletion.
def restore_certificate_authority(request, options = nil) -> ::Gapic::Operation
restore_certificate_authority
via a request object, either of type
RestoreCertificateAuthorityRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::RestoreCertificateAuthorityRequest, ::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 restore_certificate_authority(name: nil, request_id: nil) -> ::Gapic::Operation
restore_certificate_authority
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. The resource name for this CertificateAuthority in the
format
projects/*/locations/*/certificateAuthorities/*
. -
request_id (::String) — Optional. An ID to identify requests. Specify a unique request ID so that if you must
retry your request, the server will know to ignore the request if it has
already been completed. The server will guarantee that for at least 60
minutes since the first request.
For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
- (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/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::RestoreCertificateAuthorityRequest.new # Call the restore_certificate_authority method. result = client.restore_certificate_authority 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
#revoke_certificate
def revoke_certificate(request, options = nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::Certificate
def revoke_certificate(name: nil, reason: nil, request_id: nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::Certificate
Revoke a Certificate.
def revoke_certificate(request, options = nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::Certificate
revoke_certificate
via a request object, either of type
RevokeCertificateRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::RevokeCertificateRequest, ::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 revoke_certificate(name: nil, reason: nil, request_id: nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::Certificate
revoke_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. The resource name for this Certificate in the
format
projects/*/locations/*/certificateAuthorities/*/certificates/*
. - reason (::Google::Cloud::Security::PrivateCA::V1beta1::RevocationReason) — Required. The RevocationReason for revoking this certificate.
-
request_id (::String) — Optional. An ID to identify requests. Specify a unique request ID so that if you must
retry your request, the server will know to ignore the request if it has
already been completed. The server will guarantee that for at least 60
minutes since the first request.
For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
- (response, operation) — Access the result along with the RPC operation
- response (::Google::Cloud::Security::PrivateCA::V1beta1::Certificate)
- operation (::GRPC::ActiveCall::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::RevokeCertificateRequest.new # Call the revoke_certificate method. result = client.revoke_certificate request # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::Certificate. p result
#schedule_delete_certificate_authority
def schedule_delete_certificate_authority(request, options = nil) -> ::Gapic::Operation
def schedule_delete_certificate_authority(name: nil, request_id: nil) -> ::Gapic::Operation
Schedule a CertificateAuthority for deletion.
def schedule_delete_certificate_authority(request, options = nil) -> ::Gapic::Operation
schedule_delete_certificate_authority
via a request object, either of type
ScheduleDeleteCertificateAuthorityRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::ScheduleDeleteCertificateAuthorityRequest, ::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 schedule_delete_certificate_authority(name: nil, request_id: nil) -> ::Gapic::Operation
schedule_delete_certificate_authority
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. The resource name for this CertificateAuthority in the
format
projects/*/locations/*/certificateAuthorities/*
. -
request_id (::String) — Optional. An ID to identify requests. Specify a unique request ID so that if you must
retry your request, the server will know to ignore the request if it has
already been completed. The server will guarantee that for at least 60
minutes since the first request.
For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
- (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/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::ScheduleDeleteCertificateAuthorityRequest.new # Call the schedule_delete_certificate_authority method. result = client.schedule_delete_certificate_authority 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
def update_certificate(request, options = nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::Certificate
def update_certificate(certificate: nil, update_mask: nil, request_id: nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::Certificate
Update a Certificate. Currently, the only field you can update is the labels field.
def update_certificate(request, options = nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::Certificate
update_certificate
via a request object, either of type
UpdateCertificateRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::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, request_id: nil) -> ::Google::Cloud::Security::PrivateCA::V1beta1::Certificate
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::Security::PrivateCA::V1beta1::Certificate, ::Hash) — Required. Certificate with updated values.
- update_mask (::Google::Protobuf::FieldMask, ::Hash) — Required. A list of fields to be updated in this request.
-
request_id (::String) — Optional. An ID to identify requests. Specify a unique request ID so that if you must
retry your request, the server will know to ignore the request if it has
already been completed. The server will guarantee that for at least 60
minutes since the first request.
For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
- (response, operation) — Access the result along with the RPC operation
- response (::Google::Cloud::Security::PrivateCA::V1beta1::Certificate)
- operation (::GRPC::ActiveCall::Operation)
- (::Google::Cloud::Error) — if the RPC is aborted.
Basic example
require "google/cloud/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::UpdateCertificateRequest.new # Call the update_certificate method. result = client.update_certificate request # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::Certificate. p result
#update_certificate_authority
def update_certificate_authority(request, options = nil) -> ::Gapic::Operation
def update_certificate_authority(certificate_authority: nil, update_mask: nil, request_id: nil) -> ::Gapic::Operation
Update a CertificateAuthority.
def update_certificate_authority(request, options = nil) -> ::Gapic::Operation
update_certificate_authority
via a request object, either of type
UpdateCertificateAuthorityRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::UpdateCertificateAuthorityRequest, ::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_authority(certificate_authority: nil, update_mask: nil, request_id: nil) -> ::Gapic::Operation
update_certificate_authority
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_authority (::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthority, ::Hash) — Required. CertificateAuthority with updated values.
- update_mask (::Google::Protobuf::FieldMask, ::Hash) — Required. A list of fields to be updated in this request.
-
request_id (::String) — Optional. An ID to identify requests. Specify a unique request ID so that if you must
retry your request, the server will know to ignore the request if it has
already been completed. The server will guarantee that for at least 60
minutes since the first request.
For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
- (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/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::UpdateCertificateAuthorityRequest.new # Call the update_certificate_authority method. result = client.update_certificate_authority 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_revocation_list
def update_certificate_revocation_list(request, options = nil) -> ::Gapic::Operation
def update_certificate_revocation_list(certificate_revocation_list: nil, update_mask: nil, request_id: nil) -> ::Gapic::Operation
Update a CertificateRevocationList.
def update_certificate_revocation_list(request, options = nil) -> ::Gapic::Operation
update_certificate_revocation_list
via a request object, either of type
UpdateCertificateRevocationListRequest or an equivalent Hash.
- request (::Google::Cloud::Security::PrivateCA::V1beta1::UpdateCertificateRevocationListRequest, ::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_revocation_list(certificate_revocation_list: nil, update_mask: nil, request_id: nil) -> ::Gapic::Operation
update_certificate_revocation_list
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_revocation_list (::Google::Cloud::Security::PrivateCA::V1beta1::CertificateRevocationList, ::Hash) — Required. CertificateRevocationList with updated values.
- update_mask (::Google::Protobuf::FieldMask, ::Hash) — Required. A list of fields to be updated in this request.
-
request_id (::String) — Optional. An ID to identify requests. Specify a unique request ID so that if you must
retry your request, the server will know to ignore the request if it has
already been completed. The server will guarantee that for at least 60
minutes since the first request.
For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
- (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/security/private_ca/v1beta1" # Create a client object. The client can be reused for multiple calls. client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new # Create a request. To set request fields, pass in keyword arguments. request = Google::Cloud::Security::PrivateCA::V1beta1::UpdateCertificateRevocationListRequest.new # Call the update_certificate_revocation_list method. result = client.update_certificate_revocation_list 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