google-cloud-kms-v1 1.2.1 → 1.3.1

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

@@ -287,15 +287,27 @@ module Google
                   endpoint: @config.endpoint,
                   endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
                   universe_domain: @config.universe_domain,
-                  credentials: credentials
+                  credentials: credentials,
+                  logger: @config.logger
                 )
 
+                @key_management_service_stub.logger(stub: true)&.info do |entry|
+                  entry.set_system_name
+                  entry.set_service
+                  entry.message = "Created client for #{entry.service}"
+                  entry.set_credentials_fields credentials
+                  entry.set "customEndpoint", @config.endpoint if @config.endpoint
+                  entry.set "defaultTimeout", @config.timeout if @config.timeout
+                  entry.set "quotaProject", @quota_project_id if @quota_project_id
+                end
+
                 @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
                   config.credentials = credentials
                   config.quota_project = @quota_project_id
                   config.endpoint = @key_management_service_stub.endpoint
                   config.universe_domain = @key_management_service_stub.universe_domain
                   config.bindings_override = @config.bindings_override
+                  config.logger = @key_management_service_stub.logger if config.respond_to? :logger=
                 end
 
                 @iam_policy_client = Google::Iam::V1::IAMPolicy::Rest::Client.new do |config|
@@ -304,6 +316,7 @@ module Google
                   config.endpoint = @key_management_service_stub.endpoint
                   config.universe_domain = @key_management_service_stub.universe_domain
                   config.bindings_override = @config.bindings_override
+                  config.logger = @key_management_service_stub.logger if config.respond_to? :logger=
                 end
               end
 
@@ -321,6 +334,15 @@ module Google
               #
               attr_reader :iam_policy_client
 
+              ##
+              # The logger used for request/response debug logging.
+              #
+              # @return [Logger]
+              #
+              def logger
+                @key_management_service_stub.logger
+              end
+
               # Service calls
 
               ##
@@ -424,7 +446,7 @@ module Google
                 @key_management_service_stub.list_key_rings request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @key_management_service_stub, :list_key_rings, "key_rings", request, result, options
                   yield result, operation if block_given?
-                  return result
+                  throw :response, result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -532,7 +554,7 @@ module Google
                 @key_management_service_stub.list_crypto_keys request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @key_management_service_stub, :list_crypto_keys, "crypto_keys", request, result, options
                   yield result, operation if block_given?
-                  return result
+                  throw :response, result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -641,7 +663,7 @@ module Google
                 @key_management_service_stub.list_crypto_key_versions request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @key_management_service_stub, :list_crypto_key_versions, "crypto_key_versions", request, result, options
                   yield result, operation if block_given?
-                  return result
+                  throw :response, result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -747,7 +769,7 @@ module Google
                 @key_management_service_stub.list_import_jobs request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @key_management_service_stub, :list_import_jobs, "import_jobs", request, result, options
                   yield result, operation if block_given?
-                  return result
+                  throw :response, result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -827,7 +849,6 @@ module Google
 
                 @key_management_service_stub.get_key_ring request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -909,7 +930,6 @@ module Google
 
                 @key_management_service_stub.get_crypto_key request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -990,7 +1010,6 @@ module Google
 
                 @key_management_service_stub.get_crypto_key_version request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -1075,7 +1094,6 @@ module Google
 
                 @key_management_service_stub.get_public_key request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -1155,7 +1173,6 @@ module Google
 
                 @key_management_service_stub.get_import_job request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -1243,7 +1260,6 @@ module Google
 
                 @key_management_service_stub.create_key_ring request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -1343,7 +1359,6 @@ module Google
 
                 @key_management_service_stub.create_crypto_key request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -1432,7 +1447,6 @@ module Google
 
                 @key_management_service_stub.create_crypto_key_version request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -1482,7 +1496,9 @@ module Google
               #     {::Google::Cloud::Kms::V1::CryptoKeyVersion CryptoKeyVersion}, the
               #     {::Google::Cloud::Kms::V1::CryptoKeyVersion CryptoKeyVersion} must be a child of
               #     {::Google::Cloud::Kms::V1::ImportCryptoKeyVersionRequest#parent ImportCryptoKeyVersionRequest.parent},
-              #     have been previously created via [ImportCryptoKeyVersion][], and be in
+              #     have been previously created via
+              #     {::Google::Cloud::Kms::V1::KeyManagementService::Rest::Client#import_crypto_key_version ImportCryptoKeyVersion},
+              #     and be in
               #     {::Google::Cloud::Kms::V1::CryptoKeyVersion::CryptoKeyVersionState::DESTROYED DESTROYED}
               #     or
               #     {::Google::Cloud::Kms::V1::CryptoKeyVersion::CryptoKeyVersionState::IMPORT_FAILED IMPORT_FAILED}
@@ -1598,7 +1614,6 @@ module Google
 
                 @key_management_service_stub.import_crypto_key_version request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -1689,7 +1704,6 @@ module Google
 
                 @key_management_service_stub.create_import_job request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -1770,7 +1784,6 @@ module Google
 
                 @key_management_service_stub.update_crypto_key request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -1863,7 +1876,6 @@ module Google
 
                 @key_management_service_stub.update_crypto_key_version request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -1951,7 +1963,6 @@ module Google
 
                 @key_management_service_stub.update_crypto_key_primary_version request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -2051,7 +2062,6 @@ module Google
 
                 @key_management_service_stub.destroy_crypto_key_version request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -2139,7 +2149,6 @@ module Google
 
                 @key_management_service_stub.restore_crypto_key_version request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -2293,7 +2302,6 @@ module Google
 
                 @key_management_service_stub.encrypt request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -2423,7 +2431,6 @@ module Google
 
                 @key_management_service_stub.decrypt request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -2590,7 +2597,6 @@ module Google
 
                 @key_management_service_stub.raw_encrypt request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -2737,7 +2743,6 @@ module Google
 
                 @key_management_service_stub.raw_decrypt request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -2875,7 +2880,6 @@ module Google
 
                 @key_management_service_stub.asymmetric_sign request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -2984,7 +2988,6 @@ module Google
 
                 @key_management_service_stub.asymmetric_decrypt request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -3088,7 +3091,6 @@ module Google
 
                 @key_management_service_stub.mac_sign request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -3153,7 +3155,8 @@ module Google
               #     checksum. {::Google::Cloud::Kms::V1::KeyManagementService::Rest::Client KeyManagementService}
               #     will report an error if the checksum verification fails. If you receive a
               #     checksum error, your client should verify that
-              #     CRC32C([MacVerifyRequest.tag][]) is equal to
+              #     CRC32C({::Google::Cloud::Kms::V1::MacVerifyRequest#mac MacVerifyRequest.mac}) is
+              #     equal to
               #     {::Google::Cloud::Kms::V1::MacVerifyRequest#mac_crc32c MacVerifyRequest.mac_crc32c},
               #     and if so, perform a limited number of retries. A persistent mismatch may
               #     indicate an issue in your computation of the CRC32C checksum. Note: This
@@ -3214,7 +3217,6 @@ module Google
 
                 @key_management_service_stub.mac_verify request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -3303,7 +3305,6 @@ module Google
 
                 @key_management_service_stub.generate_random_bytes request, options do |result, operation|
                   yield result, operation if block_given?
-                  return result
                 end
               rescue ::Gapic::Rest::Error => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -3383,6 +3384,11 @@ module Google
               #   default endpoint URL. The default value of nil uses the environment
               #   universe (usually the default "googleapis.com" universe).
               #   @return [::String,nil]
+              # @!attribute [rw] logger
+              #   A custom logger to use for request/response debug logging, or the value
+              #   `:default` (the default) to construct a default logger, or `nil` to
+              #   explicitly disable logging.
+              #   @return [::Logger,:default,nil]
               #
               class Configuration
                 extend ::Gapic::Config
@@ -3411,6 +3417,7 @@ module Google
                 # by the host service.
                 # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
                 config_attr :bindings_override, {}, ::Hash, nil
+                config_attr :logger, :default, ::Logger, nil, :default
 
                 # @private
                 def initialize parent_config = nil