google-cloud-kms-v1 0.22.0 → 0.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 64473976f0753f689b4cefdd08c0c94c1f754aa204f01a3b64d4f3320fb38f37
-  data.tar.gz: 78b7ddfb19d188f94838b3e654ad250a3567003b34a5024b28e1bf6b068b852a
+  metadata.gz: 1dec37e0132e3a5152edb7d89eb91ab3686393708c990ccf7ddf00dc817820cb
+  data.tar.gz: 245ac49330e68941946c310659cc7368b7240d011c0e291a162e3d748341b04b
 SHA512:
-  metadata.gz: afc8c97105c0bf92812f41a71da15550f9602de8eaf8b82a79b41ec426682c8d5127a4b9ff20cca255e5f9a7b45bda77f1ac1b3dfc4934a3808ed1ab4f5db17a
-  data.tar.gz: 021f3ecca9cf17537cd6f93b62c606fbed0860a2498d30d03fe6cddb75a8ac70de3822fe70eb96416d4217ad98f06a236b76b50c6d92c3c31dcd81a0a7eb78f8
+  metadata.gz: 11a2b354ac86ded1667472327168a2966114ecf8cf304581ab2b6d7930f11580200da850abb5429ab380421999a3b2c71ef9560f43fd14b4cd874177c18dc608
+  data.tar.gz: e9ecc33b0aac7e1789a23636e3ba51e7e76ee7298e8b5ffb69bdf3c822a91915e199e733bfef2ddcb50e7539ede11f8424008ba44862c5963ac8d5e0b41df8d0

data/lib/google/cloud/kms/v1/ekm_service/client.rb

@@ -176,7 +176,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
 
@@ -962,6 +963,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 EkmService API.
               #

data/lib/google/cloud/kms/v1/ekm_service/rest/client.rb

@@ -239,6 +239,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Kms::V1::EkmConnection>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::EkmService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::ListEkmConnectionsRequest.new
+              #
+              #   # Call the list_ekm_connections method.
+              #   result = client.list_ekm_connections 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::Kms::V1::EkmConnection.
+              #     p item
+              #   end
+              #
               def list_ekm_connections request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -304,6 +324,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::EkmConnection]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::EkmService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::GetEkmConnectionRequest.new
+              #
+              #   # Call the get_ekm_connection method.
+              #   result = client.get_ekm_connection request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::EkmConnection.
+              #   p result
+              #
               def get_ekm_connection request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -375,6 +411,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::EkmConnection]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::EkmService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::CreateEkmConnectionRequest.new
+              #
+              #   # Call the create_ekm_connection method.
+              #   result = client.create_ekm_connection request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::EkmConnection.
+              #   p result
+              #
               def create_ekm_connection request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -440,6 +492,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::EkmConnection]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::EkmService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::UpdateEkmConnectionRequest.new
+              #
+              #   # Call the update_ekm_connection method.
+              #   result = client.update_ekm_connection request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::EkmConnection.
+              #   p result
+              #
               def update_ekm_connection request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -504,6 +572,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::EkmConfig]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::EkmService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::GetEkmConfigRequest.new
+              #
+              #   # Call the get_ekm_config method.
+              #   result = client.get_ekm_config request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::EkmConfig.
+              #   p result
+              #
               def get_ekm_config request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -569,6 +653,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::EkmConfig]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::EkmService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::UpdateEkmConfigRequest.new
+              #
+              #   # Call the update_ekm_config method.
+              #   result = client.update_ekm_config request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::EkmConfig.
+              #   p result
+              #
               def update_ekm_config request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -636,6 +736,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::VerifyConnectivityResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::EkmService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::VerifyConnectivityRequest.new
+              #
+              #   # Call the verify_connectivity method.
+              #   result = client.verify_connectivity request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::VerifyConnectivityResponse.
+              #   p result
+              #
               def verify_connectivity request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/kms/v1/key_management_service/client.rb

@@ -287,7 +287,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
 
@@ -3580,6 +3581,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 KeyManagementService API.
               #

data/lib/google/cloud/kms/v1/key_management_service/rest/client.rb

@@ -350,6 +350,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Kms::V1::KeyRing>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::ListKeyRingsRequest.new
+              #
+              #   # Call the list_key_rings method.
+              #   result = client.list_key_rings 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::Kms::V1::KeyRing.
+              #     p item
+              #   end
+              #
               def list_key_rings request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -437,6 +457,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Kms::V1::CryptoKey>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::ListCryptoKeysRequest.new
+              #
+              #   # Call the list_crypto_keys method.
+              #   result = client.list_crypto_keys 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::Kms::V1::CryptoKey.
+              #     p item
+              #   end
+              #
               def list_crypto_keys request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -525,6 +565,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Kms::V1::CryptoKeyVersion>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::ListCryptoKeyVersionsRequest.new
+              #
+              #   # Call the list_crypto_key_versions method.
+              #   result = client.list_crypto_key_versions 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::Kms::V1::CryptoKeyVersion.
+              #     p item
+              #   end
+              #
               def list_crypto_key_versions request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -610,6 +670,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Kms::V1::ImportJob>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::ListImportJobsRequest.new
+              #
+              #   # Call the list_import_jobs method.
+              #   result = client.list_import_jobs 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::Kms::V1::ImportJob.
+              #     p item
+              #   end
+              #
               def list_import_jobs request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -674,6 +754,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::KeyRing]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::GetKeyRingRequest.new
+              #
+              #   # Call the get_key_ring method.
+              #   result = client.get_key_ring request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::KeyRing.
+              #   p result
+              #
               def get_key_ring request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -739,6 +835,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::CryptoKey]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::GetCryptoKeyRequest.new
+              #
+              #   # Call the get_crypto_key method.
+              #   result = client.get_crypto_key request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::CryptoKey.
+              #   p result
+              #
               def get_crypto_key request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -803,6 +915,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::CryptoKeyVersion]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::GetCryptoKeyVersionRequest.new
+              #
+              #   # Call the get_crypto_key_version method.
+              #   result = client.get_crypto_key_version request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::CryptoKeyVersion.
+              #   p result
+              #
               def get_crypto_key_version request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -871,6 +999,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::PublicKey]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::GetPublicKeyRequest.new
+              #
+              #   # Call the get_public_key method.
+              #   result = client.get_public_key request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::PublicKey.
+              #   p result
+              #
               def get_public_key request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -934,6 +1078,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::ImportJob]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::GetImportJobRequest.new
+              #
+              #   # Call the get_import_job method.
+              #   result = client.get_import_job request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::ImportJob.
+              #   p result
+              #
               def get_import_job request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1005,6 +1165,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::KeyRing]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::CreateKeyRingRequest.new
+              #
+              #   # Call the create_key_ring method.
+              #   result = client.create_key_ring request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::KeyRing.
+              #   p result
+              #
               def create_key_ring request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1088,6 +1264,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::CryptoKey]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::CreateCryptoKeyRequest.new
+              #
+              #   # Call the create_crypto_key method.
+              #   result = client.create_crypto_key request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::CryptoKey.
+              #   p result
+              #
               def create_crypto_key request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1160,6 +1352,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::CryptoKeyVersion]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::CreateCryptoKeyVersionRequest.new
+              #
+              #   # Call the create_crypto_key_version method.
+              #   result = client.create_crypto_key_version request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::CryptoKeyVersion.
+              #   p result
+              #
               def create_crypto_key_version request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1309,6 +1517,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::CryptoKeyVersion]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::ImportCryptoKeyVersionRequest.new
+              #
+              #   # Call the import_crypto_key_version method.
+              #   result = client.import_crypto_key_version request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::CryptoKeyVersion.
+              #   p result
+              #
               def import_crypto_key_version request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1383,6 +1607,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::ImportJob]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::CreateImportJobRequest.new
+              #
+              #   # Call the create_import_job method.
+              #   result = client.create_import_job request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::ImportJob.
+              #   p result
+              #
               def create_import_job request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1447,6 +1687,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::CryptoKey]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::UpdateCryptoKeyRequest.new
+              #
+              #   # Call the update_crypto_key method.
+              #   result = client.update_crypto_key request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::CryptoKey.
+              #   p result
+              #
               def update_crypto_key request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1523,6 +1779,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::CryptoKeyVersion]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::UpdateCryptoKeyVersionRequest.new
+              #
+              #   # Call the update_crypto_key_version method.
+              #   result = client.update_crypto_key_version request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::CryptoKeyVersion.
+              #   p result
+              #
               def update_crypto_key_version request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1594,6 +1866,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::CryptoKey]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::UpdateCryptoKeyPrimaryVersionRequest.new
+              #
+              #   # Call the update_crypto_key_primary_version method.
+              #   result = client.update_crypto_key_primary_version request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::CryptoKey.
+              #   p result
+              #
               def update_crypto_key_primary_version request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1677,6 +1965,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::CryptoKeyVersion]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::DestroyCryptoKeyVersionRequest.new
+              #
+              #   # Call the destroy_crypto_key_version method.
+              #   result = client.destroy_crypto_key_version request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::CryptoKeyVersion.
+              #   p result
+              #
               def destroy_crypto_key_version request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1748,6 +2052,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::CryptoKeyVersion]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::RestoreCryptoKeyVersionRequest.new
+              #
+              #   # Call the restore_crypto_key_version method.
+              #   result = client.restore_crypto_key_version request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::CryptoKeyVersion.
+              #   p result
+              #
               def restore_crypto_key_version request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1885,6 +2205,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::EncryptResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::EncryptRequest.new
+              #
+              #   # Call the encrypt method.
+              #   result = client.encrypt request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::EncryptResponse.
+              #   p result
+              #
               def encrypt request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1998,6 +2334,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::DecryptResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::DecryptRequest.new
+              #
+              #   # Call the decrypt method.
+              #   result = client.decrypt request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::DecryptResponse.
+              #   p result
+              #
               def decrypt request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2148,6 +2500,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::RawEncryptResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::RawEncryptRequest.new
+              #
+              #   # Call the raw_encrypt method.
+              #   result = client.raw_encrypt request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::RawEncryptResponse.
+              #   p result
+              #
               def raw_encrypt request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2278,6 +2646,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::RawDecryptResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::RawDecryptRequest.new
+              #
+              #   # Call the raw_decrypt method.
+              #   result = client.raw_decrypt request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::RawDecryptResponse.
+              #   p result
+              #
               def raw_decrypt request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2399,6 +2783,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::AsymmetricSignResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::AsymmetricSignRequest.new
+              #
+              #   # Call the asymmetric_sign method.
+              #   result = client.asymmetric_sign request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::AsymmetricSignResponse.
+              #   p result
+              #
               def asymmetric_sign request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2491,6 +2891,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::AsymmetricDecryptResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::AsymmetricDecryptRequest.new
+              #
+              #   # Call the asymmetric_decrypt method.
+              #   result = client.asymmetric_decrypt request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::AsymmetricDecryptResponse.
+              #   p result
+              #
               def asymmetric_decrypt request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2578,6 +2994,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::MacSignResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::MacSignRequest.new
+              #
+              #   # Call the mac_sign method.
+              #   result = client.mac_sign request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::MacSignResponse.
+              #   p result
+              #
               def mac_sign request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2687,6 +3119,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::MacVerifyResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::MacVerifyRequest.new
+              #
+              #   # Call the mac_verify method.
+              #   result = client.mac_verify request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::MacVerifyResponse.
+              #   p result
+              #
               def mac_verify request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2759,6 +3207,22 @@ module Google
               # @return [::Google::Cloud::Kms::V1::GenerateRandomBytesResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/kms/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Kms::V1::KeyManagementService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Kms::V1::GenerateRandomBytesRequest.new
+              #
+              #   # Call the generate_random_bytes method.
+              #   result = client.generate_random_bytes request
+              #
+              #   # The returned object is of type Google::Cloud::Kms::V1::GenerateRandomBytesResponse.
+              #   p result
+              #
               def generate_random_bytes request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/kms/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Kms
       module V1
-        VERSION = "0.22.0"
+        VERSION = "0.23.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

data/proto_docs/google/cloud/kms/v1/resources.rb

@@ -386,11 +386,11 @@ module Google
           # {::Google::Cloud::Kms::V1::CryptoKey#purpose CryptoKey.purpose}
           # {::Google::Cloud::Kms::V1::CryptoKey::CryptoKeyPurpose::ENCRYPT_DECRYPT ENCRYPT_DECRYPT}.
           #
-          # Algorithms beginning with "RSA_SIGN_" are usable with
+          # Algorithms beginning with `RSA_SIGN_` are usable with
           # {::Google::Cloud::Kms::V1::CryptoKey#purpose CryptoKey.purpose}
           # {::Google::Cloud::Kms::V1::CryptoKey::CryptoKeyPurpose::ASYMMETRIC_SIGN ASYMMETRIC_SIGN}.
           #
-          # The fields in the name after "RSA_SIGN_" correspond to the following
+          # The fields in the name after `RSA_SIGN_` correspond to the following
           # parameters: padding algorithm, modulus bit length, and digest algorithm.
           #
           # For PSS, the salt length used is equal to the length of digest
@@ -398,25 +398,25 @@ module Google
           # {::Google::Cloud::Kms::V1::CryptoKeyVersion::CryptoKeyVersionAlgorithm::RSA_SIGN_PSS_2048_SHA256 RSA_SIGN_PSS_2048_SHA256}
           # will use PSS with a salt length of 256 bits or 32 bytes.
           #
-          # Algorithms beginning with "RSA_DECRYPT_" are usable with
+          # Algorithms beginning with `RSA_DECRYPT_` are usable with
           # {::Google::Cloud::Kms::V1::CryptoKey#purpose CryptoKey.purpose}
           # {::Google::Cloud::Kms::V1::CryptoKey::CryptoKeyPurpose::ASYMMETRIC_DECRYPT ASYMMETRIC_DECRYPT}.
           #
-          # The fields in the name after "RSA_DECRYPT_" correspond to the following
+          # The fields in the name after `RSA_DECRYPT_` correspond to the following
           # parameters: padding algorithm, modulus bit length, and digest algorithm.
           #
-          # Algorithms beginning with "EC_SIGN_" are usable with
+          # Algorithms beginning with `EC_SIGN_` are usable with
           # {::Google::Cloud::Kms::V1::CryptoKey#purpose CryptoKey.purpose}
           # {::Google::Cloud::Kms::V1::CryptoKey::CryptoKeyPurpose::ASYMMETRIC_SIGN ASYMMETRIC_SIGN}.
           #
-          # The fields in the name after "EC_SIGN_" correspond to the following
+          # The fields in the name after `EC_SIGN_` correspond to the following
           # parameters: elliptic curve, digest algorithm.
           #
-          # Algorithms beginning with "HMAC_" are usable with
+          # Algorithms beginning with `HMAC_` are usable with
           # {::Google::Cloud::Kms::V1::CryptoKey#purpose CryptoKey.purpose}
           # {::Google::Cloud::Kms::V1::CryptoKey::CryptoKeyPurpose::MAC MAC}.
           #
-          # The suffix following "HMAC_" corresponds to the hash algorithm being used
+          # The suffix following `HMAC_` corresponds to the hash algorithm being used
           # (eg. SHA256).
           #
           # For more information, see [Key purposes and algorithms]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-kms-v1
 version: !ruby/object:Gem::Version
-  version: 0.22.0
+  version: 0.23.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-25 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
@@ -270,7 +270,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: Manages keys and performs cryptographic operations in a central cloud service,