google-cloud-spanner-admin-database-v1 0.12.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0dd7e7bcd60f178f114d0d9bcc20c5677f09c4b3a0e865ef9a4bee0fed39dc91
-  data.tar.gz: 7e0f9a2ef395b8c5713213a979914e51db9631c44bca6cdcb94a9b8f3eca8a4b
+  metadata.gz: a0ccba22ec473311d535a4a9ec4f1d63be050ca80ae187550ad5419b67ed4186
+  data.tar.gz: b9b3b52d6758e734fefb309638b24dec4d0f5d9b778f7ad17fc3ad8d87b5cdde
 SHA512:
-  metadata.gz: c28d6a25a2dff217e9f30cc279a959498de5464545a715aceeda38010552d9cc45d87b7cacbd899ed2ad83fc329a399e46f300f180032ba61a4813c8fdefe1d2
-  data.tar.gz: 88163d15d90874e82b8ce2774fe3d549ff3d87d422e377a3270a8ea44691bcef43235fdcdafdbfed1545474bf28b9ed4dd0d3239b5fd1ede50c5cc04062afa0c
+  metadata.gz: 183dcd7dc9b8cf46f6b0e66576a77f755a42f0ba736462eb8cfc6ffc3b7fa07012c2a1982eb205dc1f97d2faecca6478e23cf680fea63545fd05bdd0d4378700
+  data.tar.gz: 73f6bd6d455658a016a16ed91e53eab5098dc883eae2b5312e90d6b621025b3a7d69171b20eab7bb248eba60e5903cf1f12e3fcafb26590d829c1de9b8f0699f

data/README.md

@@ -47,7 +47,7 @@ for general usage information.
 
 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://googleapis.dev/ruby/google-cloud-logging/latest)
+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.
 

data/lib/google/cloud/spanner/admin/database/v1/database_admin/client.rb

@@ -84,6 +84,11 @@ module Google
                       initial_delay: 1.0, max_delay: 32.0, multiplier: 1.3, retry_codes: [14, 4]
                     }
 
+                    default_config.rpcs.update_database.timeout = 3600.0
+                    default_config.rpcs.update_database.retry_policy = {
+                      initial_delay: 1.0, max_delay: 32.0, multiplier: 1.3, retry_codes: [14, 4]
+                    }
+
                     default_config.rpcs.update_database_ddl.timeout = 3600.0
                     default_config.rpcs.update_database_ddl.retry_policy = {
                       initial_delay: 1.0, max_delay: 32.0, multiplier: 1.3, retry_codes: [14, 4]
@@ -544,6 +549,139 @@ module Google
                   raise ::Google::Cloud::Error.from_error(e)
                 end
 
+                ##
+                # Updates a Cloud Spanner database. The returned
+                # {::Google::Longrunning::Operation long-running operation} can be used to track
+                # the progress of updating the database. If the named database does not
+                # exist, returns `NOT_FOUND`.
+                #
+                # While the operation is pending:
+                #
+                #   * The database's
+                #     {::Google::Cloud::Spanner::Admin::Database::V1::Database#reconciling reconciling}
+                #     field is set to true.
+                #   * Cancelling the operation is best-effort. If the cancellation succeeds,
+                #     the operation metadata's
+                #     {::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseMetadata#cancel_time cancel_time}
+                #     is set, the updates are reverted, and the operation terminates with a
+                #     `CANCELLED` status.
+                #   * New UpdateDatabase requests will return a `FAILED_PRECONDITION` error
+                #     until the pending operation is done (returns successfully or with
+                #     error).
+                #   * Reading the database via the API continues to give the pre-request
+                #     values.
+                #
+                # Upon completion of the returned operation:
+                #
+                #   * The new values are in effect and readable via the API.
+                #   * The database's
+                #     {::Google::Cloud::Spanner::Admin::Database::V1::Database#reconciling reconciling}
+                #     field becomes false.
+                #
+                # The returned {::Google::Longrunning::Operation long-running operation} will
+                # have a name of the format
+                # `projects/<project>/instances/<instance>/databases/<database>/operations/<operation_id>`
+                # and can be used to track the database modification. The
+                # {::Google::Longrunning::Operation#metadata metadata} field type is
+                # {::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseMetadata UpdateDatabaseMetadata}.
+                # The {::Google::Longrunning::Operation#response response} field type is
+                # {::Google::Cloud::Spanner::Admin::Database::V1::Database Database}, if successful.
+                #
+                # @overload update_database(request, options = nil)
+                #   Pass arguments to `update_database` via a request object, either of type
+                #   {::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseRequest} or an equivalent Hash.
+                #
+                #   @param request [::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseRequest, ::Hash]
+                #     A request object representing the call parameters. Required. To specify no
+                #     parameters, or to keep all the default parameter values, pass an empty Hash.
+                #   @param options [::Gapic::CallOptions, ::Hash]
+                #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+                #
+                # @overload update_database(database: nil, update_mask: nil)
+                #   Pass arguments to `update_database` via keyword arguments. Note that at
+                #   least one keyword argument is required. To specify no parameters, or to keep all
+                #   the default parameter values, pass an empty Hash as a request object (see above).
+                #
+                #   @param database [::Google::Cloud::Spanner::Admin::Database::V1::Database, ::Hash]
+                #     Required. The database to update.
+                #     The `name` field of the database is of the form
+                #     `projects/<project>/instances/<instance>/databases/<database>`.
+                #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
+                #     Required. The list of fields to update. Currently, only
+                #     `enable_drop_protection` field can be updated.
+                #
+                # @yield [response, operation] Access the result along with the RPC operation
+                # @yieldparam response [::Gapic::Operation]
+                # @yieldparam operation [::GRPC::ActiveCall::Operation]
+                #
+                # @return [::Gapic::Operation]
+                #
+                # @raise [::Google::Cloud::Error] if the RPC is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/spanner/admin/database/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseRequest.new
+                #
+                #   # Call the update_database method.
+                #   result = client.update_database request
+                #
+                #   # The returned object is of type Gapic::Operation. You can use it to
+                #   # check the status of an operation, cancel it, or wait for results.
+                #   # Here is how to wait for a response.
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "No response received."
+                #   end
+                #
+                def update_database request, options = nil
+                  raise ::ArgumentError, "request must be provided" if request.nil?
+
+                  request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseRequest
+
+                  # Converts hash and nil to an options object
+                  options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                  # Customize the options with defaults
+                  metadata = @config.rpcs.update_database.metadata.to_h
+
+                  # Set x-goog-api-client and x-goog-user-project headers
+                  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                    lib_name: @config.lib_name, lib_version: @config.lib_version,
+                    gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
+                  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                  header_params = {}
+                  if request.database&.name
+                    header_params["database.name"] = request.database.name
+                  end
+
+                  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+                  metadata[:"x-goog-request-params"] ||= request_params_header
+
+                  options.apply_defaults timeout:      @config.rpcs.update_database.timeout,
+                                         metadata:     metadata,
+                                         retry_policy: @config.rpcs.update_database.retry_policy
+
+                  options.apply_defaults timeout:      @config.timeout,
+                                         metadata:     @config.metadata,
+                                         retry_policy: @config.retry_policy
+
+                  @database_admin_stub.call_rpc :update_database, request, options: options do |response, operation|
+                    response = ::Gapic::Operation.new response, @operations_client, options: options
+                    yield response, operation if block_given?
+                    return response
+                  end
+                rescue ::GRPC::BadStatus => e
+                  raise ::Google::Cloud::Error.from_error(e)
+                end
+
                 ##
                 # Updates the schema of a Cloud Spanner database by
                 # creating/altering/dropping tables, columns, indexes, etc. The returned
@@ -2387,9 +2525,9 @@ module Google
                 #    *  (`String`) The path to a service account key file in JSON format
                 #    *  (`Hash`) A service account key as a Hash
                 #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-                #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+                #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
                 #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-                #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+                #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
                 #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
                 #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
                 #    *  (`nil`) indicating no credentials
@@ -2500,6 +2638,11 @@ module Google
                     #
                     attr_reader :get_database
                     ##
+                    # RPC-specific configuration for `update_database`
+                    # @return [::Gapic::Config::Method]
+                    #
+                    attr_reader :update_database
+                    ##
                     # RPC-specific configuration for `update_database_ddl`
                     # @return [::Gapic::Config::Method]
                     #
@@ -2588,6 +2731,8 @@ module Google
                       @create_database = ::Gapic::Config::Method.new create_database_config
                       get_database_config = parent_rpcs.get_database if parent_rpcs.respond_to? :get_database
                       @get_database = ::Gapic::Config::Method.new get_database_config
+                      update_database_config = parent_rpcs.update_database if parent_rpcs.respond_to? :update_database
+                      @update_database = ::Gapic::Config::Method.new update_database_config
                       update_database_ddl_config = parent_rpcs.update_database_ddl if parent_rpcs.respond_to? :update_database_ddl
                       @update_database_ddl = ::Gapic::Config::Method.new update_database_ddl_config
                       drop_database_config = parent_rpcs.drop_database if parent_rpcs.respond_to? :drop_database

data/lib/google/cloud/spanner/admin/database/v1/database_admin/operations.rb

@@ -622,9 +622,9 @@ module Google
                 #    *  (`String`) The path to a service account key file in JSON format
                 #    *  (`Hash`) A service account key as a Hash
                 #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-                #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+                #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
                 #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-                #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+                #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
                 #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
                 #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
                 #    *  (`nil`) indicating no credentials

data/lib/google/cloud/spanner/admin/database/v1/database_admin/rest/client.rb

@@ -86,6 +86,11 @@ module Google
                         initial_delay: 1.0, max_delay: 32.0, multiplier: 1.3, retry_codes: [14, 4]
                       }
 
+                      default_config.rpcs.update_database.timeout = 3600.0
+                      default_config.rpcs.update_database.retry_policy = {
+                        initial_delay: 1.0, max_delay: 32.0, multiplier: 1.3, retry_codes: [14, 4]
+                      }
+
                       default_config.rpcs.update_database_ddl.timeout = 3600.0
                       default_config.rpcs.update_database_ddl.retry_policy = {
                         initial_delay: 1.0, max_delay: 32.0, multiplier: 1.3, retry_codes: [14, 4]
@@ -455,6 +460,109 @@ module Google
                     raise ::Google::Cloud::Error.from_error(e)
                   end
 
+                  ##
+                  # Updates a Cloud Spanner database. The returned
+                  # {::Google::Longrunning::Operation long-running operation} can be used to track
+                  # the progress of updating the database. If the named database does not
+                  # exist, returns `NOT_FOUND`.
+                  #
+                  # While the operation is pending:
+                  #
+                  #   * The database's
+                  #     {::Google::Cloud::Spanner::Admin::Database::V1::Database#reconciling reconciling}
+                  #     field is set to true.
+                  #   * Cancelling the operation is best-effort. If the cancellation succeeds,
+                  #     the operation metadata's
+                  #     {::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseMetadata#cancel_time cancel_time}
+                  #     is set, the updates are reverted, and the operation terminates with a
+                  #     `CANCELLED` status.
+                  #   * New UpdateDatabase requests will return a `FAILED_PRECONDITION` error
+                  #     until the pending operation is done (returns successfully or with
+                  #     error).
+                  #   * Reading the database via the API continues to give the pre-request
+                  #     values.
+                  #
+                  # Upon completion of the returned operation:
+                  #
+                  #   * The new values are in effect and readable via the API.
+                  #   * The database's
+                  #     {::Google::Cloud::Spanner::Admin::Database::V1::Database#reconciling reconciling}
+                  #     field becomes false.
+                  #
+                  # The returned {::Google::Longrunning::Operation long-running operation} will
+                  # have a name of the format
+                  # `projects/<project>/instances/<instance>/databases/<database>/operations/<operation_id>`
+                  # and can be used to track the database modification. The
+                  # {::Google::Longrunning::Operation#metadata metadata} field type is
+                  # {::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseMetadata UpdateDatabaseMetadata}.
+                  # The {::Google::Longrunning::Operation#response response} field type is
+                  # {::Google::Cloud::Spanner::Admin::Database::V1::Database Database}, if successful.
+                  #
+                  # @overload update_database(request, options = nil)
+                  #   Pass arguments to `update_database` via a request object, either of type
+                  #   {::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseRequest} or an equivalent Hash.
+                  #
+                  #   @param request [::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseRequest, ::Hash]
+                  #     A request object representing the call parameters. Required. To specify no
+                  #     parameters, or to keep all the default parameter values, pass an empty Hash.
+                  #   @param options [::Gapic::CallOptions, ::Hash]
+                  #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+                  #
+                  # @overload update_database(database: nil, update_mask: nil)
+                  #   Pass arguments to `update_database` via keyword arguments. Note that at
+                  #   least one keyword argument is required. To specify no parameters, or to keep all
+                  #   the default parameter values, pass an empty Hash as a request object (see above).
+                  #
+                  #   @param database [::Google::Cloud::Spanner::Admin::Database::V1::Database, ::Hash]
+                  #     Required. The database to update.
+                  #     The `name` field of the database is of the form
+                  #     `projects/<project>/instances/<instance>/databases/<database>`.
+                  #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
+                  #     Required. The list of fields to update. Currently, only
+                  #     `enable_drop_protection` field can be updated.
+                  # @yield [result, operation] Access the result along with the TransportOperation object
+                  # @yieldparam result [::Gapic::Operation]
+                  # @yieldparam operation [::Gapic::Rest::TransportOperation]
+                  #
+                  # @return [::Gapic::Operation]
+                  #
+                  # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                  def update_database request, options = nil
+                    raise ::ArgumentError, "request must be provided" if request.nil?
+
+                    request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseRequest
+
+                    # Converts hash and nil to an options object
+                    options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                    # Customize the options with defaults
+                    call_metadata = @config.rpcs.update_database.metadata.to_h
+
+                    # Set x-goog-api-client and x-goog-user-project headers
+                    call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                      lib_name: @config.lib_name, lib_version: @config.lib_version,
+                      gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
+                      transports_version_send: [:rest]
+
+                    call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                    options.apply_defaults timeout:      @config.rpcs.update_database.timeout,
+                                           metadata:     call_metadata,
+                                           retry_policy: @config.rpcs.update_database.retry_policy
+
+                    options.apply_defaults timeout:      @config.timeout,
+                                           metadata:     @config.metadata,
+                                           retry_policy: @config.retry_policy
+
+                    @database_admin_stub.update_database request, options do |result, operation|
+                      result = ::Gapic::Operation.new result, @operations_client, options: options
+                      yield result, operation if block_given?
+                      return result
+                    end
+                  rescue ::Gapic::Rest::Error => e
+                    raise ::Google::Cloud::Error.from_error(e)
+                  end
+
                   ##
                   # Updates the schema of a Cloud Spanner database by
                   # creating/altering/dropping tables, columns, indexes, etc. The returned
@@ -1884,9 +1992,9 @@ module Google
                   #    *  (`String`) The path to a service account key file in JSON format
                   #    *  (`Hash`) A service account key as a Hash
                   #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-                  #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+                  #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
                   #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-                  #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+                  #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
                   #    *  (`nil`) indicating no credentials
                   #   @return [::Object]
                   # @!attribute [rw] scope
@@ -1985,6 +2093,11 @@ module Google
                       #
                       attr_reader :get_database
                       ##
+                      # RPC-specific configuration for `update_database`
+                      # @return [::Gapic::Config::Method]
+                      #
+                      attr_reader :update_database
+                      ##
                       # RPC-specific configuration for `update_database_ddl`
                       # @return [::Gapic::Config::Method]
                       #
@@ -2073,6 +2186,8 @@ module Google
                         @create_database = ::Gapic::Config::Method.new create_database_config
                         get_database_config = parent_rpcs.get_database if parent_rpcs.respond_to? :get_database
                         @get_database = ::Gapic::Config::Method.new get_database_config
+                        update_database_config = parent_rpcs.update_database if parent_rpcs.respond_to? :update_database
+                        @update_database = ::Gapic::Config::Method.new update_database_config
                         update_database_ddl_config = parent_rpcs.update_database_ddl if parent_rpcs.respond_to? :update_database_ddl
                         @update_database_ddl = ::Gapic::Config::Method.new update_database_ddl_config
                         drop_database_config = parent_rpcs.drop_database if parent_rpcs.respond_to? :drop_database

data/lib/google/cloud/spanner/admin/database/v1/database_admin/rest/operations.rb

@@ -413,9 +413,9 @@ module Google
                   #    *  (`String`) The path to a service account key file in JSON format
                   #    *  (`Hash`) A service account key as a Hash
                   #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-                  #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+                  #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
                   #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-                  #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+                  #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
                   #    *  (`nil`) indicating no credentials
                   #   @return [::Object]
                   # @!attribute [rw] scope

data/lib/google/cloud/spanner/admin/database/v1/database_admin/rest/service_stub.rb

@@ -156,6 +156,44 @@ module Google
                     result
                   end
 
+                  ##
+                  # Baseline implementation for the update_database REST call
+                  #
+                  # @param request_pb [::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseRequest]
+                  #   A request object representing the call parameters. Required.
+                  # @param options [::Gapic::CallOptions]
+                  #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+                  #
+                  # @yield [result, operation] Access the result along with the TransportOperation object
+                  # @yieldparam result [::Google::Longrunning::Operation]
+                  # @yieldparam operation [::Gapic::Rest::TransportOperation]
+                  #
+                  # @return [::Google::Longrunning::Operation]
+                  #   A result object deserialized from the server's reply
+                  def update_database request_pb, options = nil
+                    raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                    verb, uri, query_string_params, body = ServiceStub.transcode_update_database_request request_pb
+                    query_string_params = if query_string_params.any?
+                                            query_string_params.to_h { |p| p.split("=", 2) }
+                                          else
+                                            {}
+                                          end
+
+                    response = @client_stub.make_http_request(
+                      verb,
+                      uri:     uri,
+                      body:    body || "",
+                      params:  query_string_params,
+                      options: options
+                    )
+                    operation = ::Gapic::Rest::TransportOperation.new response
+                    result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
+
+                    yield result, operation if block_given?
+                    result
+                  end
+
                   ##
                   # Baseline implementation for the update_database_ddl REST call
                   #
@@ -828,6 +866,28 @@ module Google
                     transcoder.transcode request_pb
                   end
 
+                  ##
+                  # @private
+                  #
+                  # GRPC transcoding helper method for the update_database REST call
+                  #
+                  # @param request_pb [::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseRequest]
+                  #   A request object representing the call parameters. Required.
+                  # @return [Array(String, [String, nil], Hash{String => String})]
+                  #   Uri, Body, Query string parameters
+                  def self.transcode_update_database_request request_pb
+                    transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                            .with_bindings(
+                                                              uri_method: :patch,
+                                                              uri_template: "/v1/{database.name}",
+                                                              body: "database",
+                                                              matches: [
+                                                                ["database.name", %r{^projects/[^/]+/instances/[^/]+/databases/[^/]+/?$}, false]
+                                                              ]
+                                                            )
+                    transcoder.transcode request_pb
+                  end
+
                   ##
                   # @private
                   #

data/lib/google/cloud/spanner/admin/database/v1/version.rb

@@ -23,7 +23,7 @@ module Google
       module Admin
         module Database
           module V1
-            VERSION = "0.12.0"
+            VERSION = "0.13.0"
           end
         end
       end

data/lib/google/spanner/admin/database/v1/spanner_database_admin_pb.rb

@@ -11,6 +11,7 @@ require 'google/iam/v1/iam_policy_pb'
 require 'google/iam/v1/policy_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/empty_pb'
+require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/spanner/admin/database/v1/backup_pb'
 require 'google/spanner/admin/database/v1/common_pb'
@@ -34,6 +35,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :earliest_version_time, :message, 7, "google.protobuf.Timestamp"
       optional :default_leader, :string, 9
       optional :database_dialect, :enum, 10, "google.spanner.admin.database.v1.DatabaseDialect"
+      optional :enable_drop_protection, :bool, 11
+      optional :reconciling, :bool, 12
     end
     add_enum "google.spanner.admin.database.v1.Database.State" do
       value :STATE_UNSPECIFIED, 0
@@ -63,6 +66,15 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.spanner.admin.database.v1.GetDatabaseRequest" do
       optional :name, :string, 1
     end
+    add_message "google.spanner.admin.database.v1.UpdateDatabaseRequest" do
+      optional :database, :message, 1, "google.spanner.admin.database.v1.Database"
+      optional :update_mask, :message, 2, "google.protobuf.FieldMask"
+    end
+    add_message "google.spanner.admin.database.v1.UpdateDatabaseMetadata" do
+      optional :request, :message, 1, "google.spanner.admin.database.v1.UpdateDatabaseRequest"
+      optional :progress, :message, 2, "google.spanner.admin.database.v1.OperationProgress"
+      optional :cancel_time, :message, 3, "google.protobuf.Timestamp"
+    end
     add_message "google.spanner.admin.database.v1.UpdateDatabaseDdlRequest" do
       optional :database, :string, 1
       repeated :statements, :string, 2
@@ -159,6 +171,8 @@ module Google
             CreateDatabaseRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.CreateDatabaseRequest").msgclass
             CreateDatabaseMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.CreateDatabaseMetadata").msgclass
             GetDatabaseRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.GetDatabaseRequest").msgclass
+            UpdateDatabaseRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.UpdateDatabaseRequest").msgclass
+            UpdateDatabaseMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.UpdateDatabaseMetadata").msgclass
             UpdateDatabaseDdlRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.UpdateDatabaseDdlRequest").msgclass
             UpdateDatabaseDdlMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata").msgclass
             DropDatabaseRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.DropDatabaseRequest").msgclass

data/lib/google/spanner/admin/database/v1/spanner_database_admin_services_pb.rb

@@ -54,6 +54,43 @@ module Google
                 rpc :CreateDatabase, ::Google::Cloud::Spanner::Admin::Database::V1::CreateDatabaseRequest, ::Google::Longrunning::Operation
                 # Gets the state of a Cloud Spanner database.
                 rpc :GetDatabase, ::Google::Cloud::Spanner::Admin::Database::V1::GetDatabaseRequest, ::Google::Cloud::Spanner::Admin::Database::V1::Database
+                # Updates a Cloud Spanner database. The returned
+                # [long-running operation][google.longrunning.Operation] can be used to track
+                # the progress of updating the database. If the named database does not
+                # exist, returns `NOT_FOUND`.
+                #
+                # While the operation is pending:
+                #
+                #   * The database's
+                #     [reconciling][google.spanner.admin.database.v1.Database.reconciling]
+                #     field is set to true.
+                #   * Cancelling the operation is best-effort. If the cancellation succeeds,
+                #     the operation metadata's
+                #     [cancel_time][google.spanner.admin.database.v1.UpdateDatabaseMetadata.cancel_time]
+                #     is set, the updates are reverted, and the operation terminates with a
+                #     `CANCELLED` status.
+                #   * New UpdateDatabase requests will return a `FAILED_PRECONDITION` error
+                #     until the pending operation is done (returns successfully or with
+                #     error).
+                #   * Reading the database via the API continues to give the pre-request
+                #     values.
+                #
+                # Upon completion of the returned operation:
+                #
+                #   * The new values are in effect and readable via the API.
+                #   * The database's
+                #     [reconciling][google.spanner.admin.database.v1.Database.reconciling]
+                #     field becomes false.
+                #
+                # The returned [long-running operation][google.longrunning.Operation] will
+                # have a name of the format
+                # `projects/<project>/instances/<instance>/databases/<database>/operations/<operation_id>`
+                # and can be used to track the database modification. The
+                # [metadata][google.longrunning.Operation.metadata] field type is
+                # [UpdateDatabaseMetadata][google.spanner.admin.database.v1.UpdateDatabaseMetadata].
+                # The [response][google.longrunning.Operation.response] field type is
+                # [Database][google.spanner.admin.database.v1.Database], if successful.
+                rpc :UpdateDatabase, ::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseRequest, ::Google::Longrunning::Operation
                 # Updates the schema of a Cloud Spanner database by
                 # creating/altering/dropping tables, columns, indexes, etc. The returned
                 # [long-running operation][google.longrunning.Operation] will have a name of

data/proto_docs/google/api/client.rb

@@ -35,7 +35,9 @@ module Google
     # Details about how and where to publish client libraries.
     # @!attribute [rw] version
     #   @return [::String]
-    #     Version of the API to apply these settings to.
+    #     Version of the API to apply these settings to. This is the full protobuf
+    #     package for the API, ending in the version element.
+    #     Examples: "google.cloud.speech.v1" and "google.spanner.admin.database.v1".
     # @!attribute [rw] launch_stage
     #   @return [::Google::Api::LaunchStage]
     #     Launch stage of this version of the API.
@@ -81,7 +83,7 @@ module Google
     #     long-running operation pattern.
     # @!attribute [rw] new_issue_uri
     #   @return [::String]
-    #     Link to a place that API users can report issues.  Example:
+    #     Link to a *public* URI where users can report issues.  Example:
     #     https://issuetracker.google.com/issues/new?component=190865&template=1161103
     # @!attribute [rw] documentation_uri
     #   @return [::String]
@@ -111,6 +113,10 @@ module Google
     #     Client library settings.  If the same version string appears multiple
     #     times in this list, then the last one wins.  Settings from earlier
     #     settings with the same version string are discarded.
+    # @!attribute [rw] proto_reference_documentation_uri
+    #   @return [::String]
+    #     Optional link to proto reference documentation.  Example:
+    #     https://cloud.google.com/pubsub/lite/docs/reference/rpc
     class Publishing
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -203,9 +209,57 @@ module Google
     # @!attribute [rw] common
     #   @return [::Google::Api::CommonLanguageSettings]
     #     Some settings.
+    # @!attribute [rw] renamed_services
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Map from original service names to renamed versions.
+    #     This is used when the default generated types
+    #     would cause a naming conflict. (Neither name is
+    #     fully-qualified.)
+    #     Example: Subscriber to SubscriberServiceApi.
+    # @!attribute [rw] renamed_resources
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Map from full resource types to the effective short name
+    #     for the resource. This is used when otherwise resource
+    #     named from different services would cause naming collisions.
+    #     Example entry:
+    #     "datalabeling.googleapis.com/Dataset": "DataLabelingDataset"
+    # @!attribute [rw] ignored_resources
+    #   @return [::Array<::String>]
+    #     List of full resource types to ignore during generation.
+    #     This is typically used for API-specific Location resources,
+    #     which should be handled by the generator as if they were actually
+    #     the common Location resources.
+    #     Example entry: "documentai.googleapis.com/Location"
+    # @!attribute [rw] forced_namespace_aliases
+    #   @return [::Array<::String>]
+    #     Namespaces which must be aliased in snippets due to
+    #     a known (but non-generator-predictable) naming collision
+    # @!attribute [rw] handwritten_signatures
+    #   @return [::Array<::String>]
+    #     Method signatures (in the form "service.method(signature)")
+    #     which are provided separately, so shouldn't be generated.
+    #     Snippets *calling* these methods are still generated, however.
     class DotnetSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class RenamedServicesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class RenamedResourcesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
     end
 
     # Settings for Ruby client libraries.
@@ -240,8 +294,8 @@ module Google
     #     Example of a YAML configuration::
     #
     #      publishing:
-    #        method_behavior:
-    #          - selector: CreateAdDomain
+    #        method_settings:
+    #          - selector: google.cloud.speech.v2.Speech.BatchRecognize
     #            long_running:
     #              initial_poll_delay:
     #                seconds: 60 # 1 minute
@@ -299,6 +353,15 @@ module Google
 
       # Street View Org.
       STREET_VIEW = 4
+
+      # Shopping Org.
+      SHOPPING = 5
+
+      # Geo Org.
+      GEO = 6
+
+      # Generative AI - https://developers.generativeai.google
+      GENERATIVE_AI = 7
     end
 
     # To where should client libraries be published?

data/proto_docs/google/iam/v1/policy.rb

@@ -35,7 +35,8 @@ module Google
       # only if the expression evaluates to `true`. A condition can add constraints
       # based on attributes of the request, the resource, or both. To learn which
       # resources support conditions in their IAM policies, see the
-      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+      # [IAM
+      # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
       #
       # **JSON example:**
       #
@@ -58,7 +59,8 @@ module Google
       #           "condition": {
       #             "title": "expirable access",
       #             "description": "Does not grant access after Sep 2020",
-      #             "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')",
+      #             "expression": "request.time <
+      #             timestamp('2020-10-01T00:00:00.000Z')",
       #           }
       #         }
       #       ],
@@ -112,7 +114,8 @@ module Google
       #     specify any valid version or leave the field unset.
       #
       #     To learn which resources support conditions in their IAM policies, see the
-      #     [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+      #     [IAM
+      #     documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
       # @!attribute [rw] bindings
       #   @return [::Array<::Google::Iam::V1::Binding>]
       #     Associates a list of `members`, or principals, with a `role`. Optionally,
@@ -305,7 +308,8 @@ module Google
       #   @return [::Array<::String>]
       #     Specifies the identities that do not cause logging for this type of
       #     permission.
-      #     Follows the same format of {::Google::Iam::V1::Binding#members Binding.members}.
+      #     Follows the same format of
+      #     {::Google::Iam::V1::Binding#members Binding.members}.
       class AuditLogConfig
         include ::Google::Protobuf::MessageExts
         extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/spanner/admin/database/v1/spanner_database_admin.rb

@@ -96,6 +96,14 @@ module Google
             # @!attribute [r] database_dialect
             #   @return [::Google::Cloud::Spanner::Admin::Database::V1::DatabaseDialect]
             #     Output only. The dialect of the Cloud Spanner Database.
+            # @!attribute [rw] enable_drop_protection
+            #   @return [::Boolean]
+            #     Whether drop protection is enabled for this database. Defaults to false,
+            #     if not set.
+            # @!attribute [r] reconciling
+            #   @return [::Boolean]
+            #     Output only. If true, the database is being updated. If false, there are no
+            #     ongoing update operations for the database.
             class Database
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -208,6 +216,42 @@ module Google
               extend ::Google::Protobuf::MessageExts::ClassMethods
             end
 
+            # The request for
+            # {::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Client#update_database UpdateDatabase}.
+            # @!attribute [rw] database
+            #   @return [::Google::Cloud::Spanner::Admin::Database::V1::Database]
+            #     Required. The database to update.
+            #     The `name` field of the database is of the form
+            #     `projects/<project>/instances/<instance>/databases/<database>`.
+            # @!attribute [rw] update_mask
+            #   @return [::Google::Protobuf::FieldMask]
+            #     Required. The list of fields to update. Currently, only
+            #     `enable_drop_protection` field can be updated.
+            class UpdateDatabaseRequest
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Metadata type for the operation returned by
+            # {::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Client#update_database UpdateDatabase}.
+            # @!attribute [rw] request
+            #   @return [::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseRequest]
+            #     The request for
+            #     {::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Client#update_database UpdateDatabase}.
+            # @!attribute [rw] progress
+            #   @return [::Google::Cloud::Spanner::Admin::Database::V1::OperationProgress]
+            #     The progress of the
+            #     {::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Client#update_database UpdateDatabase}
+            #     operation.
+            # @!attribute [rw] cancel_time
+            #   @return [::Google::Protobuf::Timestamp]
+            #     The time at which this operation was cancelled. If set, this operation is
+            #     in the process of undoing itself (which is best-effort).
+            class UpdateDatabaseMetadata
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
             # Enqueues the given DDL statements to be applied, in order but not
             # necessarily all at once, to the database schema at some point (or
             # points) in the future. The server checks that the statements

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-spanner-admin-database-v1
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-03-08 00:00:00.000000000 Z
+date: 2023-05-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common