google-cloud-kms-v1 0.22.1 → 0.24.0

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

@@ -45,6 +45,9 @@ module Google
             # [Using gRPC with Cloud KMS](https://cloud.google.com/kms/docs/grpc).
             #
             class Client
+              # @private
+              DEFAULT_ENDPOINT_TEMPLATE = "cloudkms.$UNIVERSE_DOMAIN$"
+
               include Paths
 
               # @private
@@ -229,6 +232,15 @@ module Google
                 @config
               end
 
+              ##
+              # The effective universe domain
+              #
+              # @return [String]
+              #
+              def universe_domain
+                @key_management_service_stub.universe_domain
+              end
+
               ##
               # Create a new KeyManagementService REST client object.
               #
@@ -256,8 +268,9 @@ module Google
                 credentials = @config.credentials
                 # Use self-signed JWT if the endpoint is unchanged from default,
                 # but only if the default endpoint does not have a region prefix.
-                enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
-                                         !@config.endpoint.split(".").first.include?("-")
+                enable_self_signed_jwt = @config.endpoint.nil? ||
+                                         (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
+                                         !@config.endpoint.split(".").first.include?("-"))
                 credentials ||= Credentials.default scope: @config.scope,
                                                     enable_self_signed_jwt: enable_self_signed_jwt
                 if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -271,6 +284,7 @@ module Google
                   config.credentials = credentials
                   config.quota_project = @quota_project_id
                   config.endpoint = @config.endpoint
+                  config.universe_domain = @config.universe_domain
                   config.bindings_override = @config.bindings_override
                 end
 
@@ -278,10 +292,16 @@ module Google
                   config.credentials = credentials
                   config.quota_project = @quota_project_id
                   config.endpoint = @config.endpoint
+                  config.universe_domain = @config.universe_domain
                   config.bindings_override = @config.bindings_override
                 end
 
-                @key_management_service_stub = ::Google::Cloud::Kms::V1::KeyManagementService::Rest::ServiceStub.new endpoint: @config.endpoint, credentials: credentials
+                @key_management_service_stub = ::Google::Cloud::Kms::V1::KeyManagementService::Rest::ServiceStub.new(
+                  endpoint: @config.endpoint,
+                  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
+                  universe_domain: @config.universe_domain,
+                  credentials: credentials
+                )
               end
 
               ##
@@ -350,6 +370,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 +477,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 +585,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 +690,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 +774,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 +855,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 +935,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 +1019,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 +1098,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 +1185,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 +1284,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 +1372,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 +1537,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 +1627,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 +1707,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 +1799,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 +1886,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 +1985,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 +2072,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 +2225,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 +2354,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 +2520,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 +2666,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 +2803,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 +2911,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 +3014,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 +3139,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 +3227,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?
 
@@ -2824,9 +3308,9 @@ module Google
               #   end
               #
               # @!attribute [rw] endpoint
-              #   The hostname or hostname:port of the service endpoint.
-              #   Defaults to `"cloudkms.googleapis.com"`.
-              #   @return [::String]
+              #   A custom service endpoint, as a hostname or hostname:port. The default is
+              #   nil, indicating to use the default endpoint in the current universe domain.
+              #   @return [::String,nil]
               # @!attribute [rw] credentials
               #   Credentials to send with calls. You may provide any of the following types:
               #    *  (`String`) The path to a service account key file in JSON format
@@ -2863,13 +3347,20 @@ module Google
               # @!attribute [rw] quota_project
               #   A separate project against which to charge quota.
               #   @return [::String]
+              # @!attribute [rw] universe_domain
+              #   The universe domain within which to make requests. This determines the
+              #   default endpoint URL. The default value of nil uses the environment
+              #   universe (usually the default "googleapis.com" universe).
+              #   @return [::String,nil]
               #
               class Configuration
                 extend ::Gapic::Config
 
+                # @private
+                # The endpoint specific to the default "googleapis.com" universe. Deprecated.
                 DEFAULT_ENDPOINT = "cloudkms.googleapis.com"
 
-                config_attr :endpoint,      DEFAULT_ENDPOINT, ::String
+                config_attr :endpoint,      nil, ::String, nil
                 config_attr :credentials,   nil do |value|
                   allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                   allowed.any? { |klass| klass === value }
@@ -2881,6 +3372,7 @@ module Google
                 config_attr :metadata,      nil, ::Hash, nil
                 config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
                 config_attr :quota_project, nil, ::String, nil
+                config_attr :universe_domain, nil, ::String, nil
 
                 # @private
                 # Overrides for http bindings for the RPCs of this service