google-cloud-dlp-v2 1.4.0 → 1.6.0

data/lib/google/cloud/dlp/v2/dlp_service/rest/client.rb

@@ -30,13 +30,9 @@ module Google
             ##
             # REST client for the DlpService service.
             #
-            # The Cloud Data Loss Prevention (DLP) API is a service that allows clients
-            # to detect the presence of Personally Identifiable Information (PII) and other
-            # privacy-sensitive data in user-supplied, unstructured data streams, like text
-            # blocks or images.
-            # The service also includes methods for sensitive data redaction and
-            # scheduling of data scans on Google Cloud Platform based data sets.
-            #
+            # Sensitive Data Protection provides access to a powerful sensitive data
+            # inspection, classification, and de-identification platform that works
+            # on text, images, and Google Cloud storage repositories.
             # To learn more about concepts and find how-to guides see
             # https://cloud.google.com/sensitive-data-protection/docs/.
             #
@@ -351,14 +347,26 @@ module Google
                   endpoint: @config.endpoint,
                   endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
                   universe_domain: @config.universe_domain,
-                  credentials: credentials
+                  credentials: credentials,
+                  logger: @config.logger
                 )
 
+                @dlp_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 = @dlp_service_stub.endpoint
                   config.universe_domain = @dlp_service_stub.universe_domain
+                  config.logger = @dlp_service_stub.logger if config.respond_to? :logger=
                 end
               end
 
@@ -369,6 +377,15 @@ module Google
               #
               attr_reader :location_client
 
+              ##
+              # The logger used for request/response debug logging.
+              #
+              # @return [Logger]
+              #
+              def logger
+                @dlp_service_stub.logger
+              end
+
               # Service calls
 
               ##
@@ -482,7 +499,6 @@ module Google
 
                 @dlp_service_stub.inspect_content 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)
@@ -595,7 +611,6 @@ module Google
 
                 @dlp_service_stub.redact_image 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)
@@ -728,7 +743,6 @@ module Google
 
                 @dlp_service_stub.deidentify_content 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)
@@ -856,7 +870,6 @@ module Google
 
                 @dlp_service_stub.reidentify_content 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)
@@ -951,7 +964,6 @@ module Google
 
                 @dlp_service_stub.list_info_types 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)
@@ -1062,7 +1074,6 @@ module Google
 
                 @dlp_service_stub.create_inspect_template 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)
@@ -1150,7 +1161,6 @@ module Google
 
                 @dlp_service_stub.update_inspect_template 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)
@@ -1234,7 +1244,6 @@ module Google
 
                 @dlp_service_stub.get_inspect_template 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)
@@ -1362,7 +1371,7 @@ module Google
                 @dlp_service_stub.list_inspect_templates request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @dlp_service_stub, :list_inspect_templates, "inspect_templates", 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)
@@ -1446,7 +1455,6 @@ module Google
 
                 @dlp_service_stub.delete_inspect_template 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)
@@ -1557,7 +1565,6 @@ module Google
 
                 @dlp_service_stub.create_deidentify_template 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)
@@ -1646,7 +1653,6 @@ module Google
 
                 @dlp_service_stub.update_deidentify_template 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)
@@ -1730,7 +1736,6 @@ module Google
 
                 @dlp_service_stub.get_deidentify_template 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)
@@ -1858,7 +1863,7 @@ module Google
                 @dlp_service_stub.list_deidentify_templates request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @dlp_service_stub, :list_deidentify_templates, "deidentify_templates", 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)
@@ -1943,7 +1948,6 @@ module Google
 
                 @dlp_service_stub.delete_deidentify_template 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)
@@ -2050,7 +2054,6 @@ module Google
 
                 @dlp_service_stub.create_job_trigger 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)
@@ -2137,7 +2140,6 @@ module Google
 
                 @dlp_service_stub.update_job_trigger 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)
@@ -2221,7 +2223,6 @@ module Google
 
                 @dlp_service_stub.hybrid_inspect_job_trigger 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)
@@ -2304,7 +2305,6 @@ module Google
 
                 @dlp_service_stub.get_job_trigger 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)
@@ -2457,7 +2457,7 @@ module Google
                 @dlp_service_stub.list_job_triggers request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @dlp_service_stub, :list_job_triggers, "job_triggers", 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)
@@ -2540,7 +2540,6 @@ module Google
 
                 @dlp_service_stub.delete_job_trigger 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)
@@ -2621,7 +2620,6 @@ module Google
 
                 @dlp_service_stub.activate_job_trigger 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)
@@ -2721,7 +2719,6 @@ module Google
 
                 @dlp_service_stub.create_discovery_config 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)
@@ -2805,7 +2802,6 @@ module Google
 
                 @dlp_service_stub.update_discovery_config 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)
@@ -2885,7 +2881,6 @@ module Google
 
                 @dlp_service_stub.get_discovery_config 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)
@@ -2997,7 +2992,7 @@ module Google
                 @dlp_service_stub.list_discovery_configs request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @dlp_service_stub, :list_discovery_configs, "discovery_configs", 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)
@@ -3077,7 +3072,6 @@ module Google
 
                 @dlp_service_stub.delete_discovery_config 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)
@@ -3192,7 +3186,6 @@ module Google
 
                 @dlp_service_stub.create_dlp_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)
@@ -3347,7 +3340,7 @@ module Google
                 @dlp_service_stub.list_dlp_jobs request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @dlp_service_stub, :list_dlp_jobs, "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)
@@ -3431,7 +3424,6 @@ module Google
 
                 @dlp_service_stub.get_dlp_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)
@@ -3517,7 +3509,6 @@ module Google
 
                 @dlp_service_stub.delete_dlp_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)
@@ -3603,7 +3594,6 @@ module Google
 
                 @dlp_service_stub.cancel_dlp_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)
@@ -3713,7 +3703,6 @@ module Google
 
                 @dlp_service_stub.create_stored_info_type 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)
@@ -3804,7 +3793,6 @@ module Google
 
                 @dlp_service_stub.update_stored_info_type 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)
@@ -3888,7 +3876,6 @@ module Google
 
                 @dlp_service_stub.get_stored_info_type 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)
@@ -4013,7 +4000,7 @@ module Google
                 @dlp_service_stub.list_stored_info_types request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @dlp_service_stub, :list_stored_info_types, "stored_info_types", 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)
@@ -4097,7 +4084,6 @@ module Google
 
                 @dlp_service_stub.delete_stored_info_type 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)
@@ -4225,7 +4211,7 @@ module Google
                 @dlp_service_stub.list_project_data_profiles request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @dlp_service_stub, :list_project_data_profiles, "project_data_profiles", 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)
@@ -4366,7 +4352,7 @@ module Google
                 @dlp_service_stub.list_table_data_profiles request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @dlp_service_stub, :list_table_data_profiles, "table_data_profiles", 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)
@@ -4509,7 +4495,7 @@ module Google
                 @dlp_service_stub.list_column_data_profiles request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @dlp_service_stub, :list_column_data_profiles, "column_data_profiles", 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)
@@ -4589,7 +4575,6 @@ module Google
 
                 @dlp_service_stub.get_project_data_profile 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)
@@ -4735,7 +4720,7 @@ module Google
                 @dlp_service_stub.list_file_store_data_profiles request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @dlp_service_stub, :list_file_store_data_profiles, "file_store_data_profiles", 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)
@@ -4815,7 +4800,6 @@ module Google
 
                 @dlp_service_stub.get_file_store_data_profile 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)
@@ -4895,7 +4879,6 @@ module Google
 
                 @dlp_service_stub.delete_file_store_data_profile 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)
@@ -4975,7 +4958,6 @@ module Google
 
                 @dlp_service_stub.get_table_data_profile 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)
@@ -5055,7 +5037,6 @@ module Google
 
                 @dlp_service_stub.get_column_data_profile 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)
@@ -5135,7 +5116,6 @@ module Google
 
                 @dlp_service_stub.delete_table_data_profile 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)
@@ -5219,7 +5199,6 @@ module Google
 
                 @dlp_service_stub.hybrid_inspect_dlp_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)
@@ -5299,7 +5278,6 @@ module Google
 
                 @dlp_service_stub.finish_dlp_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)
@@ -5388,7 +5366,6 @@ module Google
 
                 @dlp_service_stub.create_connection 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)
@@ -5468,7 +5445,6 @@ module Google
 
                 @dlp_service_stub.get_connection 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)
@@ -5562,7 +5538,7 @@ module Google
                 @dlp_service_stub.list_connections request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @dlp_service_stub, :list_connections, "connections", 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)
@@ -5655,7 +5631,7 @@ module Google
                 @dlp_service_stub.search_connections request, options do |result, operation|
                   result = ::Gapic::Rest::PagedEnumerable.new @dlp_service_stub, :search_connections, "connections", 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)
@@ -5735,7 +5711,6 @@ module Google
 
                 @dlp_service_stub.delete_connection 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)
@@ -5819,7 +5794,6 @@ module Google
 
                 @dlp_service_stub.update_connection 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)
@@ -5899,6 +5873,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
@@ -5920,6 +5899,7 @@ module Google
                 config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
                 config_attr :quota_project, nil, ::String, nil
                 config_attr :universe_domain, nil, ::String, nil
+                config_attr :logger, :default, ::Logger, nil, :default
 
                 # @private
                 def initialize parent_config = nil