google-cloud-spanner-admin-instance-v1 1.3.0 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c12a23a53590ba4b88196b0e358b59623c2f9d7c00290540ddaf9e26ed94c43
-  data.tar.gz: dade9c8f576e31c8f36d4bfc55f7b55cbd781dda356c8d7496235a49fc0a7333
+  metadata.gz: ffefb9b2f53566b7a1daf8189189bf0d48be02a21bb0c874edea7fadc2b97ff2
+  data.tar.gz: 439a5e7ddaf7359a7fdaaa27aa20eef8ba06ef20891f14f80c20326e963c143b
 SHA512:
-  metadata.gz: b43d70df84753c1db2cb98eccbb9e6a99080a9509d772c3fe84e65443c26df24fccec3b34e79b1cea42fe8cedd791550050574f42f00acefc0399bd84e6118a0
-  data.tar.gz: 640a6733f2c82e84bb49fb9f62ccc79b079c944f5377ba105164d717b80384aaa3379548f6b017fce29f77cea36e80dd53ec6a46776a9167061d238af18137a4
+  metadata.gz: 0c7d87f03197e14aed4c8c5981c2523a393098247ef4c24cbdb195cf7390712c5232018e4250f6a3e5ce7bb09ab43b245c1073d14976a3f8b73167a39cd31e69
+  data.tar.gz: 8d3e5952aa56fdbe787dd2dafe814baea4c538aa9c8e32adbe147780e09a6121a3547efdf4df3a060147b343643840e24af996bb8219b8dd2f011c8e0904ad58

data/README.md

@@ -43,33 +43,43 @@ for class and method documentation.
 See also the [Product Documentation](https://cloud.google.com/spanner)
 for general usage information.
 
-## Enabling Logging
-
-To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
-The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
-or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
-that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
-and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
-
-Configuring a Ruby stdlib logger:
+## Debug Logging
+
+This library comes with opt-in Debug Logging that can help you troubleshoot
+your application's integration with the API. When logging is activated, key
+events such as requests and responses, along with data payloads and metadata
+such as headers and client configuration, are logged to the standard error
+stream.
+
+**WARNING:** Client Library Debug Logging includes your data payloads in
+plaintext, which could include sensitive data such as PII for yourself or your
+customers, private keys, or other security data that could be compromising if
+leaked. Always practice good data hygiene with your application logs, and follow
+the principle of least access. Google also recommends that Client Library Debug
+Logging be enabled only temporarily during active debugging, and not used
+permanently in production.
+
+To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
+to the value `all`. Alternatively, you can set the value to a comma-delimited
+list of client library gem names. This will select the default logging behavior,
+which writes logs to the standard error stream. On a local workstation, this may
+result in logs appearing on the console. When running on a Google Cloud hosting
+service such as [Google Cloud Run](https://cloud.google.com/run), this generally
+results in logs appearing alongside your application logs in the
+[Google Cloud Logging](https://cloud.google.com/logging/) service.
+
+You can customize logging by modifying the `logger` configuration when
+constructing a client object. For example:
 
 ```ruby
+require "google/cloud/spanner/admin/instance/v1"
 require "logger"
 
-module MyLogger
-  LOGGER = Logger.new $stderr, level: Logger::WARN
-  def logger
-    LOGGER
-  end
-end
-
-# Define a gRPC module-level logger method before grpc/logconfig.rb loads.
-module GRPC
-  extend MyLogger
+client = ::Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdmin::Client.new do |config|
+  config.logger = Logger.new "my-app.log"
 end
 ```
 
-
 ## Google Cloud Samples
 
 To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).

data/lib/google/cloud/spanner/admin/instance/v1/instance_admin/client.rb

@@ -224,8 +224,19 @@ module Google
                     universe_domain: @config.universe_domain,
                     channel_args: @config.channel_args,
                     interceptors: @config.interceptors,
-                    channel_pool_config: @config.channel_pool
+                    channel_pool_config: @config.channel_pool,
+                    logger: @config.logger
                   )
+
+                  @instance_admin_stub.stub_logger&.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
                 end
 
                 ##
@@ -235,11 +246,23 @@ module Google
                 #
                 attr_reader :operations_client
 
+                ##
+                # The logger used for request/response debug logging.
+                #
+                # @return [Logger]
+                #
+                def logger
+                  @instance_admin_stub.logger
+                end
+
                 # Service calls
 
                 ##
                 # Lists the supported instance configurations for a given project.
                 #
+                # Returns both Google-managed configurations and user-managed
+                # configurations.
+                #
                 # @overload list_instance_configs(request, options = nil)
                 #   Pass arguments to `list_instance_configs` via a request object, either of type
                 #   {::Google::Cloud::Spanner::Admin::Instance::V1::ListInstanceConfigsRequest} or an equivalent Hash.
@@ -332,7 +355,7 @@ module Google
                   @instance_admin_stub.call_rpc :list_instance_configs, request, options: options do |response, operation|
                     response = ::Gapic::PagedEnumerable.new @instance_admin_stub, :list_instance_configs, request, response, operation, options
                     yield response, operation if block_given?
-                    return response
+                    throw :response, response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -419,7 +442,6 @@ module Google
 
                   @instance_admin_stub.call_rpc :get_instance_config, request, options: options do |response, operation|
                     yield response, operation if block_given?
-                    return response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -427,7 +449,7 @@ module Google
 
                 ##
                 # Creates an instance configuration and begins preparing it to be used. The
-                # returned {::Google::Longrunning::Operation long-running operation}
+                # returned long-running operation
                 # can be used to track the progress of preparing the new
                 # instance configuration. The instance configuration name is assigned by the
                 # caller. If the named instance configuration already exists,
@@ -454,13 +476,13 @@ module Google
                 #   {::Google::Cloud::Spanner::Admin::Instance::V1::InstanceConfig#reconciling reconciling}
                 #   field becomes false. Its state becomes `READY`.
                 #
-                # The returned {::Google::Longrunning::Operation long-running operation} will
+                # The returned long-running operation will
                 # have a name of the format
                 # `<instance_config_name>/operations/<operation_id>` and can be used to track
                 # creation of the instance configuration. The
-                # {::Google::Longrunning::Operation#metadata metadata} field type is
+                # metadata field type is
                 # {::Google::Cloud::Spanner::Admin::Instance::V1::CreateInstanceConfigMetadata CreateInstanceConfigMetadata}.
-                # The {::Google::Longrunning::Operation#response response} field type is
+                # The response field type is
                 # {::Google::Cloud::Spanner::Admin::Instance::V1::InstanceConfig InstanceConfig}, if
                 # successful.
                 #
@@ -492,10 +514,10 @@ module Google
                 #     characters in length. The `custom-` prefix is required to avoid name
                 #     conflicts with Google-managed configurations.
                 #   @param instance_config [::Google::Cloud::Spanner::Admin::Instance::V1::InstanceConfig, ::Hash]
-                #     Required. The InstanceConfig proto of the configuration to create.
-                #     instance_config.name must be
+                #     Required. The `InstanceConfig` proto of the configuration to create.
+                #     `instance_config.name` must be
                 #     `<parent>/instanceConfigs/<instance_config_id>`.
-                #     instance_config.base_config must be a Google managed configuration name,
+                #     `instance_config.base_config` must be a Google-managed configuration name,
                 #     e.g. <parent>/instanceConfigs/us-east1, <parent>/instanceConfigs/nam3.
                 #   @param validate_only [::Boolean]
                 #     An option to validate, but not actually execute, a request,
@@ -568,7 +590,7 @@ module Google
                   @instance_admin_stub.call_rpc :create_instance_config, request, options: options do |response, operation|
                     response = ::Gapic::Operation.new response, @operations_client, options: options
                     yield response, operation if block_given?
-                    return response
+                    throw :response, response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -576,7 +598,7 @@ module Google
 
                 ##
                 # Updates an instance configuration. The returned
-                # {::Google::Longrunning::Operation long-running operation} can be used to track
+                # long-running operation can be used to track
                 # the progress of updating the instance. If the named instance configuration
                 # does not exist, returns `NOT_FOUND`.
                 #
@@ -607,13 +629,13 @@ module Google
                 #   {::Google::Cloud::Spanner::Admin::Instance::V1::InstanceConfig#reconciling reconciling}
                 #   field becomes false.
                 #
-                # The returned {::Google::Longrunning::Operation long-running operation} will
+                # The returned long-running operation will
                 # have a name of the format
                 # `<instance_config_name>/operations/<operation_id>` and can be used to track
                 # the instance configuration modification.  The
-                # {::Google::Longrunning::Operation#metadata metadata} field type is
+                # metadata field type is
                 # {::Google::Cloud::Spanner::Admin::Instance::V1::UpdateInstanceConfigMetadata UpdateInstanceConfigMetadata}.
-                # The {::Google::Longrunning::Operation#response response} field type is
+                # The response field type is
                 # {::Google::Cloud::Spanner::Admin::Instance::V1::InstanceConfig InstanceConfig}, if
                 # successful.
                 #
@@ -721,7 +743,7 @@ module Google
                   @instance_admin_stub.call_rpc :update_instance_config, request, options: options do |response, operation|
                     response = ::Gapic::Operation.new response, @operations_client, options: options
                     yield response, operation if block_given?
-                    return response
+                    throw :response, response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -827,19 +849,18 @@ module Google
 
                   @instance_admin_stub.call_rpc :delete_instance_config, request, options: options do |response, operation|
                     yield response, operation if block_given?
-                    return response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
                 end
 
                 ##
-                # Lists the user-managed instance configuration [long-running
-                # operations][google.longrunning.Operation] in the given project. An instance
+                # Lists the user-managed instance configuration long-running
+                # operations in the given project. An instance
                 # configuration operation has a name of the form
                 # `projects/<project>/instanceConfigs/<instance_config>/operations/<operation>`.
                 # The long-running operation
-                # {::Google::Longrunning::Operation#metadata metadata} field type
+                # metadata field type
                 # `metadata.type_url` describes the type of the metadata. Operations returned
                 # include those that have completed/failed/canceled within the last 7 days,
                 # and pending operations. Operations returned are ordered by
@@ -873,8 +894,7 @@ module Google
                 #     must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`.
                 #     Colon `:` is the contains operator. Filter rules are not case sensitive.
                 #
-                #     The following fields in the {::Google::Longrunning::Operation Operation}
-                #     are eligible for filtering:
+                #     The following fields in the Operation are eligible for filtering:
                 #
                 #       * `name` - The name of the long-running operation
                 #       * `done` - False if the operation is in progress, else true.
@@ -983,7 +1003,7 @@ module Google
                     wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
                     response = ::Gapic::PagedEnumerable.new @instance_admin_stub, :list_instance_config_operations, request, response, operation, options, format_resource: wrap_lro_operation
                     yield response, operation if block_given?
-                    return response
+                    throw :response, response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -1110,7 +1130,7 @@ module Google
                   @instance_admin_stub.call_rpc :list_instances, request, options: options do |response, operation|
                     response = ::Gapic::PagedEnumerable.new @instance_admin_stub, :list_instances, request, response, operation, options
                     yield response, operation if block_given?
-                    return response
+                    throw :response, response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -1136,7 +1156,9 @@ module Google
                 #
                 #   @param parent [::String]
                 #     Required. The instance whose instance partitions should be listed. Values
-                #     are of the form `projects/<project>/instances/<instance>`.
+                #     are of the form `projects/<project>/instances/<instance>`. Use `{instance}
+                #     = '-'` to list instance partitions for all Instances in a project, e.g.,
+                #     `projects/myproject/instances/-`.
                 #   @param page_size [::Integer]
                 #     Number of instance partitions to be returned in the response. If 0 or less,
                 #     defaults to the server's maximum allowed page size.
@@ -1217,7 +1239,7 @@ module Google
                   @instance_admin_stub.call_rpc :list_instance_partitions, request, options: options do |response, operation|
                     response = ::Gapic::PagedEnumerable.new @instance_admin_stub, :list_instance_partitions, request, response, operation, options
                     yield response, operation if block_given?
-                    return response
+                    throw :response, response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -1309,7 +1331,6 @@ module Google
 
                   @instance_admin_stub.call_rpc :get_instance, request, options: options do |response, operation|
                     yield response, operation if block_given?
-                    return response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -1317,7 +1338,7 @@ module Google
 
                 ##
                 # Creates an instance and begins preparing it to begin serving. The
-                # returned {::Google::Longrunning::Operation long-running operation}
+                # returned long-running operation
                 # can be used to track the progress of preparing the new
                 # instance. The instance name is assigned by the caller. If the
                 # named instance already exists, `CreateInstance` returns
@@ -1343,12 +1364,12 @@ module Google
                 #   * The instance's allocated resource levels are readable via the API.
                 #   * The instance's state becomes `READY`.
                 #
-                # The returned {::Google::Longrunning::Operation long-running operation} will
+                # The returned long-running operation will
                 # have a name of the format `<instance_name>/operations/<operation_id>` and
                 # can be used to track creation of the instance.  The
-                # {::Google::Longrunning::Operation#metadata metadata} field type is
+                # metadata field type is
                 # {::Google::Cloud::Spanner::Admin::Instance::V1::CreateInstanceMetadata CreateInstanceMetadata}.
-                # The {::Google::Longrunning::Operation#response response} field type is
+                # The response field type is
                 # {::Google::Cloud::Spanner::Admin::Instance::V1::Instance Instance}, if successful.
                 #
                 # @overload create_instance(request, options = nil)
@@ -1444,7 +1465,7 @@ module Google
                   @instance_admin_stub.call_rpc :create_instance, request, options: options do |response, operation|
                     response = ::Gapic::Operation.new response, @operations_client, options: options
                     yield response, operation if block_given?
-                    return response
+                    throw :response, response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -1452,8 +1473,7 @@ module Google
 
                 ##
                 # Updates an instance, and begins allocating or releasing resources
-                # as requested. The returned [long-running
-                # operation][google.longrunning.Operation] can be used to track the
+                # as requested. The returned long-running operation can be used to track the
                 # progress of updating the instance. If the named instance does not
                 # exist, returns `NOT_FOUND`.
                 #
@@ -1481,12 +1501,12 @@ module Google
                 #     tables.
                 #   * The instance's new resource levels are readable via the API.
                 #
-                # The returned {::Google::Longrunning::Operation long-running operation} will
+                # The returned long-running operation will
                 # have a name of the format `<instance_name>/operations/<operation_id>` and
                 # can be used to track the instance modification.  The
-                # {::Google::Longrunning::Operation#metadata metadata} field type is
+                # metadata field type is
                 # {::Google::Cloud::Spanner::Admin::Instance::V1::UpdateInstanceMetadata UpdateInstanceMetadata}.
-                # The {::Google::Longrunning::Operation#response response} field type is
+                # The response field type is
                 # {::Google::Cloud::Spanner::Admin::Instance::V1::Instance Instance}, if successful.
                 #
                 # Authorization requires `spanner.instances.update` permission on
@@ -1586,7 +1606,7 @@ module Google
                   @instance_admin_stub.call_rpc :update_instance, request, options: options do |response, operation|
                     response = ::Gapic::Operation.new response, @operations_client, options: options
                     yield response, operation if block_given?
-                    return response
+                    throw :response, response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -1683,7 +1703,6 @@ module Google
 
                   @instance_admin_stub.call_rpc :delete_instance, request, options: options do |response, operation|
                     yield response, operation if block_given?
-                    return response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -1785,7 +1804,6 @@ module Google
 
                   @instance_admin_stub.call_rpc :set_iam_policy, request, options: options do |response, operation|
                     yield response, operation if block_given?
-                    return response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -1879,7 +1897,6 @@ module Google
 
                   @instance_admin_stub.call_rpc :get_iam_policy, request, options: options do |response, operation|
                     yield response, operation if block_given?
-                    return response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -1976,7 +1993,6 @@ module Google
 
                   @instance_admin_stub.call_rpc :test_iam_permissions, request, options: options do |response, operation|
                     yield response, operation if block_given?
-                    return response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -2064,7 +2080,6 @@ module Google
 
                   @instance_admin_stub.call_rpc :get_instance_partition, request, options: options do |response, operation|
                     yield response, operation if block_given?
-                    return response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -2072,7 +2087,7 @@ module Google
 
                 ##
                 # Creates an instance partition and begins preparing it to be used. The
-                # returned {::Google::Longrunning::Operation long-running operation}
+                # returned long-running operation
                 # can be used to track the progress of preparing the new instance partition.
                 # The instance partition name is assigned by the caller. If the named
                 # instance partition already exists, `CreateInstancePartition` returns
@@ -2099,13 +2114,13 @@ module Google
                 #     API.
                 #   * The instance partition's state becomes `READY`.
                 #
-                # The returned {::Google::Longrunning::Operation long-running operation} will
+                # The returned long-running operation will
                 # have a name of the format
                 # `<instance_partition_name>/operations/<operation_id>` and can be used to
                 # track creation of the instance partition.  The
-                # {::Google::Longrunning::Operation#metadata metadata} field type is
+                # metadata field type is
                 # {::Google::Cloud::Spanner::Admin::Instance::V1::CreateInstancePartitionMetadata CreateInstancePartitionMetadata}.
-                # The {::Google::Longrunning::Operation#response response} field type is
+                # The response field type is
                 # {::Google::Cloud::Spanner::Admin::Instance::V1::InstancePartition InstancePartition}, if
                 # successful.
                 #
@@ -2204,7 +2219,7 @@ module Google
                   @instance_admin_stub.call_rpc :create_instance_partition, request, options: options do |response, operation|
                     response = ::Gapic::Operation.new response, @operations_client, options: options
                     yield response, operation if block_given?
-                    return response
+                    throw :response, response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -2303,7 +2318,6 @@ module Google
 
                   @instance_admin_stub.call_rpc :delete_instance_partition, request, options: options do |response, operation|
                     yield response, operation if block_given?
-                    return response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -2311,8 +2325,7 @@ module Google
 
                 ##
                 # Updates an instance partition, and begins allocating or releasing resources
-                # as requested. The returned [long-running
-                # operation][google.longrunning.Operation] can be used to track the
+                # as requested. The returned long-running operation can be used to track the
                 # progress of updating the instance partition. If the named instance
                 # partition does not exist, returns `NOT_FOUND`.
                 #
@@ -2341,13 +2354,13 @@ module Google
                 #     partition's tables.
                 #   * The instance partition's new resource levels are readable via the API.
                 #
-                # The returned {::Google::Longrunning::Operation long-running operation} will
+                # The returned long-running operation will
                 # have a name of the format
                 # `<instance_partition_name>/operations/<operation_id>` and can be used to
                 # track the instance partition modification. The
-                # {::Google::Longrunning::Operation#metadata metadata} field type is
+                # metadata field type is
                 # {::Google::Cloud::Spanner::Admin::Instance::V1::UpdateInstancePartitionMetadata UpdateInstancePartitionMetadata}.
-                # The {::Google::Longrunning::Operation#response response} field type is
+                # The response field type is
                 # {::Google::Cloud::Spanner::Admin::Instance::V1::InstancePartition InstancePartition}, if
                 # successful.
                 #
@@ -2450,19 +2463,18 @@ module Google
                   @instance_admin_stub.call_rpc :update_instance_partition, request, options: options do |response, operation|
                     response = ::Gapic::Operation.new response, @operations_client, options: options
                     yield response, operation if block_given?
-                    return response
+                    throw :response, response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
                 end
 
                 ##
-                # Lists instance partition [long-running
-                # operations][google.longrunning.Operation] in the given instance.
+                # Lists instance partition long-running operations in the given instance.
                 # An instance partition operation has a name of the form
                 # `projects/<project>/instances/<instance>/instancePartitions/<instance_partition>/operations/<operation>`.
                 # The long-running operation
-                # {::Google::Longrunning::Operation#metadata metadata} field type
+                # metadata field type
                 # `metadata.type_url` describes the type of the metadata. Operations returned
                 # include those that have completed/failed/canceled within the last 7 days,
                 # and pending operations. Operations returned are ordered by
@@ -2500,8 +2512,7 @@ module Google
                 #     must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`.
                 #     Colon `:` is the contains operator. Filter rules are not case sensitive.
                 #
-                #     The following fields in the {::Google::Longrunning::Operation Operation}
-                #     are eligible for filtering:
+                #     The following fields in the Operation are eligible for filtering:
                 #
                 #       * `name` - The name of the long-running operation
                 #       * `done` - False if the operation is in progress, else true.
@@ -2548,7 +2559,8 @@ module Google
                 #     Optional. Deadline used while retrieving metadata for instance partition
                 #     operations. Instance partitions whose operation metadata cannot be
                 #     retrieved within this deadline will be added to
-                #     [unreachable][ListInstancePartitionOperationsResponse.unreachable] in
+                #     {::Google::Cloud::Spanner::Admin::Instance::V1::ListInstancePartitionOperationsResponse#unreachable_instance_partitions unreachable_instance_partitions}
+                #     in
                 #     {::Google::Cloud::Spanner::Admin::Instance::V1::ListInstancePartitionOperationsResponse ListInstancePartitionOperationsResponse}.
                 #
                 # @yield [response, operation] Access the result along with the RPC operation
@@ -2616,7 +2628,7 @@ module Google
                     wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
                     response = ::Gapic::PagedEnumerable.new @instance_admin_stub, :list_instance_partition_operations, request, response, operation, options, format_resource: wrap_lro_operation
                     yield response, operation if block_given?
-                    return response
+                    throw :response, response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -2624,7 +2636,7 @@ module Google
 
                 ##
                 # Moves an instance to the target instance configuration. You can use the
-                # returned {::Google::Longrunning::Operation long-running operation} to track
+                # returned long-running operation to track
                 # the progress of moving the instance.
                 #
                 # `MoveInstance` returns `FAILED_PRECONDITION` if the instance meets any of
@@ -2655,13 +2667,13 @@ module Google
                 #     transaction abort rate. However, moving an instance doesn't cause any
                 #     downtime.
                 #
-                # The returned {::Google::Longrunning::Operation long-running operation} has
+                # The returned long-running operation has
                 # a name of the format
                 # `<instance_name>/operations/<operation_id>` and can be used to track
                 # the move instance operation. The
-                # {::Google::Longrunning::Operation#metadata metadata} field type is
+                # metadata field type is
                 # {::Google::Cloud::Spanner::Admin::Instance::V1::MoveInstanceMetadata MoveInstanceMetadata}.
-                # The {::Google::Longrunning::Operation#response response} field type is
+                # The response field type is
                 # {::Google::Cloud::Spanner::Admin::Instance::V1::Instance Instance},
                 # if successful.
                 # Cancelling the operation sets its metadata's
@@ -2774,7 +2786,7 @@ module Google
                   @instance_admin_stub.call_rpc :move_instance, request, options: options do |response, operation|
                     response = ::Gapic::Operation.new response, @operations_client, options: options
                     yield response, operation if block_given?
-                    return response
+                    throw :response, response
                   end
                 rescue ::GRPC::BadStatus => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -2863,6 +2875,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
@@ -2887,6 +2904,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