google-cloud-spanner-admin-database-v1 0.1.2 → 0.4.0

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

@@ -37,3 +37,6 @@ module Google
     end
   end
 end
+
+helper_path = ::File.join __dir__, "v1", "_helpers.rb"
+require "google/cloud/spanner/admin/database/v1/_helpers" if ::File.file? helper_path

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

@@ -239,7 +239,13 @@ module Google
 
                   # Create credentials
                   credentials = @config.credentials
-                  credentials ||= Credentials.default scope: @config.scope
+                  # Use self-signed JWT if the scope and endpoint are unchanged from default,
+                  # but only if the default endpoint does not have a region prefix.
+                  enable_self_signed_jwt = @config.scope == Client.configure.scope &&
+                                           @config.endpoint == Client.configure.endpoint &&
+                                           !@config.endpoint.split(".").first.include?("-")
+                  credentials ||= Credentials.default scope:                  @config.scope,
+                                                      enable_self_signed_jwt: enable_self_signed_jwt
                   if credentials.is_a?(String) || credentials.is_a?(Hash)
                     credentials = Credentials.new credentials, scope: @config.scope
                   end
@@ -295,8 +301,9 @@ module Google
                 #     defaults to the server's maximum allowed page size.
                 #   @param page_token [::String]
                 #     If non-empty, `page_token` should contain a
-                #     {::Google::Cloud::Spanner::Admin::Database::V1::ListDatabasesResponse#next_page_token next_page_token} from a
-                #     previous {::Google::Cloud::Spanner::Admin::Database::V1::ListDatabasesResponse ListDatabasesResponse}.
+                #     {::Google::Cloud::Spanner::Admin::Database::V1::ListDatabasesResponse#next_page_token next_page_token}
+                #     from a previous
+                #     {::Google::Cloud::Spanner::Admin::Database::V1::ListDatabasesResponse ListDatabasesResponse}.
                 #
                 # @yield [response, operation] Access the result along with the RPC operation
                 # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Spanner::Admin::Database::V1::Database>]
@@ -350,8 +357,8 @@ module Google
                 # have a name of the format `<database_name>/operations/<operation_id>` and
                 # can be used to track preparation of the database. The
                 # {::Google::Longrunning::Operation#metadata metadata} field type is
-                # {::Google::Cloud::Spanner::Admin::Database::V1::CreateDatabaseMetadata CreateDatabaseMetadata}. The
-                # {::Google::Longrunning::Operation#response response} field type is
+                # {::Google::Cloud::Spanner::Admin::Database::V1::CreateDatabaseMetadata CreateDatabaseMetadata}.
+                # The {::Google::Longrunning::Operation#response response} field type is
                 # {::Google::Cloud::Spanner::Admin::Database::V1::Database Database}, if successful.
                 #
                 # @overload create_database(request, options = nil)
@@ -364,7 +371,7 @@ module Google
                 #   @param options [::Gapic::CallOptions, ::Hash]
                 #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
                 #
-                # @overload create_database(parent: nil, create_statement: nil, extra_statements: nil)
+                # @overload create_database(parent: nil, create_statement: nil, extra_statements: nil, encryption_config: nil)
                 #   Pass arguments to `create_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).
@@ -383,6 +390,10 @@ module Google
                 #     database. Statements can create tables, indexes, etc. These
                 #     statements execute atomically with the creation of the database:
                 #     if there is an error in any statement, the database is not created.
+                #   @param encryption_config [::Google::Cloud::Spanner::Admin::Database::V1::EncryptionConfig, ::Hash]
+                #     Optional. The encryption configuration for the database. If this field is
+                #     not specified, Cloud Spanner will encrypt/decrypt all data at rest using
+                #     Google default encryption.
                 #
                 # @yield [response, operation] Access the result along with the RPC operation
                 # @yieldparam response [::Gapic::Operation]
@@ -504,7 +515,8 @@ module Google
                 # the format `<database_name>/operations/<operation_id>` and can be used to
                 # track execution of the schema change(s). The
                 # {::Google::Longrunning::Operation#metadata metadata} field type is
-                # {::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseDdlMetadata UpdateDatabaseDdlMetadata}.  The operation has no response.
+                # {::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseDdlMetadata UpdateDatabaseDdlMetadata}.
+                # The operation has no response.
                 #
                 # @overload update_database_ddl(request, options = nil)
                 #   Pass arguments to `update_database_ddl` via a request object, either of type
@@ -533,18 +545,20 @@ module Google
                 #
                 #     Specifying an explicit operation ID simplifies determining
                 #     whether the statements were executed in the event that the
-                #     {::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Client#update_database_ddl UpdateDatabaseDdl} call is replayed,
-                #     or the return value is otherwise lost: the {::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseDdlRequest#database database} and
-                #     `operation_id` fields can be combined to form the
+                #     {::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Client#update_database_ddl UpdateDatabaseDdl}
+                #     call is replayed, or the return value is otherwise lost: the
+                #     {::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseDdlRequest#database database}
+                #     and `operation_id` fields can be combined to form the
                 #     {::Google::Longrunning::Operation#name name} of the resulting
-                #     {::Google::Longrunning::Operation longrunning.Operation}: `<database>/operations/<operation_id>`.
+                #     {::Google::Longrunning::Operation longrunning.Operation}:
+                #     `<database>/operations/<operation_id>`.
                 #
                 #     `operation_id` should be unique within the database, and must be
                 #     a valid identifier: `[a-z][a-z0-9_]*`. Note that
                 #     automatically-generated operation IDs always begin with an
                 #     underscore. If the named operation already exists,
-                #     {::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Client#update_database_ddl UpdateDatabaseDdl} returns
-                #     `ALREADY_EXISTS`.
+                #     {::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Client#update_database_ddl UpdateDatabaseDdl}
+                #     returns `ALREADY_EXISTS`.
                 #
                 # @yield [response, operation] Access the result along with the RPC operation
                 # @yieldparam response [::Gapic::Operation]
@@ -682,6 +696,8 @@ module Google
                 #
                 #   @param database [::String]
                 #     Required. The database whose schema we wish to get.
+                #     Values are of the form
+                #     `projects/<project>/instances/<instance>/databases/<database>`
                 #
                 # @yield [response, operation] Access the result along with the RPC operation
                 # @yieldparam response [::Google::Cloud::Spanner::Admin::Database::V1::GetDatabaseDdlResponse]
@@ -971,12 +987,12 @@ module Google
                 # `projects/<project>/instances/<instance>/backups/<backup>/operations/<operation_id>`
                 # and can be used to track creation of the backup. The
                 # {::Google::Longrunning::Operation#metadata metadata} field type is
-                # {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata}. The
-                # {::Google::Longrunning::Operation#response response} field type is
-                # {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}, if successful. Cancelling the returned operation will stop the
-                # creation and delete the backup.
-                # There can be only one pending backup creation per database. Backup creation
-                # of different databases can run concurrently.
+                # {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata}.
+                # The {::Google::Longrunning::Operation#response response} field type is
+                # {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}, if successful.
+                # Cancelling the returned operation will stop the creation and delete the
+                # backup. There can be only one pending backup creation per database. Backup
+                # creation of different databases can run concurrently.
                 #
                 # @overload create_backup(request, options = nil)
                 #   Pass arguments to `create_backup` via a request object, either of type
@@ -988,7 +1004,7 @@ module Google
                 #   @param options [::Gapic::CallOptions, ::Hash]
                 #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
                 #
-                # @overload create_backup(parent: nil, backup_id: nil, backup: nil)
+                # @overload create_backup(parent: nil, backup_id: nil, backup: nil, encryption_config: nil)
                 #   Pass arguments to `create_backup` 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).
@@ -1006,6 +1022,12 @@ module Google
                 #     `projects/<project>/instances/<instance>/backups/<backup_id>`.
                 #   @param backup [::Google::Cloud::Spanner::Admin::Database::V1::Backup, ::Hash]
                 #     Required. The backup to create.
+                #   @param encryption_config [::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupEncryptionConfig, ::Hash]
+                #     Optional. The encryption configuration used to encrypt the backup. If this
+                #     field is not specified, the backup will use the same encryption
+                #     configuration as the database by default, namely
+                #     {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupEncryptionConfig#encryption_type encryption_type}
+                #     = `USE_DATABASE_ENCRYPTION`.
                 #
                 # @yield [response, operation] Access the result along with the RPC operation
                 # @yieldparam response [::Gapic::Operation]
@@ -1054,7 +1076,8 @@ module Google
                 end
 
                 ##
-                # Gets metadata on a pending or completed {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}.
+                # Gets metadata on a pending or completed
+                # {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}.
                 #
                 # @overload get_backup(request, options = nil)
                 #   Pass arguments to `get_backup` via a request object, either of type
@@ -1122,7 +1145,8 @@ module Google
                 end
 
                 ##
-                # Updates a pending or completed {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}.
+                # Updates a pending or completed
+                # {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}.
                 #
                 # @overload update_backup(request, options = nil)
                 #   Pass arguments to `update_backup` via a request object, either of type
@@ -1197,7 +1221,8 @@ module Google
                 end
 
                 ##
-                # Deletes a pending or completed {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}.
+                # Deletes a pending or completed
+                # {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}.
                 #
                 # @overload delete_backup(request, options = nil)
                 #   Pass arguments to `delete_backup` via a request object, either of type
@@ -1296,13 +1321,16 @@ module Google
                 #     must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`.
                 #     Colon `:` is the contains operator. Filter rules are not case sensitive.
                 #
-                #     The following fields in the {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup} are eligible for filtering:
+                #     The following fields in the
+                #     {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup} are eligible for
+                #     filtering:
                 #
                 #       * `name`
                 #       * `database`
                 #       * `state`
-                #       * `create_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
-                #       * `expire_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
+                #       * `create_time`  (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
+                #       * `expire_time`  (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
+                #       * `version_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
                 #       * `size_bytes`
                 #
                 #     You can combine multiple expressions by enclosing each expression in
@@ -1327,9 +1355,10 @@ module Google
                 #     less, defaults to the server's maximum allowed page size.
                 #   @param page_token [::String]
                 #     If non-empty, `page_token` should contain a
-                #     {::Google::Cloud::Spanner::Admin::Database::V1::ListBackupsResponse#next_page_token next_page_token} from a
-                #     previous {::Google::Cloud::Spanner::Admin::Database::V1::ListBackupsResponse ListBackupsResponse} to the same `parent` and with the same
-                #     `filter`.
+                #     {::Google::Cloud::Spanner::Admin::Database::V1::ListBackupsResponse#next_page_token next_page_token}
+                #     from a previous
+                #     {::Google::Cloud::Spanner::Admin::Database::V1::ListBackupsResponse ListBackupsResponse}
+                #     to the same `parent` and with the same `filter`.
                 #
                 # @yield [response, operation] Access the result along with the RPC operation
                 # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Spanner::Admin::Database::V1::Backup>]
@@ -1406,7 +1435,7 @@ module Google
                 #   @param options [::Gapic::CallOptions, ::Hash]
                 #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
                 #
-                # @overload restore_database(parent: nil, database_id: nil, backup: nil)
+                # @overload restore_database(parent: nil, database_id: nil, backup: nil, encryption_config: nil)
                 #   Pass arguments to `restore_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).
@@ -1425,6 +1454,13 @@ module Google
                 #   @param backup [::String]
                 #     Name of the backup from which to restore.  Values are of the form
                 #     `projects/<project>/instances/<instance>/backups/<backup>`.
+                #   @param encryption_config [::Google::Cloud::Spanner::Admin::Database::V1::RestoreDatabaseEncryptionConfig, ::Hash]
+                #     Optional. An encryption configuration describing the encryption type and
+                #     key resources in Cloud KMS used to encrypt/decrypt the database to restore
+                #     to. If this field is not specified, the restored database will use the same
+                #     encryption configuration as the backup by default, namely
+                #     {::Google::Cloud::Spanner::Admin::Database::V1::RestoreDatabaseEncryptionConfig#encryption_type encryption_type}
+                #     = `USE_CONFIG_DEFAULT_OR_DATABASE_ENCRYPTION`.
                 #
                 # @yield [response, operation] Access the result along with the RPC operation
                 # @yieldparam response [::Gapic::Operation]
@@ -1515,7 +1551,9 @@ module Google
                 #       * `name` - The name of the long-running operation
                 #       * `done` - False if the operation is in progress, else true.
                 #       * `metadata.@type` - the type of metadata. For example, the type string
-                #          for {::Google::Cloud::Spanner::Admin::Database::V1::RestoreDatabaseMetadata RestoreDatabaseMetadata} is
+                #          for
+                #          {::Google::Cloud::Spanner::Admin::Database::V1::RestoreDatabaseMetadata RestoreDatabaseMetadata}
+                #          is
                 #          `type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata`.
                 #       * `metadata.<field_name>` - any field in metadata.value.
                 #       * `error` - Error associated with the long-running operation.
@@ -1529,13 +1567,14 @@ module Google
                 #     Here are a few examples:
                 #
                 #       * `done:true` - The operation is complete.
-                #       * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata) AND` <br/>
-                #         `(metadata.source_type:BACKUP) AND` <br/>
-                #         `(metadata.backup_info.backup:backup_howl) AND` <br/>
-                #         `(metadata.name:restored_howl) AND` <br/>
-                #         `(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND` <br/>
+                #       * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata) AND` \
+                #         `(metadata.source_type:BACKUP) AND` \
+                #         `(metadata.backup_info.backup:backup_howl) AND` \
+                #         `(metadata.name:restored_howl) AND` \
+                #         `(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND` \
                 #         `(error:*)` - Return operations where:
-                #         * The operation's metadata type is {::Google::Cloud::Spanner::Admin::Database::V1::RestoreDatabaseMetadata RestoreDatabaseMetadata}.
+                #         * The operation's metadata type is
+                #         {::Google::Cloud::Spanner::Admin::Database::V1::RestoreDatabaseMetadata RestoreDatabaseMetadata}.
                 #         * The database is restored from a backup.
                 #         * The backup name contains "backup_howl".
                 #         * The restored database's name contains "restored_howl".
@@ -1547,8 +1586,9 @@ module Google
                 #   @param page_token [::String]
                 #     If non-empty, `page_token` should contain a
                 #     {::Google::Cloud::Spanner::Admin::Database::V1::ListDatabaseOperationsResponse#next_page_token next_page_token}
-                #     from a previous {::Google::Cloud::Spanner::Admin::Database::V1::ListDatabaseOperationsResponse ListDatabaseOperationsResponse} to the
-                #     same `parent` and with the same `filter`.
+                #     from a previous
+                #     {::Google::Cloud::Spanner::Admin::Database::V1::ListDatabaseOperationsResponse ListDatabaseOperationsResponse}
+                #     to the same `parent` and with the same `filter`.
                 #
                 # @yield [response, operation] Access the result along with the RPC operation
                 # @yieldparam response [::Gapic::PagedEnumerable<::Gapic::Operation>]
@@ -1642,7 +1682,9 @@ module Google
                 #       * `name` - The name of the long-running operation
                 #       * `done` - False if the operation is in progress, else true.
                 #       * `metadata.@type` - the type of metadata. For example, the type string
-                #          for {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata} is
+                #          for
+                #          {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata}
+                #          is
                 #          `type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata`.
                 #       * `metadata.<field_name>` - any field in metadata.value.
                 #       * `error` - Error associated with the long-running operation.
@@ -1658,11 +1700,12 @@ module Google
                 #       * `done:true` - The operation is complete.
                 #       * `metadata.database:prod` - The database the backup was taken from has
                 #          a name containing the string "prod".
-                #       * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` <br/>
-                #         `(metadata.name:howl) AND` <br/>
-                #         `(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND` <br/>
+                #       * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \
+                #         `(metadata.name:howl) AND` \
+                #         `(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND` \
                 #         `(error:*)` - Returns operations where:
-                #         * The operation's metadata type is {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata}.
+                #         * The operation's metadata type is
+                #         {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata}.
                 #         * The backup name contains the string "howl".
                 #         * The operation started before 2018-03-28T14:50:00Z.
                 #         * The operation resulted in an error.
@@ -1672,8 +1715,9 @@ module Google
                 #   @param page_token [::String]
                 #     If non-empty, `page_token` should contain a
                 #     {::Google::Cloud::Spanner::Admin::Database::V1::ListBackupOperationsResponse#next_page_token next_page_token}
-                #     from a previous {::Google::Cloud::Spanner::Admin::Database::V1::ListBackupOperationsResponse ListBackupOperationsResponse} to the
-                #     same `parent` and with the same `filter`.
+                #     from a previous
+                #     {::Google::Cloud::Spanner::Admin::Database::V1::ListBackupOperationsResponse ListBackupOperationsResponse}
+                #     to the same `parent` and with the same `filter`.
                 #
                 # @yield [response, operation] Access the result along with the RPC operation
                 # @yieldparam response [::Gapic::PagedEnumerable<::Gapic::Operation>]
@@ -1807,7 +1851,7 @@ module Google
 
                   config_attr :endpoint,      "spanner.googleapis.com", ::String
                   config_attr :credentials,   nil do |value|
-                    allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
+                    allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                     allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
                     allowed.any? { |klass| klass === value }
                   end
@@ -1847,7 +1891,7 @@ module Google
                   # Each configuration object is of type `Gapic::Config::Method` and includes
                   # the following configuration fields:
                   #
-                  #  *  `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
+                  #  *  `timeout` (*type:* `Numeric`) - The call timeout in seconds
                   #  *  `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
                   #  *  `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
                   #     include the following keys:

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

@@ -105,8 +105,13 @@ module Google
                 # Lists operations that match the specified filter in the request. If the
                 # server doesn't support this method, it returns `UNIMPLEMENTED`.
                 #
-                # NOTE: the `name` binding below allows API services to override the binding
-                # to use different resource name schemes, such as `users/*/operations`.
+                # NOTE: the `name` binding allows API services to override the binding
+                # to use different resource name schemes, such as `users/*/operations`. To
+                # override the binding, API services can add a binding such as
+                # `"/v1/{name=users/*}/operations"` to their service configuration.
+                # For backwards compatibility, the default name includes the operations
+                # collection id, however overriding users must ensure the name binding
+                # is the parent resource, without the operations collection id.
                 #
                 # @overload list_operations(request, options = nil)
                 #   Pass arguments to `list_operations` via a request object, either of type
@@ -124,7 +129,7 @@ module Google
                 #   the default parameter values, pass an empty Hash as a request object (see above).
                 #
                 #   @param name [::String]
-                #     The name of the operation collection.
+                #     The name of the operation's parent resource.
                 #   @param filter [::String]
                 #     The standard list filter.
                 #   @param page_size [::Integer]
@@ -392,6 +397,79 @@ module Google
                   raise ::Google::Cloud::Error.from_error(e)
                 end
 
+                ##
+                # Waits for the specified long-running operation until it is done or reaches
+                # at most a specified timeout, returning the latest state.  If the operation
+                # is already done, the latest state is immediately returned.  If the timeout
+                # specified is greater than the default HTTP/RPC timeout, the HTTP/RPC
+                # timeout is used.  If the server does not support this method, it returns
+                # `google.rpc.Code.UNIMPLEMENTED`.
+                # Note that this method is on a best-effort basis.  It may return the latest
+                # state before the specified timeout (including immediately), meaning even an
+                # immediate response is no guarantee that the operation is done.
+                #
+                # @overload wait_operation(request, options = nil)
+                #   Pass arguments to `wait_operation` via a request object, either of type
+                #   {::Google::Longrunning::WaitOperationRequest} or an equivalent Hash.
+                #
+                #   @param request [::Google::Longrunning::WaitOperationRequest, ::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 wait_operation(name: nil, timeout: nil)
+                #   Pass arguments to `wait_operation` 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 name [::String]
+                #     The name of the operation resource to wait on.
+                #   @param timeout [::Google::Protobuf::Duration, ::Hash]
+                #     The maximum duration to wait before timing out. If left blank, the wait
+                #     will be at most the time permitted by the underlying HTTP/RPC protocol.
+                #     If RPC context deadline is also specified, the shorter one will be used.
+                #
+                # @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.
+                #
+                def wait_operation request, options = nil
+                  raise ::ArgumentError, "request must be provided" if request.nil?
+
+                  request = ::Gapic::Protobuf.coerce request, to: ::Google::Longrunning::WaitOperationRequest
+
+                  # 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.wait_operation.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
+
+                  options.apply_defaults timeout:      @config.rpcs.wait_operation.timeout,
+                                         metadata:     metadata,
+                                         retry_policy: @config.rpcs.wait_operation.retry_policy
+                  options.apply_defaults metadata:     @config.metadata,
+                                         retry_policy: @config.retry_policy
+
+                  @operations_stub.call_rpc :wait_operation, 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
+
                 ##
                 # Configuration class for the Operations API.
                 #
@@ -477,7 +555,7 @@ module Google
 
                   config_attr :endpoint,      "spanner.googleapis.com", ::String
                   config_attr :credentials,   nil do |value|
-                    allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
+                    allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                     allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
                     allowed.any? { |klass| klass === value }
                   end
@@ -517,7 +595,7 @@ module Google
                   # Each configuration object is of type `Gapic::Config::Method` and includes
                   # the following configuration fields:
                   #
-                  #  *  `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
+                  #  *  `timeout` (*type:* `Numeric`) - The call timeout in seconds
                   #  *  `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
                   #  *  `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
                   #     include the following keys:
@@ -548,6 +626,11 @@ module Google
                     # @return [::Gapic::Config::Method]
                     #
                     attr_reader :cancel_operation
+                    ##
+                    # RPC-specific configuration for `wait_operation`
+                    # @return [::Gapic::Config::Method]
+                    #
+                    attr_reader :wait_operation
 
                     # @private
                     def initialize parent_rpcs = nil
@@ -559,6 +642,8 @@ module Google
                       @delete_operation = ::Gapic::Config::Method.new delete_operation_config
                       cancel_operation_config = parent_rpcs&.cancel_operation if parent_rpcs&.respond_to? :cancel_operation
                       @cancel_operation = ::Gapic::Config::Method.new cancel_operation_config
+                      wait_operation_config = parent_rpcs&.wait_operation if parent_rpcs&.respond_to? :wait_operation
+                      @wait_operation = ::Gapic::Config::Method.new wait_operation_config
 
                       yield self if block_given?
                     end