google-apis-spanner_v1 0.22.0 → 0.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed2d0f9e6501204d162396c8339cefc663a38cede35c0ed2b766c7994103a0b5
-  data.tar.gz: b014d9c65ff06d2ac0211d07ac0e6f9359a799efa669c1707620f26ed3d9d9e9
+  metadata.gz: 51541562e98ca4e9c993afc467f0a98ff8adaa1eda1805c36bafd9997211b2bc
+  data.tar.gz: ddae8e9f8a2915b8462b04e92914d52f13e1707953dd55bb887473a9e2ba773a
 SHA512:
-  metadata.gz: 7ee74bf1e5291c6ae6ef08c45fb93a4ad18db66cafcaa009cbe1c2ed79e97ee188ac94bbcb9aa9e6cbcbc65c9dd2badbb022fa889e6028f3f984f6513b54f31b
-  data.tar.gz: 55b4f765118c3e147cb569ea34ff2d2c2f4855eef8dc456b2846242e3f23f315f03c1dbd5ea823cb4da7cd5b755f924ddb192d40b204bbd64afe6010e9b4eb2e
+  metadata.gz: dc983c308f4d10749bbf5e7fb820069f8644ba3afb151c60f8f2ae15522aa813c3de799f45b359ec142103b5aee7c7bfe45f0f9dba9e0d4180b274f9953f816e
+  data.tar.gz: 8db003dacedd2fd9421d39537dfd0504241013e30a08eec8951b3e8f0a99ea8916086b55829e532ceca0386a8f99f6f70d2cfeb71bae1ac3b56c49cc859bea3b

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Release history for google-apis-spanner_v1
 
+### v0.25.0 (2022-03-19)
+
+* Regenerated from discovery document revision 20220310
+
+### v0.24.0 (2022-02-25)
+
+* Regenerated from discovery document revision 20220212
+
+### v0.23.0 (2022-02-03)
+
+* Regenerated from discovery document revision 20220124
+* Regenerated using generator version 0.4.1
+
 ### v0.22.0 (2021-12-16)
 
 * Regenerated from discovery document revision 20211203

data/lib/google/apis/spanner_v1/classes.rb

@@ -40,6 +40,11 @@ module Google
         # @return [String]
         attr_accessor :database
       
+        # Output only. The database dialect information for the backup.
+        # Corresponds to the JSON property `databaseDialect`
+        # @return [String]
+        attr_accessor :database_dialect
+      
         # Encryption information for a Cloud Spanner database or backup.
         # Corresponds to the JSON property `encryptionInfo`
         # @return [Google::Apis::SpannerV1::EncryptionInfo]
@@ -54,6 +59,15 @@ module Google
         # @return [String]
         attr_accessor :expire_time
       
+        # Output only. The max allowed expiration time of the backup, with microseconds
+        # granularity. A backup's expiration time can be configured in multiple APIs:
+        # CreateBackup, UpdateBackup, CopyBackup. When updating or copying an existing
+        # backup, the expiration time specified must be less than `Backup.
+        # max_expire_time`.
+        # Corresponds to the JSON property `maxExpireTime`
+        # @return [String]
+        attr_accessor :max_expire_time
+      
         # Output only for the CreateBackup operation. Required for the UpdateBackup
         # operation. A globally unique identifier for the backup which cannot be changed.
         # Values are of the form `projects//instances//backups/a-z*[a-z0-9]` The final
@@ -65,6 +79,16 @@ module Google
         # @return [String]
         attr_accessor :name
       
+        # Output only. The names of the destination backups being created by copying
+        # this source backup. The backup names are of the form `projects//instances//
+        # backups/`. Referencing backups may exist in different instances. The existence
+        # of any referencing backup prevents the backup from being deleted. When the
+        # copy operation is done (either successfully completed or cancelled or the
+        # destination backup is deleted), the reference to the backup is removed.
+        # Corresponds to the JSON property `referencingBackups`
+        # @return [Array<String>]
+        attr_accessor :referencing_backups
+      
         # Output only. The names of the restored databases that reference the backup.
         # The database names are of the form `projects//instances//databases/`.
         # Referencing databases may exist in different instances. The existence of any
@@ -100,9 +124,12 @@ module Google
         def update!(**args)
           @create_time = args[:create_time] if args.key?(:create_time)
           @database = args[:database] if args.key?(:database)
+          @database_dialect = args[:database_dialect] if args.key?(:database_dialect)
           @encryption_info = args[:encryption_info] if args.key?(:encryption_info)
           @expire_time = args[:expire_time] if args.key?(:expire_time)
+          @max_expire_time = args[:max_expire_time] if args.key?(:max_expire_time)
           @name = args[:name] if args.key?(:name)
+          @referencing_backups = args[:referencing_backups] if args.key?(:referencing_backups)
           @referencing_databases = args[:referencing_databases] if args.key?(:referencing_databases)
           @size_bytes = args[:size_bytes] if args.key?(:size_bytes)
           @state = args[:state] if args.key?(:state)
@@ -787,6 +814,125 @@ module Google
         end
       end
       
+      # Encryption configuration for the copied backup.
+      class CopyBackupEncryptionConfig
+        include Google::Apis::Core::Hashable
+      
+        # Required. The encryption type of the backup.
+        # Corresponds to the JSON property `encryptionType`
+        # @return [String]
+        attr_accessor :encryption_type
+      
+        # Optional. The Cloud KMS key that will be used to protect the backup. This
+        # field should be set only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`.
+        # Values are of the form `projects//locations//keyRings//cryptoKeys/`.
+        # Corresponds to the JSON property `kmsKeyName`
+        # @return [String]
+        attr_accessor :kms_key_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @encryption_type = args[:encryption_type] if args.key?(:encryption_type)
+          @kms_key_name = args[:kms_key_name] if args.key?(:kms_key_name)
+        end
+      end
+      
+      # Metadata type for the google.longrunning.Operation returned by CopyBackup.
+      class CopyBackupMetadata
+        include Google::Apis::Core::Hashable
+      
+        # The time at which cancellation of CopyBackup operation was received.
+        # Operations.CancelOperation starts asynchronous cancellation on a long-running
+        # operation. The server makes a best effort to cancel the operation, but success
+        # is not guaranteed. Clients can use Operations.GetOperation or other methods to
+        # check whether the cancellation succeeded or whether the operation completed
+        # despite cancellation. On successful cancellation, the operation is not deleted;
+        # instead, it becomes an operation with an Operation.error value with a google.
+        # rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
+        # Corresponds to the JSON property `cancelTime`
+        # @return [String]
+        attr_accessor :cancel_time
+      
+        # The name of the backup being created through the copy operation. Values are of
+        # the form `projects//instances//backups/`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Encapsulates progress related information for a Cloud Spanner long running
+        # operation.
+        # Corresponds to the JSON property `progress`
+        # @return [Google::Apis::SpannerV1::OperationProgress]
+        attr_accessor :progress
+      
+        # The name of the source backup that is being copied. Values are of the form `
+        # projects//instances//backups/`.
+        # Corresponds to the JSON property `sourceBackup`
+        # @return [String]
+        attr_accessor :source_backup
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @cancel_time = args[:cancel_time] if args.key?(:cancel_time)
+          @name = args[:name] if args.key?(:name)
+          @progress = args[:progress] if args.key?(:progress)
+          @source_backup = args[:source_backup] if args.key?(:source_backup)
+        end
+      end
+      
+      # The request for CopyBackup.
+      class CopyBackupRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The id of the backup copy. The `backup_id` appended to `parent`
+        # forms the full backup_uri of the form `projects//instances//backups/`.
+        # Corresponds to the JSON property `backupId`
+        # @return [String]
+        attr_accessor :backup_id
+      
+        # Encryption configuration for the copied backup.
+        # Corresponds to the JSON property `encryptionConfig`
+        # @return [Google::Apis::SpannerV1::CopyBackupEncryptionConfig]
+        attr_accessor :encryption_config
+      
+        # Required. The expiration time of the backup in microsecond granularity. The
+        # expiration time must be at least 6 hours and at most 366 days from the `
+        # create_time` of the source backup. Once the `expire_time` has passed, the
+        # backup is eligible to be automatically deleted by Cloud Spanner to free the
+        # resources used by the backup.
+        # Corresponds to the JSON property `expireTime`
+        # @return [String]
+        attr_accessor :expire_time
+      
+        # Required. The source backup to be copied. The source backup needs to be in
+        # READY state for it to be copied. Once CopyBackup is in progress, the source
+        # backup cannot be deleted or cleaned up on expiration until CopyBackup is
+        # finished. Values are of the form: `projects//instances//backups/`.
+        # Corresponds to the JSON property `sourceBackup`
+        # @return [String]
+        attr_accessor :source_backup
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @backup_id = args[:backup_id] if args.key?(:backup_id)
+          @encryption_config = args[:encryption_config] if args.key?(:encryption_config)
+          @expire_time = args[:expire_time] if args.key?(:expire_time)
+          @source_backup = args[:source_backup] if args.key?(:source_backup)
+        end
+      end
+      
       # Metadata type for the operation returned by CreateBackup.
       class CreateBackupMetadata
         include Google::Apis::Core::Hashable
@@ -864,6 +1010,11 @@ module Google
         # @return [String]
         attr_accessor :create_statement
       
+        # Optional. The dialect of the Cloud Spanner Database.
+        # Corresponds to the JSON property `databaseDialect`
+        # @return [String]
+        attr_accessor :database_dialect
+      
         # Encryption configuration for a Cloud Spanner database.
         # Corresponds to the JSON property `encryptionConfig`
         # @return [Google::Apis::SpannerV1::EncryptionConfig]
@@ -884,6 +1035,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @create_statement = args[:create_statement] if args.key?(:create_statement)
+          @database_dialect = args[:database_dialect] if args.key?(:database_dialect)
           @encryption_config = args[:encryption_config] if args.key?(:encryption_config)
           @extra_statements = args[:extra_statements] if args.key?(:extra_statements)
         end
@@ -982,6 +1134,11 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
+        # Output only. The dialect of the Cloud Spanner Database.
+        # Corresponds to the JSON property `databaseDialect`
+        # @return [String]
+        attr_accessor :database_dialect
+      
         # Output only. The read-write region which contains the database's leader
         # replicas. This is the same as the value of default_leader database option set
         # using DatabaseAdmin.CreateDatabase or DatabaseAdmin.UpdateDatabaseDdl. If not
@@ -1046,6 +1203,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @create_time = args[:create_time] if args.key?(:create_time)
+          @database_dialect = args[:database_dialect] if args.key?(:database_dialect)
           @default_leader = args[:default_leader] if args.key?(:default_leader)
           @earliest_version_time = args[:earliest_version_time] if args.key?(:earliest_version_time)
           @encryption_config = args[:encryption_config] if args.key?(:encryption_config)
@@ -1639,6 +1797,11 @@ module Google
         # @return [String]
         attr_accessor :config
       
+        # Output only. The time at which the instance was created.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
         # Required. The descriptive name for this instance as it appears in UIs. Must be
         # unique per project and between 4 and 30 characters in length.
         # Corresponds to the JSON property `displayName`
@@ -1703,6 +1866,11 @@ module Google
         # @return [String]
         attr_accessor :state
       
+        # Output only. The time at which the instance was most recently updated.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1710,6 +1878,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @config = args[:config] if args.key?(:config)
+          @create_time = args[:create_time] if args.key?(:create_time)
           @display_name = args[:display_name] if args.key?(:display_name)
           @endpoint_uris = args[:endpoint_uris] if args.key?(:endpoint_uris)
           @labels = args[:labels] if args.key?(:labels)
@@ -1717,6 +1886,7 @@ module Google
           @node_count = args[:node_count] if args.key?(:node_count)
           @processing_units = args[:processing_units] if args.key?(:processing_units)
           @state = args[:state] if args.key?(:state)
+          @update_time = args[:update_time] if args.key?(:update_time)
         end
       end
       
@@ -1984,11 +2154,12 @@ module Google
         attr_accessor :next_page_token
       
         # The list of matching backup long-running operations. Each operation's name
-        # will be prefixed by the backup's name and the operation's metadata will be of
-        # type CreateBackupMetadata. Operations returned include those that are pending
-        # or have completed/failed/canceled within the last 7 days. Operations returned
-        # are ordered by `operation.metadata.value.progress.start_time` in descending
-        # order starting from the most recently started operation.
+        # will be prefixed by the backup's name. The operation's metadata field type `
+        # metadata.type_url` describes the type of the metadata. Operations returned
+        # include those that are pending or have completed/failed/canceled within the
+        # last 7 days. Operations returned are ordered by `operation.metadata.value.
+        # progress.start_time` in descending order starting from the most recently
+        # started operation.
         # Corresponds to the JSON property `operations`
         # @return [Array<Google::Apis::SpannerV1::Operation>]
         attr_accessor :operations
@@ -4583,6 +4754,16 @@ module Google
         # @return [Google::Apis::SpannerV1::StructType]
         attr_accessor :struct_type
       
+        # The TypeAnnotationCode that disambiguates SQL type that Spanner will use to
+        # represent values of this type during query processing. This is necessary for
+        # some type codes because a single TypeCode can be mapped to different SQL types
+        # depending on the SQL dialect. type_annotation typically is not needed to
+        # process the content of a value (it doesn't affect serialization) and clients
+        # can ignore it on the read path.
+        # Corresponds to the JSON property `typeAnnotation`
+        # @return [String]
+        attr_accessor :type_annotation
+      
         def initialize(**args)
            update!(**args)
         end
@@ -4592,6 +4773,7 @@ module Google
           @array_element_type = args[:array_element_type] if args.key?(:array_element_type)
           @code = args[:code] if args.key?(:code)
           @struct_type = args[:struct_type] if args.key?(:struct_type)
+          @type_annotation = args[:type_annotation] if args.key?(:type_annotation)
         end
       end
       

data/lib/google/apis/spanner_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module SpannerV1
       # Version of the google-apis-spanner_v1 gem
-      GEM_VERSION = "0.22.0"
+      GEM_VERSION = "0.25.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.4.0"
+      GENERATOR_VERSION = "0.4.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20211203"
+      REVISION = "20220310"
     end
   end
 end

data/lib/google/apis/spanner_v1/representations.rb

@@ -88,6 +88,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CopyBackupEncryptionConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class CopyBackupMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class CopyBackupRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class CreateBackupMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -639,10 +657,13 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :create_time, as: 'createTime'
           property :database, as: 'database'
+          property :database_dialect, as: 'databaseDialect'
           property :encryption_info, as: 'encryptionInfo', class: Google::Apis::SpannerV1::EncryptionInfo, decorator: Google::Apis::SpannerV1::EncryptionInfo::Representation
       
           property :expire_time, as: 'expireTime'
+          property :max_expire_time, as: 'maxExpireTime'
           property :name, as: 'name'
+          collection :referencing_backups, as: 'referencingBackups'
           collection :referencing_databases, as: 'referencingDatabases'
           property :size_bytes, :numeric_string => true, as: 'sizeBytes'
           property :state, as: 'state'
@@ -747,6 +768,36 @@ module Google
         end
       end
       
+      class CopyBackupEncryptionConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :encryption_type, as: 'encryptionType'
+          property :kms_key_name, as: 'kmsKeyName'
+        end
+      end
+      
+      class CopyBackupMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :cancel_time, as: 'cancelTime'
+          property :name, as: 'name'
+          property :progress, as: 'progress', class: Google::Apis::SpannerV1::OperationProgress, decorator: Google::Apis::SpannerV1::OperationProgress::Representation
+      
+          property :source_backup, as: 'sourceBackup'
+        end
+      end
+      
+      class CopyBackupRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :backup_id, as: 'backupId'
+          property :encryption_config, as: 'encryptionConfig', class: Google::Apis::SpannerV1::CopyBackupEncryptionConfig, decorator: Google::Apis::SpannerV1::CopyBackupEncryptionConfig::Representation
+      
+          property :expire_time, as: 'expireTime'
+          property :source_backup, as: 'sourceBackup'
+        end
+      end
+      
       class CreateBackupMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -769,6 +820,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :create_statement, as: 'createStatement'
+          property :database_dialect, as: 'databaseDialect'
           property :encryption_config, as: 'encryptionConfig', class: Google::Apis::SpannerV1::EncryptionConfig, decorator: Google::Apis::SpannerV1::EncryptionConfig::Representation
       
           collection :extra_statements, as: 'extraStatements'
@@ -807,6 +859,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :create_time, as: 'createTime'
+          property :database_dialect, as: 'databaseDialect'
           property :default_leader, as: 'defaultLeader'
           property :earliest_version_time, as: 'earliestVersionTime'
           property :encryption_config, as: 'encryptionConfig', class: Google::Apis::SpannerV1::EncryptionConfig, decorator: Google::Apis::SpannerV1::EncryptionConfig::Representation
@@ -980,6 +1033,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :config, as: 'config'
+          property :create_time, as: 'createTime'
           property :display_name, as: 'displayName'
           collection :endpoint_uris, as: 'endpointUris'
           hash :labels, as: 'labels'
@@ -987,6 +1041,7 @@ module Google
           property :node_count, as: 'nodeCount'
           property :processing_units, as: 'processingUnits'
           property :state, as: 'state'
+          property :update_time, as: 'updateTime'
         end
       end
       
@@ -1622,6 +1677,7 @@ module Google
           property :code, as: 'code'
           property :struct_type, as: 'structType', class: Google::Apis::SpannerV1::StructType, decorator: Google::Apis::SpannerV1::StructType::Representation
       
+          property :type_annotation, as: 'typeAnnotation'
         end
       end
       

data/lib/google/apis/spanner_v1/service.rb

@@ -482,20 +482,39 @@ module Google
         #   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 CreateBackupMetadata is `type.googleapis.com/google.spanner.admin.database.
-        #   v1.CreateBackupMetadata`. * `metadata.` - any field in metadata.value. * `
+        #   v1.CreateBackupMetadata`. * `metadata.` - any field in metadata.value. `
+        #   metadata.@type` must be specified first if filtering on metadata fields. * `
         #   error` - Error associated with the long-running operation. * `response.@type` -
         #   the type of response. * `response.` - any field in response.value. You can
         #   combine multiple expressions by enclosing each expression in parentheses. By
         #   default, expressions are combined with AND logic, but you can specify AND, OR,
         #   and NOT logic explicitly. Here are a few examples: * `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`
-        #   \ `(metadata.name:howl) AND` \ `(metadata.progress.start_time < \"2018-03-
-        #   28T14:50:00Z\") AND` \ `(error:*)` - Returns operations where: * The operation'
-        #   s metadata type is CreateBackupMetadata. * The backup name contains the string
-        #   "howl". * The operation started before 2018-03-28T14:50:00Z. * The operation
-        #   resulted in an error.
+        #   operation is complete. * `(metadata.@type=type.googleapis.com/google.spanner.
+        #   admin.database.v1.CreateBackupMetadata) AND` \ `metadata.database:prod` -
+        #   Returns operations where: * The operation's metadata type is
+        #   CreateBackupMetadata. * 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` \ `(metadata.name:howl)
+        #   AND` \ `(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND` \ `(
+        #   error:*)` - Returns operations where: * The operation's metadata type is
+        #   CreateBackupMetadata. * The backup name contains the string "howl". * The
+        #   operation started before 2018-03-28T14:50:00Z. * The operation resulted in an
+        #   error. * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.
+        #   CopyBackupMetadata) AND` \ `(metadata.source_backup:test) AND` \ `(metadata.
+        #   progress.start_time < \"2022-01-18T14:50:00Z\") AND` \ `(error:*)` - Returns
+        #   operations where: * The operation's metadata type is CopyBackupMetadata. * The
+        #   source backup of the copied backup name contains the string "test". * The
+        #   operation started before 2022-01-18T14:50:00Z. * The operation resulted in an
+        #   error. * `((metadata.@type=type.googleapis.com/google.spanner.admin.database.
+        #   v1.CreateBackupMetadata) AND` \ `(metadata.database:test_db)) OR` \ `((
+        #   metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.
+        #   CopyBackupMetadata) AND` \ `(metadata.source_backup:test_bkp)) AND` \ `(error:*
+        #   )` - Returns operations where: * The operation's metadata matches either of
+        #   criteria: * The operation's metadata type is CreateBackupMetadata AND the
+        #   database the backup was taken from has name containing string "test_db" * The
+        #   operation's metadata type is CopyBackupMetadata AND the backup the backup was
+        #   copied from has name containing string "test_bkp" * The operation resulted in
+        #   an error.
         # @param [Fixnum] page_size
         #   Number of operations to be returned in the response. If 0 or less, defaults to
         #   the server's maximum allowed page size.
@@ -532,6 +551,46 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Starts copying a Cloud Spanner Backup. The returned backup long-running
+        # operation will have a name of the format `projects//instances//backups//
+        # operations/` and can be used to track copying of the backup. The operation is
+        # associated with the destination backup. The metadata field type is
+        # CopyBackupMetadata. The response field type is Backup, if successful.
+        # Cancelling the returned operation will stop the copying and delete the backup.
+        # Concurrent CopyBackup requests can run on the same source backup.
+        # @param [String] parent
+        #   Required. The name of the destination instance that will contain the backup
+        #   copy. Values are of the form: `projects//instances/`.
+        # @param [Google::Apis::SpannerV1::CopyBackupRequest] copy_backup_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::SpannerV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::SpannerV1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def copy_backup(parent, copy_backup_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/backups:copy', options)
+          command.request_representation = Google::Apis::SpannerV1::CopyBackupRequest::Representation
+          command.request_object = copy_backup_request_object
+          command.response_representation = Google::Apis::SpannerV1::Operation::Representation
+          command.response_class = Google::Apis::SpannerV1::Operation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Starts creating a new Cloud Spanner Backup. The returned backup long-running
         # operation will have a name of the format `projects//instances//backups//
         # operations/` and can be used to track creation of the backup. The metadata
@@ -1041,7 +1100,8 @@ module Google
         #   true. * `metadata.@type` - the type of metadata. For example, the type string
         #   for RestoreDatabaseMetadata is `type.googleapis.com/google.spanner.admin.
         #   database.v1.RestoreDatabaseMetadata`. * `metadata.` - any field in metadata.
-        #   value. * `error` - Error associated with the long-running operation. * `
+        #   value. `metadata.@type` must be specified first, if filtering on metadata
+        #   fields. * `error` - Error associated with the long-running operation. * `
         #   response.@type` - the type of response. * `response.` - any field in response.
         #   value. You can combine multiple expressions by enclosing each expression in
         #   parentheses. By default, expressions are combined with AND logic. However, you

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-spanner_v1
 version: !ruby/object:Gem::Version
-  version: 0.22.0
+  version: 0.25.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-10 00:00:00.000000000 Z
+date: 2022-03-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-spanner_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.22.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.25.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-spanner_v1
 post_install_message: 
 rdoc_options: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.4
+rubygems_version: 3.3.5
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Cloud Spanner API V1