google-apis-spanner_v1 0.24.0 → 0.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d21118bfea939956c650168df9b62ec3b03602e086c44ac41b9091242a624c9b
-  data.tar.gz: d1f8512a386fa6a10656f8edc4e9de1e3a0be5a2f7e3b51b9c49e8e578d567ba
+  metadata.gz: 51541562e98ca4e9c993afc467f0a98ff8adaa1eda1805c36bafd9997211b2bc
+  data.tar.gz: ddae8e9f8a2915b8462b04e92914d52f13e1707953dd55bb887473a9e2ba773a
 SHA512:
-  metadata.gz: 85476a117c020df05d7f1cfa7f7932277bef795df67d90cdb0f831602256ff04ef6859e1eb252c9583d383493b69b31c7264bb307928a88546e93c18b34e0688
-  data.tar.gz: a0142e2d38dc8398b5560b60c43b4bd07e79b84f4e27b0aa9950522fded71c631cac300c05728261ca93de9f34211277810811ddbd532946c83aba1111e8ce6a
+  metadata.gz: dc983c308f4d10749bbf5e7fb820069f8644ba3afb151c60f8f2ae15522aa813c3de799f45b359ec142103b5aee7c7bfe45f0f9dba9e0d4180b274f9953f816e
+  data.tar.gz: 8db003dacedd2fd9421d39537dfd0504241013e30a08eec8951b3e8f0a99ea8916086b55829e532ceca0386a8f99f6f70d2cfeb71bae1ac3b56c49cc859bea3b

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # 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

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

@@ -59,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
@@ -70,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
@@ -108,7 +127,9 @@ module Google
           @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)
@@ -793,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
@@ -1657,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`
@@ -1721,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
@@ -1728,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)
@@ -1735,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
       

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.24.0"
+      GEM_VERSION = "0.25.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.4.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20220212"
+      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
       
@@ -643,7 +661,9 @@ module Google
           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'
@@ -748,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
@@ -983,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'
@@ -990,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
       

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

@@ -499,7 +499,22 @@ module Google
         #   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.
+        #   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.
@@ -536,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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-spanner_v1
 version: !ruby/object:Gem::Version
-  version: 0.24.0
+  version: 0.25.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-28 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.24.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: []