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

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0dd7e7bcd60f178f114d0d9bcc20c5677f09c4b3a0e865ef9a4bee0fed39dc91
-  data.tar.gz: 7e0f9a2ef395b8c5713213a979914e51db9631c44bca6cdcb94a9b8f3eca8a4b
+  metadata.gz: 4df2b851c1fc6d2a565ce4fbbbc1a361e23dd38a928908e37589afb1baf94310
+  data.tar.gz: 97578c37514e60a240f0338ddf762a0301af8a7e63906db2d9a2279326ba3f2b
 SHA512:
-  metadata.gz: c28d6a25a2dff217e9f30cc279a959498de5464545a715aceeda38010552d9cc45d87b7cacbd899ed2ad83fc329a399e46f300f180032ba61a4813c8fdefe1d2
-  data.tar.gz: 88163d15d90874e82b8ce2774fe3d549ff3d87d422e377a3270a8ea44691bcef43235fdcdafdbfed1545474bf28b9ed4dd0d3239b5fd1ede50c5cc04062afa0c
+  metadata.gz: 59b31a2f09758e2663c50e2ec1612acefbc612ca827695be2ab999f7ac24e6cf10367a721e53ac34502c4b6808b5f1ef54d0942537dee87564e26d73badc665a
+  data.tar.gz: f7f3113b629bf4a8cf5049ac14c12b51b02742902cc8e012179eba6407584522f6cd5e612d3e2335b191b53f0d176890e550ecd1b1c6fb0e7067079f434e77f3

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.14.0"
           end
         end
       end

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/admin/database/v1/backup.proto
 
@@ -10,109 +11,35 @@ require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/spanner/admin/database/v1/common_pb'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/spanner/admin/database/v1/backup.proto", :syntax => :proto3) do
-    add_message "google.spanner.admin.database.v1.Backup" do
-      optional :database, :string, 2
-      optional :version_time, :message, 9, "google.protobuf.Timestamp"
-      optional :expire_time, :message, 3, "google.protobuf.Timestamp"
-      optional :name, :string, 1
-      optional :create_time, :message, 4, "google.protobuf.Timestamp"
-      optional :size_bytes, :int64, 5
-      optional :state, :enum, 6, "google.spanner.admin.database.v1.Backup.State"
-      repeated :referencing_databases, :string, 7
-      optional :encryption_info, :message, 8, "google.spanner.admin.database.v1.EncryptionInfo"
-      optional :database_dialect, :enum, 10, "google.spanner.admin.database.v1.DatabaseDialect"
-      repeated :referencing_backups, :string, 11
-      optional :max_expire_time, :message, 12, "google.protobuf.Timestamp"
-    end
-    add_enum "google.spanner.admin.database.v1.Backup.State" do
-      value :STATE_UNSPECIFIED, 0
-      value :CREATING, 1
-      value :READY, 2
-    end
-    add_message "google.spanner.admin.database.v1.CreateBackupRequest" do
-      optional :parent, :string, 1
-      optional :backup_id, :string, 2
-      optional :backup, :message, 3, "google.spanner.admin.database.v1.Backup"
-      optional :encryption_config, :message, 4, "google.spanner.admin.database.v1.CreateBackupEncryptionConfig"
-    end
-    add_message "google.spanner.admin.database.v1.CreateBackupMetadata" do
-      optional :name, :string, 1
-      optional :database, :string, 2
-      optional :progress, :message, 3, "google.spanner.admin.database.v1.OperationProgress"
-      optional :cancel_time, :message, 4, "google.protobuf.Timestamp"
-    end
-    add_message "google.spanner.admin.database.v1.CopyBackupRequest" do
-      optional :parent, :string, 1
-      optional :backup_id, :string, 2
-      optional :source_backup, :string, 3
-      optional :expire_time, :message, 4, "google.protobuf.Timestamp"
-      optional :encryption_config, :message, 5, "google.spanner.admin.database.v1.CopyBackupEncryptionConfig"
-    end
-    add_message "google.spanner.admin.database.v1.CopyBackupMetadata" do
-      optional :name, :string, 1
-      optional :source_backup, :string, 2
-      optional :progress, :message, 3, "google.spanner.admin.database.v1.OperationProgress"
-      optional :cancel_time, :message, 4, "google.protobuf.Timestamp"
-    end
-    add_message "google.spanner.admin.database.v1.UpdateBackupRequest" do
-      optional :backup, :message, 1, "google.spanner.admin.database.v1.Backup"
-      optional :update_mask, :message, 2, "google.protobuf.FieldMask"
-    end
-    add_message "google.spanner.admin.database.v1.GetBackupRequest" do
-      optional :name, :string, 1
-    end
-    add_message "google.spanner.admin.database.v1.DeleteBackupRequest" do
-      optional :name, :string, 1
-    end
-    add_message "google.spanner.admin.database.v1.ListBackupsRequest" do
-      optional :parent, :string, 1
-      optional :filter, :string, 2
-      optional :page_size, :int32, 3
-      optional :page_token, :string, 4
-    end
-    add_message "google.spanner.admin.database.v1.ListBackupsResponse" do
-      repeated :backups, :message, 1, "google.spanner.admin.database.v1.Backup"
-      optional :next_page_token, :string, 2
-    end
-    add_message "google.spanner.admin.database.v1.ListBackupOperationsRequest" do
-      optional :parent, :string, 1
-      optional :filter, :string, 2
-      optional :page_size, :int32, 3
-      optional :page_token, :string, 4
-    end
-    add_message "google.spanner.admin.database.v1.ListBackupOperationsResponse" do
-      repeated :operations, :message, 1, "google.longrunning.Operation"
-      optional :next_page_token, :string, 2
-    end
-    add_message "google.spanner.admin.database.v1.BackupInfo" do
-      optional :backup, :string, 1
-      optional :version_time, :message, 4, "google.protobuf.Timestamp"
-      optional :create_time, :message, 2, "google.protobuf.Timestamp"
-      optional :source_database, :string, 3
-    end
-    add_message "google.spanner.admin.database.v1.CreateBackupEncryptionConfig" do
-      optional :encryption_type, :enum, 1, "google.spanner.admin.database.v1.CreateBackupEncryptionConfig.EncryptionType"
-      optional :kms_key_name, :string, 2
-    end
-    add_enum "google.spanner.admin.database.v1.CreateBackupEncryptionConfig.EncryptionType" do
-      value :ENCRYPTION_TYPE_UNSPECIFIED, 0
-      value :USE_DATABASE_ENCRYPTION, 1
-      value :GOOGLE_DEFAULT_ENCRYPTION, 2
-      value :CUSTOMER_MANAGED_ENCRYPTION, 3
-    end
-    add_message "google.spanner.admin.database.v1.CopyBackupEncryptionConfig" do
-      optional :encryption_type, :enum, 1, "google.spanner.admin.database.v1.CopyBackupEncryptionConfig.EncryptionType"
-      optional :kms_key_name, :string, 2
-    end
-    add_enum "google.spanner.admin.database.v1.CopyBackupEncryptionConfig.EncryptionType" do
-      value :ENCRYPTION_TYPE_UNSPECIFIED, 0
-      value :USE_CONFIG_DEFAULT_OR_BACKUP_ENCRYPTION, 1
-      value :GOOGLE_DEFAULT_ENCRYPTION, 2
-      value :CUSTOMER_MANAGED_ENCRYPTION, 3
+
+descriptor_data = "\n-google/spanner/admin/database/v1/backup.proto\x12 google.spanner.admin.database.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a#google/longrunning/operations.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a-google/spanner/admin/database/v1/common.proto\"\xc3\x06\n\x06\x42\x61\x63kup\x12\x36\n\x08\x64\x61tabase\x18\x02 \x01(\tB$\xfa\x41!\n\x1fspanner.googleapis.com/Database\x12\x30\n\x0cversion_time\x18\t \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x65xpire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x34\n\x0b\x63reate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x17\n\nsize_bytes\x18\x05 \x01(\x03\x42\x03\xe0\x41\x03\x12\x42\n\x05state\x18\x06 \x01(\x0e\x32..google.spanner.admin.database.v1.Backup.StateB\x03\xe0\x41\x03\x12\x46\n\x15referencing_databases\x18\x07 \x03(\tB\'\xe0\x41\x03\xfa\x41!\n\x1fspanner.googleapis.com/Database\x12N\n\x0f\x65ncryption_info\x18\x08 \x01(\x0b\x32\x30.google.spanner.admin.database.v1.EncryptionInfoB\x03\xe0\x41\x03\x12P\n\x10\x64\x61tabase_dialect\x18\n \x01(\x0e\x32\x31.google.spanner.admin.database.v1.DatabaseDialectB\x03\xe0\x41\x03\x12\x42\n\x13referencing_backups\x18\x0b \x03(\tB%\xe0\x41\x03\xfa\x41\x1f\n\x1dspanner.googleapis.com/Backup\x12\x38\n\x0fmax_expire_time\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\"7\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\t\n\x05READY\x10\x02:\\\xea\x41Y\n\x1dspanner.googleapis.com/Backup\x12\x38projects/{project}/instances/{instance}/backups/{backup}\"\x85\x02\n\x13\x43reateBackupRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance\x12\x16\n\tbackup_id\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12=\n\x06\x62\x61\x63kup\x18\x03 \x01(\x0b\x32(.google.spanner.admin.database.v1.BackupB\x03\xe0\x41\x02\x12^\n\x11\x65ncryption_config\x18\x04 \x01(\x0b\x32>.google.spanner.admin.database.v1.CreateBackupEncryptionConfigB\x03\xe0\x41\x01\"\xf8\x01\n\x14\x43reateBackupMetadata\x12\x30\n\x04name\x18\x01 \x01(\tB\"\xfa\x41\x1f\n\x1dspanner.googleapis.com/Backup\x12\x36\n\x08\x64\x61tabase\x18\x02 \x01(\tB$\xfa\x41!\n\x1fspanner.googleapis.com/Database\x12\x45\n\x08progress\x18\x03 \x01(\x0b\x32\x33.google.spanner.admin.database.v1.OperationProgress\x12/\n\x0b\x63\x61ncel_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xb6\x02\n\x11\x43opyBackupRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance\x12\x16\n\tbackup_id\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12<\n\rsource_backup\x18\x03 \x01(\tB%\xe0\x41\x02\xfa\x41\x1f\n\x1dspanner.googleapis.com/Backup\x12\x34\n\x0b\x65xpire_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x02\x12\\\n\x11\x65ncryption_config\x18\x05 \x01(\x0b\x32<.google.spanner.admin.database.v1.CopyBackupEncryptionConfigB\x03\xe0\x41\x01\"\xf9\x01\n\x12\x43opyBackupMetadata\x12\x30\n\x04name\x18\x01 \x01(\tB\"\xfa\x41\x1f\n\x1dspanner.googleapis.com/Backup\x12\x39\n\rsource_backup\x18\x02 \x01(\tB\"\xfa\x41\x1f\n\x1dspanner.googleapis.com/Backup\x12\x45\n\x08progress\x18\x03 \x01(\x0b\x32\x33.google.spanner.admin.database.v1.OperationProgress\x12/\n\x0b\x63\x61ncel_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\x8a\x01\n\x13UpdateBackupRequest\x12=\n\x06\x62\x61\x63kup\x18\x01 \x01(\x0b\x32(.google.spanner.admin.database.v1.BackupB\x03\xe0\x41\x02\x12\x34\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMaskB\x03\xe0\x41\x02\"G\n\x10GetBackupRequest\x12\x33\n\x04name\x18\x01 \x01(\tB%\xe0\x41\x02\xfa\x41\x1f\n\x1dspanner.googleapis.com/Backup\"J\n\x13\x44\x65leteBackupRequest\x12\x33\n\x04name\x18\x01 \x01(\tB%\xe0\x41\x02\xfa\x41\x1f\n\x1dspanner.googleapis.com/Backup\"\x84\x01\n\x12ListBackupsRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t\"i\n\x13ListBackupsResponse\x12\x39\n\x07\x62\x61\x63kups\x18\x01 \x03(\x0b\x32(.google.spanner.admin.database.v1.Backup\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\x8d\x01\n\x1bListBackupOperationsRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t\"j\n\x1cListBackupOperationsResponse\x12\x31\n\noperations\x18\x01 \x03(\x0b\x32\x1d.google.longrunning.Operation\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\xe2\x01\n\nBackupInfo\x12\x32\n\x06\x62\x61\x63kup\x18\x01 \x01(\tB\"\xfa\x41\x1f\n\x1dspanner.googleapis.com/Backup\x12\x30\n\x0cversion_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12=\n\x0fsource_database\x18\x03 \x01(\tB$\xfa\x41!\n\x1fspanner.googleapis.com/Database\"\xdd\x02\n\x1c\x43reateBackupEncryptionConfig\x12k\n\x0f\x65ncryption_type\x18\x01 \x01(\x0e\x32M.google.spanner.admin.database.v1.CreateBackupEncryptionConfig.EncryptionTypeB\x03\xe0\x41\x02\x12?\n\x0ckms_key_name\x18\x02 \x01(\tB)\xe0\x41\x01\xfa\x41#\n!cloudkms.googleapis.com/CryptoKey\"\x8e\x01\n\x0e\x45ncryptionType\x12\x1f\n\x1b\x45NCRYPTION_TYPE_UNSPECIFIED\x10\x00\x12\x1b\n\x17USE_DATABASE_ENCRYPTION\x10\x01\x12\x1d\n\x19GOOGLE_DEFAULT_ENCRYPTION\x10\x02\x12\x1f\n\x1b\x43USTOMER_MANAGED_ENCRYPTION\x10\x03\"\xe9\x02\n\x1a\x43opyBackupEncryptionConfig\x12i\n\x0f\x65ncryption_type\x18\x01 \x01(\x0e\x32K.google.spanner.admin.database.v1.CopyBackupEncryptionConfig.EncryptionTypeB\x03\xe0\x41\x02\x12?\n\x0ckms_key_name\x18\x02 \x01(\tB)\xe0\x41\x01\xfa\x41#\n!cloudkms.googleapis.com/CryptoKey\"\x9e\x01\n\x0e\x45ncryptionType\x12\x1f\n\x1b\x45NCRYPTION_TYPE_UNSPECIFIED\x10\x00\x12+\n\'USE_CONFIG_DEFAULT_OR_BACKUP_ENCRYPTION\x10\x01\x12\x1d\n\x19GOOGLE_DEFAULT_ENCRYPTION\x10\x02\x12\x1f\n\x1b\x43USTOMER_MANAGED_ENCRYPTION\x10\x03\x42\xfd\x01\n$com.google.spanner.admin.database.v1B\x0b\x42\x61\x63kupProtoP\x01ZFcloud.google.com/go/spanner/admin/database/apiv1/databasepb;databasepb\xaa\x02&Google.Cloud.Spanner.Admin.Database.V1\xca\x02&Google\\Cloud\\Spanner\\Admin\\Database\\V1\xea\x02+Google::Cloud::Spanner::Admin::Database::V1b\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError => e
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+    ["google.protobuf.Timestamp", "google/protobuf/timestamp.proto"],
+    ["google.spanner.admin.database.v1.EncryptionInfo", "google/spanner/admin/database/v1/common.proto"],
+    ["google.protobuf.FieldMask", "google/protobuf/field_mask.proto"],
+    ["google.longrunning.Operation", "google/longrunning/operations.proto"],
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
     end
   end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
 end
 
 module Google