google-cloud-security-private_ca-v1 0.8.1 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 518d115fbb96b547758f43a3ee3a75a9fca28264a24bbc96281f6238975f3712
-  data.tar.gz: e3719c2ff974494620f2ec91585774dac26522be5d47ab77bb34b0e926e401c1
+  metadata.gz: 4121e58277ff27d26ec4e6018c6d54707343b3b7bf61089676c4423d8f51dc2d
+  data.tar.gz: 34251313dad83c31f244c9ccff1042a7d931841f2bc5de4fb16a9d1380372bdd
 SHA512:
-  metadata.gz: 42d64eda0a40921b52d663caacf4182b7b8a0b5fc80d27396ae5b3aa629aef3a43684986b01a03b2b609a4448c081833a109a810dc008f64cf16647d283c756b
-  data.tar.gz: 94d4b13c8417f8362338d4791e4e962d6a7846daa58a5ebf4ede7c182d707b8bebfb4c0b076aa6e7929c89ae8b2c1dd750a9368a801a9bd09e72649bccdc9197
+  metadata.gz: 502de49b1e150146587d05092a3f5371faa6d2745d82987a2897f2e7426f69dce6b9cf0f2e690eff2abd13ca60b017f02fb402985973972cedebba6cb91a6f5d
+  data.tar.gz: 87ba04ecdbd2100b6e52392c9ca8e6df164e4dade7f5c00cc8993083382b5081eb718b9068a6ccac2b5aeb5fe421a68cffa73a993707b68b6018bf5a0b6b0951

data/lib/google/cloud/security/private_ca/v1/certificate_authority_service/client.rb

@@ -166,7 +166,8 @@ module Google
                   credentials:  credentials,
                   endpoint:     @config.endpoint,
                   channel_args: @config.channel_args,
-                  interceptors: @config.interceptors
+                  interceptors: @config.interceptors,
+                  channel_pool_config: @config.channel_pool
                 )
               end
 
@@ -3457,6 +3458,14 @@ module Google
                   end
                 end
 
+                ##
+                # Configuration for the channel pool
+                # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
+                #
+                def channel_pool
+                  @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
+                end
+
                 ##
                 # Configuration RPC class for the CertificateAuthorityService API.
                 #

data/lib/google/cloud/security/private_ca/v1/certificate_authority_service/operations.rb

@@ -94,7 +94,8 @@ module Google
                   credentials:  credentials,
                   endpoint:     @config.endpoint,
                   channel_args: @config.channel_args,
-                  interceptors: @config.interceptors
+                  interceptors: @config.interceptors,
+                  channel_pool_config: @config.channel_pool
                 )
 
                 # Used by an LRO wrapper for some methods of this service
@@ -702,6 +703,14 @@ module Google
                   end
                 end
 
+                ##
+                # Configuration for the channel pool
+                # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
+                #
+                def channel_pool
+                  @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
+                end
+
                 ##
                 # Configuration RPC class for the Operations API.
                 #

data/lib/google/cloud/security/private_ca/v1/certificate_authority_service/rest/client.rb

@@ -270,6 +270,22 @@ module Google
                 # @return [::Google::Cloud::Security::PrivateCA::V1::Certificate]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::CreateCertificateRequest.new
+                #
+                #   # Call the create_certificate method.
+                #   result = client.create_certificate request
+                #
+                #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1::Certificate.
+                #   p result
+                #
                 def create_certificate request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -334,6 +350,22 @@ module Google
                 # @return [::Google::Cloud::Security::PrivateCA::V1::Certificate]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::GetCertificateRequest.new
+                #
+                #   # Call the get_certificate method.
+                #   result = client.get_certificate request
+                #
+                #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1::Certificate.
+                #   p result
+                #
                 def get_certificate request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -418,6 +450,26 @@ module Google
                 # @return [::Google::Cloud::Security::PrivateCA::V1::ListCertificatesResponse]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::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 elements, and API calls will be issued to fetch pages as needed.
+                #   result.each do |item|
+                #     # Each element is of type ::Google::Cloud::Security::PrivateCA::V1::Certificate.
+                #     p item
+                #   end
+                #
                 def list_certificates request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -500,6 +552,22 @@ module Google
                 # @return [::Google::Cloud::Security::PrivateCA::V1::Certificate]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::RevokeCertificateRequest.new
+                #
+                #   # Call the revoke_certificate method.
+                #   result = client.revoke_certificate request
+                #
+                #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1::Certificate.
+                #   p result
+                #
                 def revoke_certificate request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -581,6 +649,22 @@ module Google
                 # @return [::Google::Cloud::Security::PrivateCA::V1::Certificate]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::UpdateCertificateRequest.new
+                #
+                #   # Call the update_certificate method.
+                #   result = client.update_certificate request
+                #
+                #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1::Certificate.
+                #   p result
+                #
                 def update_certificate request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -674,6 +758,29 @@ module Google
                 # @return [::Gapic::Operation]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::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 it to
+                #   # check the status of an operation, cancel it, or wait for results.
+                #   # Here is how to wait for a response.
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "No response received."
+                #   end
+                #
                 def activate_certificate_authority request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -763,6 +870,29 @@ module Google
                 # @return [::Gapic::Operation]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::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 it to
+                #   # check the status of an operation, cancel it, or wait for results.
+                #   # Here is how to wait for a response.
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "No response received."
+                #   end
+                #
                 def create_certificate_authority request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -848,6 +978,29 @@ module Google
                 # @return [::Gapic::Operation]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::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 it to
+                #   # check the status of an operation, cancel it, or wait for results.
+                #   # Here is how to wait for a response.
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "No response received."
+                #   end
+                #
                 def disable_certificate_authority request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -928,6 +1081,29 @@ module Google
                 # @return [::Gapic::Operation]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::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 it to
+                #   # check the status of an operation, cancel it, or wait for results.
+                #   # Here is how to wait for a response.
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "No response received."
+                #   end
+                #
                 def enable_certificate_authority request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1003,6 +1179,22 @@ module Google
                 # @return [::Google::Cloud::Security::PrivateCA::V1::FetchCertificateAuthorityCsrResponse]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::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::V1::FetchCertificateAuthorityCsrResponse.
+                #   p result
+                #
                 def fetch_certificate_authority_csr request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1069,6 +1261,22 @@ module Google
                 # @return [::Google::Cloud::Security::PrivateCA::V1::CertificateAuthority]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::GetCertificateAuthorityRequest.new
+                #
+                #   # Call the get_certificate_authority method.
+                #   result = client.get_certificate_authority request
+                #
+                #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1::CertificateAuthority.
+                #   p result
+                #
                 def get_certificate_authority request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1151,6 +1359,26 @@ module Google
                 # @return [::Google::Cloud::Security::PrivateCA::V1::ListCertificateAuthoritiesResponse]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::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 elements, and API calls will be issued to fetch pages as needed.
+                #   result.each do |item|
+                #     # Each element is of type ::Google::Cloud::Security::PrivateCA::V1::CertificateAuthority.
+                #     p item
+                #   end
+                #
                 def list_certificate_authorities request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1231,6 +1459,29 @@ module Google
                 # @return [::Gapic::Operation]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::UndeleteCertificateAuthorityRequest.new
+                #
+                #   # Call the undelete_certificate_authority method.
+                #   result = client.undelete_certificate_authority request
+                #
+                #   # The returned object is of type Gapic::Operation. You can use it to
+                #   # check the status of an operation, cancel it, or wait for results.
+                #   # Here is how to wait for a response.
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "No response received."
+                #   end
+                #
                 def undelete_certificate_authority request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1323,6 +1574,29 @@ module Google
                 # @return [::Gapic::Operation]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::DeleteCertificateAuthorityRequest.new
+                #
+                #   # Call the delete_certificate_authority method.
+                #   result = client.delete_certificate_authority request
+                #
+                #   # The returned object is of type Gapic::Operation. You can use it to
+                #   # check the status of an operation, cancel it, or wait for results.
+                #   # Here is how to wait for a response.
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "No response received."
+                #   end
+                #
                 def delete_certificate_authority request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1405,6 +1679,29 @@ module Google
                 # @return [::Gapic::Operation]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::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 it to
+                #   # check the status of an operation, cancel it, or wait for results.
+                #   # Here is how to wait for a response.
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "No response received."
+                #   end
+                #
                 def update_certificate_authority request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1490,6 +1787,29 @@ module Google
                 # @return [::Gapic::Operation]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::CreateCaPoolRequest.new
+                #
+                #   # Call the create_ca_pool method.
+                #   result = client.create_ca_pool request
+                #
+                #   # The returned object is of type Gapic::Operation. You can use it to
+                #   # check the status of an operation, cancel it, or wait for results.
+                #   # Here is how to wait for a response.
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "No response received."
+                #   end
+                #
                 def create_ca_pool request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1570,6 +1890,29 @@ module Google
                 # @return [::Gapic::Operation]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::UpdateCaPoolRequest.new
+                #
+                #   # Call the update_ca_pool method.
+                #   result = client.update_ca_pool request
+                #
+                #   # The returned object is of type Gapic::Operation. You can use it to
+                #   # check the status of an operation, cancel it, or wait for results.
+                #   # Here is how to wait for a response.
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "No response received."
+                #   end
+                #
                 def update_ca_pool request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1634,6 +1977,22 @@ module Google
                 # @return [::Google::Cloud::Security::PrivateCA::V1::CaPool]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::GetCaPoolRequest.new
+                #
+                #   # Call the get_ca_pool method.
+                #   result = client.get_ca_pool request
+                #
+                #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1::CaPool.
+                #   p result
+                #
                 def get_ca_pool request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1713,6 +2072,26 @@ module Google
                 # @return [::Google::Cloud::Security::PrivateCA::V1::ListCaPoolsResponse]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::ListCaPoolsRequest.new
+                #
+                #   # Call the list_ca_pools method.
+                #   result = client.list_ca_pools request
+                #
+                #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+                #   # over elements, and API calls will be issued to fetch pages as needed.
+                #   result.each do |item|
+                #     # Each element is of type ::Google::Cloud::Security::PrivateCA::V1::CaPool.
+                #     p item
+                #   end
+                #
                 def list_ca_pools request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1796,6 +2175,29 @@ module Google
                 # @return [::Gapic::Operation]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::DeleteCaPoolRequest.new
+                #
+                #   # Call the delete_ca_pool method.
+                #   result = client.delete_ca_pool request
+                #
+                #   # The returned object is of type Gapic::Operation. You can use it to
+                #   # check the status of an operation, cancel it, or wait for results.
+                #   # Here is how to wait for a response.
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "No response received."
+                #   end
+                #
                 def delete_ca_pool request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1879,6 +2281,22 @@ module Google
                 # @return [::Google::Cloud::Security::PrivateCA::V1::FetchCaCertsResponse]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::FetchCaCertsRequest.new
+                #
+                #   # Call the fetch_ca_certs method.
+                #   result = client.fetch_ca_certs request
+                #
+                #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1::FetchCaCertsResponse.
+                #   p result
+                #
                 def fetch_ca_certs request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1946,6 +2364,22 @@ module Google
                 # @return [::Google::Cloud::Security::PrivateCA::V1::CertificateRevocationList]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::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::V1::CertificateRevocationList.
+                #   p result
+                #
                 def get_certificate_revocation_list request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2027,6 +2461,26 @@ module Google
                 # @return [::Google::Cloud::Security::PrivateCA::V1::ListCertificateRevocationListsResponse]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::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 elements, and API calls will be issued to fetch pages as needed.
+                #   result.each do |item|
+                #     # Each element is of type ::Google::Cloud::Security::PrivateCA::V1::CertificateRevocationList.
+                #     p item
+                #   end
+                #
                 def list_certificate_revocation_lists request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2108,6 +2562,29 @@ module Google
                 # @return [::Gapic::Operation]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::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 it to
+                #   # check the status of an operation, cancel it, or wait for results.
+                #   # Here is how to wait for a response.
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "No response received."
+                #   end
+                #
                 def update_certificate_revocation_list request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2196,6 +2673,29 @@ module Google
                 # @return [::Gapic::Operation]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::CreateCertificateTemplateRequest.new
+                #
+                #   # Call the create_certificate_template method.
+                #   result = client.create_certificate_template request
+                #
+                #   # The returned object is of type Gapic::Operation. You can use it to
+                #   # check the status of an operation, cancel it, or wait for results.
+                #   # Here is how to wait for a response.
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "No response received."
+                #   end
+                #
                 def create_certificate_template request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2276,6 +2776,29 @@ module Google
                 # @return [::Gapic::Operation]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::DeleteCertificateTemplateRequest.new
+                #
+                #   # Call the delete_certificate_template method.
+                #   result = client.delete_certificate_template request
+                #
+                #   # The returned object is of type Gapic::Operation. You can use it to
+                #   # check the status of an operation, cancel it, or wait for results.
+                #   # Here is how to wait for a response.
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "No response received."
+                #   end
+                #
                 def delete_certificate_template request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2343,6 +2866,22 @@ module Google
                 # @return [::Google::Cloud::Security::PrivateCA::V1::CertificateTemplate]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::GetCertificateTemplateRequest.new
+                #
+                #   # Call the get_certificate_template method.
+                #   result = client.get_certificate_template request
+                #
+                #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1::CertificateTemplate.
+                #   p result
+                #
                 def get_certificate_template request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2424,6 +2963,26 @@ module Google
                 # @return [::Google::Cloud::Security::PrivateCA::V1::ListCertificateTemplatesResponse]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::ListCertificateTemplatesRequest.new
+                #
+                #   # Call the list_certificate_templates method.
+                #   result = client.list_certificate_templates request
+                #
+                #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+                #   # over elements, and API calls will be issued to fetch pages as needed.
+                #   result.each do |item|
+                #     # Each element is of type ::Google::Cloud::Security::PrivateCA::V1::CertificateTemplate.
+                #     p item
+                #   end
+                #
                 def list_certificate_templates request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2505,6 +3064,29 @@ module Google
                 # @return [::Gapic::Operation]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/security/private_ca/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Security::PrivateCA::V1::UpdateCertificateTemplateRequest.new
+                #
+                #   # Call the update_certificate_template method.
+                #   result = client.update_certificate_template request
+                #
+                #   # The returned object is of type Gapic::Operation. You can use it to
+                #   # check the status of an operation, cancel it, or wait for results.
+                #   # Here is how to wait for a response.
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "No response received."
+                #   end
+                #
                 def update_certificate_template request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/security/private_ca/v1/certificate_authority_service/rest/operations.rb

@@ -137,6 +137,26 @@ module Google
                 # @return [::Gapic::Operation]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/longrunning"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Longrunning::Operations::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Longrunning::ListOperationsRequest.new
+                #
+                #   # Call the list_operations method.
+                #   result = client.list_operations request
+                #
+                #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+                #   # over elements, and API calls will be issued to fetch pages as needed.
+                #   result.each do |item|
+                #     # Each element is of type ::Google::Longrunning::Operation.
+                #     p item
+                #   end
+                #
                 def list_operations request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -202,6 +222,29 @@ module Google
                 # @return [::Gapic::Operation]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/longrunning"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Longrunning::Operations::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Longrunning::GetOperationRequest.new
+                #
+                #   # Call the get_operation method.
+                #   result = client.get_operation request
+                #
+                #   # The returned object is of type Gapic::Operation. You can use it to
+                #   # check the status of an operation, cancel it, or wait for results.
+                #   # Here is how to wait for a response.
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "No response received."
+                #   end
+                #
                 def get_operation request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -268,6 +311,22 @@ module Google
                 # @return [::Google::Protobuf::Empty]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/longrunning"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Longrunning::Operations::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Longrunning::DeleteOperationRequest.new
+                #
+                #   # Call the delete_operation method.
+                #   result = client.delete_operation request
+                #
+                #   # The returned object is of type Google::Protobuf::Empty.
+                #   p result
+                #
                 def delete_operation request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -339,6 +398,22 @@ module Google
                 # @return [::Google::Protobuf::Empty]
                 #
                 # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/longrunning"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Longrunning::Operations::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Longrunning::CancelOperationRequest.new
+                #
+                #   # Call the cancel_operation method.
+                #   result = client.cancel_operation request
+                #
+                #   # The returned object is of type Google::Protobuf::Empty.
+                #   p result
+                #
                 def cancel_operation request, options = nil
                   raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/security/private_ca/v1/version.rb

@@ -22,7 +22,7 @@ module Google
     module Security
       module PrivateCA
         module V1
-          VERSION = "0.8.1"
+          VERSION = "0.9.0"
         end
       end
     end

data/proto_docs/google/api/field_behavior.rb

@@ -66,6 +66,20 @@ module Google
       # a non-empty value will be returned. The user will not be aware of what
       # non-empty value to expect.
       NON_EMPTY_DEFAULT = 7
+
+      # Denotes that the field in a resource (a message annotated with
+      # google.api.resource) is used in the resource name to uniquely identify the
+      # resource. For AIP-compliant APIs, this should only be applied to the
+      # `name` field on the resource.
+      #
+      # This behavior should not be applied to references to other resources within
+      # the message.
+      #
+      # The identifier field of resources often have different field behavior
+      # depending on the request it is embedded in (e.g. for Create methods name
+      # is optional and unused, while for Update methods it is required). Instead
+      # of method-specific annotations, only `IDENTIFIER` is required.
+      IDENTIFIER = 8
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-security-private_ca-v1
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.9.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-06 00:00:00.000000000 Z
+date: 2023-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: 0.20.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: 0.20.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -262,7 +262,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.2
+rubygems_version: 3.4.19
 signing_key: 
 specification_version: 4
 summary: The Certificate Authority Service API is a highly-available, scalable service