google-apis-spanner_v1 0.1.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 625e4ebcbf0da1d443e489addb6607a46b0dda44997b096f81f78a1b2a66f55e
-  data.tar.gz: 26c8f98f6954b9cf6d8ed56eec3cc58ff07637fe5dc9563c7151799ae64e35e4
+  metadata.gz: f99ff9f6821502c873da0a908d418d033a1f6d9baff866c14287c1b6e5d4a1fb
+  data.tar.gz: ee944ff1114fdedcddf45fd62a9e5713e46118bfa87356193ca619f0b4ab54da
 SHA512:
-  metadata.gz: 0d1137d4f8a15222bdb338a4ab275fe3510af66e805697ffbd0b5f32664f421bb492105aee1fe069b884d0b8ab29c35cdd259e4cb05187331323f2bb64dc16e8
-  data.tar.gz: 57b20be9d4bf8e90d7bbd7787099db71b2b57952abd3eb5ecb18649a106ef7a65090aacc2c01652e7543277a87f3e9cdf8a1af7155201410d9bfecdc262cebda
+  metadata.gz: 3b00aa6d4ba8ed6403127765bb9f86126791f6a9ff3b3f20f65986d6304a295f4d50478d60639f459cc817920673a6db06a970c99f30302f86b1f18157edbbea
+  data.tar.gz: f2afbdbc190d30b4824c01f09ac50d841638e2b0fc6d9b61f505bc128fa1fd986091b753c92f256e9677da2e8dd12406ed50942ea63f96e9d0b46857dab61c88

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Release history for google-apis-spanner_v1
 
+### v0.6.0 (2021-03-13)
+
+* Regenerated from discovery document revision 20210309
+* Regenerated using generator version 0.2.0
+
+### v0.5.0 (2021-03-04)
+
+* Unspecified changes
+
+### v0.4.0 (2021-02-24)
+
+* Regenerated from discovery document revision 20210217
+
+### v0.3.0 (2021-02-13)
+
+* Regenerated from discovery document revision 20210206
+
+### v0.2.0 (2021-01-28)
+
+* Regenerated from discovery document revision 20210123
+* Regenerated using generator version 0.1.2
+
 ### v0.1.0 (2021-01-07)
 
 * Regenerated using generator version 0.1.1

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

@@ -26,9 +26,9 @@ module Google
       class Backup
         include Google::Apis::Core::Hashable
       
-        # Output only. The backup will contain an externally consistent copy of the
-        # database at the timestamp specified by `create_time`. `create_time` is
-        # approximately the time the CreateBackup request is received.
+        # Output only. The time the CreateBackup request is received. If the request
+        # does not specify `version_time`, the `version_time` of the backup will be
+        # equivalent to the `create_time`.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
@@ -40,6 +40,11 @@ module Google
         # @return [String]
         attr_accessor :database
       
+        # Encryption information for a Cloud Spanner database or backup.
+        # Corresponds to the JSON property `encryptionInfo`
+        # @return [Google::Apis::SpannerV1::EncryptionInfo]
+        attr_accessor :encryption_info
+      
         # Required for the CreateBackup operation. The expiration time of the backup,
         # with microseconds granularity that must be at least 6 hours and at most 366
         # days from the time the CreateBackup request is processed. Once the `
@@ -80,6 +85,13 @@ module Google
         # @return [String]
         attr_accessor :state
       
+        # The backup will contain an externally consistent copy of the database at the
+        # timestamp specified by `version_time`. If `version_time` is not specified, the
+        # system will set `version_time` to the `create_time` of the backup.
+        # Corresponds to the JSON property `versionTime`
+        # @return [String]
+        attr_accessor :version_time
+      
         def initialize(**args)
            update!(**args)
         end
@@ -88,11 +100,13 @@ module Google
         def update!(**args)
           @create_time = args[:create_time] if args.key?(:create_time)
           @database = args[:database] if args.key?(:database)
+          @encryption_info = args[:encryption_info] if args.key?(:encryption_info)
           @expire_time = args[:expire_time] if args.key?(:expire_time)
           @name = args[:name] if args.key?(:name)
           @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)
+          @version_time = args[:version_time] if args.key?(:version_time)
         end
       end
       
@@ -105,8 +119,7 @@ module Google
         # @return [String]
         attr_accessor :backup
       
-        # The backup contains an externally consistent copy of `source_database` at the
-        # timestamp specified by `create_time`.
+        # The time the CreateBackup request was received.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
@@ -116,6 +129,14 @@ module Google
         # @return [String]
         attr_accessor :source_database
       
+        # The backup contains an externally consistent copy of `source_database` at the
+        # timestamp specified by `version_time`. If the CreateBackup request did not
+        # specify `version_time`, the `version_time` of the backup is equivalent to the `
+        # create_time`.
+        # Corresponds to the JSON property `versionTime`
+        # @return [String]
+        attr_accessor :version_time
+      
         def initialize(**args)
            update!(**args)
         end
@@ -125,6 +146,7 @@ module Google
           @backup = args[:backup] if args.key?(:backup)
           @create_time = args[:create_time] if args.key?(:create_time)
           @source_database = args[:source_database] if args.key?(:source_database)
+          @version_time = args[:version_time] if args.key?(:version_time)
         end
       end
       
@@ -212,7 +234,7 @@ module Google
         # inactivity at the client may cause Cloud Spanner to release a transaction's
         # locks and abort it. Conceptually, a read-write transaction consists of zero or
         # more reads or SQL statements followed by Commit. At any time before Commit,
-        # the client can send a Rollback request to abort the transaction. ### Semantics
+        # the client can send a Rollback request to abort the transaction. ## Semantics
         # Cloud Spanner can commit the transaction if all read locks it acquired are
         # still valid at commit time, and it is able to acquire write locks for all
         # writes. Cloud Spanner can abort the transaction for any reason. If a commit
@@ -220,7 +242,7 @@ module Google
         # not modified any user data in Cloud Spanner. Unless the transaction commits,
         # Cloud Spanner makes no guarantees about how long the transaction's locks were
         # held for. It is an error to use Cloud Spanner locks for any sort of mutual
-        # exclusion other than between Cloud Spanner transactions themselves. ###
+        # exclusion other than between Cloud Spanner transactions themselves. ##
         # Retrying Aborted Transactions When a transaction aborts, the application can
         # choose to retry the whole transaction again. To maximize the chances of
         # successfully committing the retry, the client should execute the retry in the
@@ -231,7 +253,7 @@ module Google
         # can abort many times in a short period before successfully committing. Thus,
         # it is not a good idea to cap the number of retries a transaction can attempt;
         # instead, it is better to limit the total amount of wall time spent retrying. ##
-        # # Idle Transactions A transaction is considered idle if it has no outstanding
+        # Idle Transactions A transaction is considered idle if it has no outstanding
         # reads or SQL queries and has not started a read or SQL query within the last
         # 10 seconds. Idle transactions can be aborted by Cloud Spanner so that they don'
         # t hold on to locks indefinitely. In that case, the commit will fail with error
@@ -255,7 +277,7 @@ module Google
         # is geographically distributed, stale read-only transactions can execute more
         # quickly than strong or read-write transaction, because they are able to
         # execute far from the leader replica. Each type of timestamp bound is discussed
-        # in detail below. ### Strong Strong reads are guaranteed to see the effects of
+        # in detail below. ## Strong Strong reads are guaranteed to see the effects of
         # all transactions that have committed before the start of the read. Furthermore,
         # all rows yielded by a single read are consistent with each other -- if any
         # part of the read observes a transaction, all parts of the read see the
@@ -263,7 +285,7 @@ module Google
         # transactions might return inconsistent results if there are concurrent writes.
         # If consistency across reads is required, the reads should be executed within a
         # transaction or at an exact read timestamp. See TransactionOptions.ReadOnly.
-        # strong. ### Exact Staleness These timestamp bounds execute reads at a user-
+        # strong. ## Exact Staleness These timestamp bounds execute reads at a user-
         # specified timestamp. Reads at a timestamp are guaranteed to see a consistent
         # prefix of the global transaction history: they observe modifications done by
         # all transactions with a commit timestamp <= the read timestamp, and observe
@@ -275,7 +297,7 @@ module Google
         # to pick a timestamp. As a result, they execute slightly faster than the
         # equivalent boundedly stale concurrency modes. On the other hand, boundedly
         # stale reads usually return fresher results. See TransactionOptions.ReadOnly.
-        # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ### Bounded
+        # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ## Bounded
         # Staleness Bounded staleness modes allow Cloud Spanner to pick the read
         # timestamp, subject to a user-provided staleness bound. Cloud Spanner chooses
         # the newest timestamp within the staleness bound that allows execution of the
@@ -293,7 +315,7 @@ module Google
         # timestamp negotiation requires up-front knowledge of which rows will be read,
         # it can only be used with single-use read-only transactions. See
         # TransactionOptions.ReadOnly.max_staleness and TransactionOptions.ReadOnly.
-        # min_read_timestamp. ### Old Read Timestamps and Garbage Collection Cloud
+        # min_read_timestamp. ## Old Read Timestamps and Garbage Collection Cloud
         # Spanner continuously garbage collects deleted and overwritten data in the
         # background to reclaim storage space. This process is known as "version GC". By
         # default, version GC reclaims versions after they are one hour old. Because of
@@ -472,6 +494,13 @@ module Google
         # @return [Array<Google::Apis::SpannerV1::Mutation>]
         attr_accessor :mutations
       
+        # If `true`, then statistics related to the transaction will be included in the
+        # CommitResponse. Default value is `false`.
+        # Corresponds to the JSON property `returnCommitStats`
+        # @return [Boolean]
+        attr_accessor :return_commit_stats
+        alias_method :return_commit_stats?, :return_commit_stats
+      
         # # Transactions Each session can have at most one active transaction at a time (
         # note that standalone reads and queries use a transaction internally and do
         # count towards the one transaction limit). After the active transaction is
@@ -505,7 +534,7 @@ module Google
         # inactivity at the client may cause Cloud Spanner to release a transaction's
         # locks and abort it. Conceptually, a read-write transaction consists of zero or
         # more reads or SQL statements followed by Commit. At any time before Commit,
-        # the client can send a Rollback request to abort the transaction. ### Semantics
+        # the client can send a Rollback request to abort the transaction. ## Semantics
         # Cloud Spanner can commit the transaction if all read locks it acquired are
         # still valid at commit time, and it is able to acquire write locks for all
         # writes. Cloud Spanner can abort the transaction for any reason. If a commit
@@ -513,7 +542,7 @@ module Google
         # not modified any user data in Cloud Spanner. Unless the transaction commits,
         # Cloud Spanner makes no guarantees about how long the transaction's locks were
         # held for. It is an error to use Cloud Spanner locks for any sort of mutual
-        # exclusion other than between Cloud Spanner transactions themselves. ###
+        # exclusion other than between Cloud Spanner transactions themselves. ##
         # Retrying Aborted Transactions When a transaction aborts, the application can
         # choose to retry the whole transaction again. To maximize the chances of
         # successfully committing the retry, the client should execute the retry in the
@@ -524,7 +553,7 @@ module Google
         # can abort many times in a short period before successfully committing. Thus,
         # it is not a good idea to cap the number of retries a transaction can attempt;
         # instead, it is better to limit the total amount of wall time spent retrying. ##
-        # # Idle Transactions A transaction is considered idle if it has no outstanding
+        # Idle Transactions A transaction is considered idle if it has no outstanding
         # reads or SQL queries and has not started a read or SQL query within the last
         # 10 seconds. Idle transactions can be aborted by Cloud Spanner so that they don'
         # t hold on to locks indefinitely. In that case, the commit will fail with error
@@ -548,7 +577,7 @@ module Google
         # is geographically distributed, stale read-only transactions can execute more
         # quickly than strong or read-write transaction, because they are able to
         # execute far from the leader replica. Each type of timestamp bound is discussed
-        # in detail below. ### Strong Strong reads are guaranteed to see the effects of
+        # in detail below. ## Strong Strong reads are guaranteed to see the effects of
         # all transactions that have committed before the start of the read. Furthermore,
         # all rows yielded by a single read are consistent with each other -- if any
         # part of the read observes a transaction, all parts of the read see the
@@ -556,7 +585,7 @@ module Google
         # transactions might return inconsistent results if there are concurrent writes.
         # If consistency across reads is required, the reads should be executed within a
         # transaction or at an exact read timestamp. See TransactionOptions.ReadOnly.
-        # strong. ### Exact Staleness These timestamp bounds execute reads at a user-
+        # strong. ## Exact Staleness These timestamp bounds execute reads at a user-
         # specified timestamp. Reads at a timestamp are guaranteed to see a consistent
         # prefix of the global transaction history: they observe modifications done by
         # all transactions with a commit timestamp <= the read timestamp, and observe
@@ -568,7 +597,7 @@ module Google
         # to pick a timestamp. As a result, they execute slightly faster than the
         # equivalent boundedly stale concurrency modes. On the other hand, boundedly
         # stale reads usually return fresher results. See TransactionOptions.ReadOnly.
-        # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ### Bounded
+        # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ## Bounded
         # Staleness Bounded staleness modes allow Cloud Spanner to pick the read
         # timestamp, subject to a user-provided staleness bound. Cloud Spanner chooses
         # the newest timestamp within the staleness bound that allows execution of the
@@ -586,7 +615,7 @@ module Google
         # timestamp negotiation requires up-front knowledge of which rows will be read,
         # it can only be used with single-use read-only transactions. See
         # TransactionOptions.ReadOnly.max_staleness and TransactionOptions.ReadOnly.
-        # min_read_timestamp. ### Old Read Timestamps and Garbage Collection Cloud
+        # min_read_timestamp. ## Old Read Timestamps and Garbage Collection Cloud
         # Spanner continuously garbage collects deleted and overwritten data in the
         # background to reclaim storage space. This process is known as "version GC". By
         # default, version GC reclaims versions after they are one hour old. Because of
@@ -648,6 +677,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @mutations = args[:mutations] if args.key?(:mutations)
+          @return_commit_stats = args[:return_commit_stats] if args.key?(:return_commit_stats)
           @single_use_transaction = args[:single_use_transaction] if args.key?(:single_use_transaction)
           @transaction_id = args[:transaction_id] if args.key?(:transaction_id)
         end
@@ -657,6 +687,11 @@ module Google
       class CommitResponse
         include Google::Apis::Core::Hashable
       
+        # Additional statistics about a commit.
+        # Corresponds to the JSON property `commitStats`
+        # @return [Google::Apis::SpannerV1::CommitStats]
+        attr_accessor :commit_stats
+      
         # The Cloud Spanner timestamp at which the transaction committed.
         # Corresponds to the JSON property `commitTimestamp`
         # @return [String]
@@ -668,10 +703,37 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @commit_stats = args[:commit_stats] if args.key?(:commit_stats)
           @commit_timestamp = args[:commit_timestamp] if args.key?(:commit_timestamp)
         end
       end
       
+      # Additional statistics about a commit.
+      class CommitStats
+        include Google::Apis::Core::Hashable
+      
+        # The total number of mutations for the transaction. Knowing the `mutation_count`
+        # value can help you maximize the number of mutations in a transaction and
+        # minimize the number of API round trips. You can also monitor this value to
+        # prevent transactions from exceeding the system [limit](http://cloud.google.com/
+        # spanner/quotas#limits_for_creating_reading_updating_and_deleting_data). If the
+        # number of mutations exceeds the limit, the server returns [INVALID_ARGUMENT](
+        # http://cloud.google.com/spanner/docs/reference/rest/v1/Code#ENUM_VALUES.
+        # INVALID_ARGUMENT).
+        # Corresponds to the JSON property `mutationCount`
+        # @return [Fixnum]
+        attr_accessor :mutation_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @mutation_count = args[:mutation_count] if args.key?(:mutation_count)
+        end
+      end
+      
       # Metadata type for the operation returned by CreateBackup.
       class CreateBackupMetadata
         include Google::Apis::Core::Hashable
@@ -749,6 +811,11 @@ module Google
         # @return [String]
         attr_accessor :create_statement
       
+        # Encryption configuration for a Cloud Spanner database.
+        # Corresponds to the JSON property `encryptionConfig`
+        # @return [Google::Apis::SpannerV1::EncryptionConfig]
+        attr_accessor :encryption_config
+      
         # Optional. A list of DDL statements to run inside the newly created database.
         # Statements can create tables, indexes, etc. These statements execute
         # atomically with the creation of the database: if there is an error in any
@@ -764,6 +831,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @create_statement = args[:create_statement] if args.key?(:create_statement)
+          @encryption_config = args[:encryption_config] if args.key?(:encryption_config)
           @extra_statements = args[:extra_statements] if args.key?(:extra_statements)
         end
       end
@@ -861,6 +929,30 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
+        # Output only. Earliest timestamp at which older versions of the data can be
+        # read. This value is continuously updated by Cloud Spanner and becomes stale
+        # the moment it is queried. If you are using this value to recover data, make
+        # sure to account for the time from the moment when the value is queried to the
+        # moment when you initiate the recovery.
+        # Corresponds to the JSON property `earliestVersionTime`
+        # @return [String]
+        attr_accessor :earliest_version_time
+      
+        # Encryption configuration for a Cloud Spanner database.
+        # Corresponds to the JSON property `encryptionConfig`
+        # @return [Google::Apis::SpannerV1::EncryptionConfig]
+        attr_accessor :encryption_config
+      
+        # Output only. For databases that are using customer managed encryption, this
+        # field contains the encryption information for the database, such as encryption
+        # state and the Cloud KMS key versions that are in use. For databases that are
+        # using Google default or other types of encryption, this field is empty. This
+        # field is propagated lazily from the backend. There might be a delay from when
+        # a key version is being used and when it appears in this field.
+        # Corresponds to the JSON property `encryptionInfo`
+        # @return [Array<Google::Apis::SpannerV1::EncryptionInfo>]
+        attr_accessor :encryption_info
+      
         # Required. The name of the database. Values are of the form `projects//
         # instances//databases/`, where `` is as specified in the `CREATE DATABASE`
         # statement. This name can be passed to other API methods to identify the
@@ -879,6 +971,13 @@ module Google
         # @return [String]
         attr_accessor :state
       
+        # Output only. The period in which Cloud Spanner retains all versions of data
+        # for the database. This is the same as the value of version_retention_period
+        # database option set using UpdateDatabaseDdl. Defaults to 1 hour, if not set.
+        # Corresponds to the JSON property `versionRetentionPeriod`
+        # @return [String]
+        attr_accessor :version_retention_period
+      
         def initialize(**args)
            update!(**args)
         end
@@ -886,9 +985,13 @@ module Google
         # Update properties of this object
         def update!(**args)
           @create_time = args[:create_time] if args.key?(:create_time)
+          @earliest_version_time = args[:earliest_version_time] if args.key?(:earliest_version_time)
+          @encryption_config = args[:encryption_config] if args.key?(:encryption_config)
+          @encryption_info = args[:encryption_info] if args.key?(:encryption_info)
           @name = args[:name] if args.key?(:name)
           @restore_info = args[:restore_info] if args.key?(:restore_info)
           @state = args[:state] if args.key?(:state)
+          @version_retention_period = args[:version_retention_period] if args.key?(:version_retention_period)
         end
       end
       
@@ -938,6 +1041,63 @@ module Google
         end
       end
       
+      # Encryption configuration for a Cloud Spanner database.
+      class EncryptionConfig
+        include Google::Apis::Core::Hashable
+      
+        # The Cloud KMS key to be used for encrypting and decrypting the database.
+        # 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)
+          @kms_key_name = args[:kms_key_name] if args.key?(:kms_key_name)
+        end
+      end
+      
+      # Encryption information for a Cloud Spanner database or backup.
+      class EncryptionInfo
+        include Google::Apis::Core::Hashable
+      
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
+        # Corresponds to the JSON property `encryptionStatus`
+        # @return [Google::Apis::SpannerV1::Status]
+        attr_accessor :encryption_status
+      
+        # Output only. The type of encryption.
+        # Corresponds to the JSON property `encryptionType`
+        # @return [String]
+        attr_accessor :encryption_type
+      
+        # Output only. A Cloud KMS key version that is being used to protect the
+        # database or backup.
+        # Corresponds to the JSON property `kmsKeyVersion`
+        # @return [String]
+        attr_accessor :kms_key_version
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @encryption_status = args[:encryption_status] if args.key?(:encryption_status)
+          @encryption_type = args[:encryption_type] if args.key?(:encryption_type)
+          @kms_key_version = args[:kms_key_version] if args.key?(:kms_key_version)
+        end
+      end
+      
       # The request for ExecuteBatchDml.
       class ExecuteBatchDmlRequest
         include Google::Apis::Core::Hashable
@@ -1652,6 +1812,12 @@ module Google
         # @return [String]
         attr_accessor :next_page_token
       
+        # The list of unreachable instances. It includes the names of instances whose
+        # metadata could not be retrieved within instance_deadline.
+        # Corresponds to the JSON property `unreachable`
+        # @return [Array<String>]
+        attr_accessor :unreachable
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1660,6 +1826,7 @@ module Google
         def update!(**args)
           @instances = args[:instances] if args.key?(:instances)
           @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @unreachable = args[:unreachable] if args.key?(:unreachable)
         end
       end
       
@@ -2326,18 +2493,33 @@ module Google
       class QueryOptions
         include Google::Apis::Core::Hashable
       
+        # Query optimizer statistics package to use. This parameter allows individual
+        # queries to use a different query optimizer statistics. Specifying `latest` as
+        # a value instructs Cloud Spanner to use the latest generated statistics package.
+        # If not specified, Cloud Spanner uses statistics package set at the database
+        # level options, or latest if the database option is not set. The statistics
+        # package requested by the query has to be exempt from garbage collection. This
+        # can be achieved with the following DDL statement: ``` ALTER STATISTICS SET
+        # OPTIONS (allow_gc=false) ``` The list of available statistics packages can be
+        # queried from `SPANNER_SYS.OPTIMIZER_STATISTICS_PACKAGES`. Executing a SQL
+        # statement with an invalid optimizer statistics package or with statistics
+        # package that allows garbage collection fails with an `INVALID_ARGUMENT` error.
+        # Corresponds to the JSON property `optimizerStatisticsPackage`
+        # @return [String]
+        attr_accessor :optimizer_statistics_package
+      
         # An option to control the selection of optimizer version. This parameter allows
-        # individual queries to pick different query optimizer versions. Specifying "
-        # latest" as a value instructs Cloud Spanner to use the latest supported query
-        # optimizer version. If not specified, Cloud Spanner uses optimizer version set
-        # at the database level options. Any other positive integer (from the list of
-        # supported optimizer versions) overrides the default optimizer version for
+        # individual queries to pick different query optimizer versions. Specifying `
+        # latest` as a value instructs Cloud Spanner to use the latest supported query
+        # optimizer version. If not specified, Cloud Spanner uses the optimizer version
+        # set at the database level options. Any other positive integer (from the list
+        # of supported optimizer versions) overrides the default optimizer version for
         # query execution. The list of supported optimizer versions can be queried from
         # SPANNER_SYS.SUPPORTED_OPTIMIZER_VERSIONS. Executing a SQL statement with an
-        # invalid optimizer version will fail with a syntax error (`INVALID_ARGUMENT`)
-        # status. See https://cloud.google.com/spanner/docs/query-optimizer/manage-query-
-        # optimizer for more information on managing the query optimizer. The `
-        # optimizer_version` statement hint has precedence over this setting.
+        # invalid optimizer version fails with an `INVALID_ARGUMENT` error. See https://
+        # cloud.google.com/spanner/docs/query-optimizer/manage-query-optimizer for more
+        # information on managing the query optimizer. The `optimizer_version` statement
+        # hint has precedence over this setting.
         # Corresponds to the JSON property `optimizerVersion`
         # @return [String]
         attr_accessor :optimizer_version
@@ -2348,6 +2530,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @optimizer_statistics_package = args[:optimizer_statistics_package] if args.key?(:optimizer_statistics_package)
           @optimizer_version = args[:optimizer_version] if args.key?(:optimizer_version)
         end
       end
@@ -2576,6 +2759,34 @@ module Google
         end
       end
       
+      # Encryption configuration for the restored database.
+      class RestoreDatabaseEncryptionConfig
+        include Google::Apis::Core::Hashable
+      
+        # Required. The encryption type of the restored database.
+        # Corresponds to the JSON property `encryptionType`
+        # @return [String]
+        attr_accessor :encryption_type
+      
+        # Optional. The Cloud KMS key that will be used to encrypt/decrypt the restored
+        # database. 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 long-running operation returned by RestoreDatabase.
       class RestoreDatabaseMetadata
         include Google::Apis::Core::Hashable
@@ -2658,6 +2869,11 @@ module Google
         # @return [String]
         attr_accessor :database_id
       
+        # Encryption configuration for the restored database.
+        # Corresponds to the JSON property `encryptionConfig`
+        # @return [Google::Apis::SpannerV1::RestoreDatabaseEncryptionConfig]
+        attr_accessor :encryption_config
+      
         def initialize(**args)
            update!(**args)
         end
@@ -2666,6 +2882,7 @@ module Google
         def update!(**args)
           @backup = args[:backup] if args.key?(:backup)
           @database_id = args[:database_id] if args.key?(:database_id)
+          @encryption_config = args[:encryption_config] if args.key?(:encryption_config)
         end
       end
       
@@ -3135,7 +3352,7 @@ module Google
       # inactivity at the client may cause Cloud Spanner to release a transaction's
       # locks and abort it. Conceptually, a read-write transaction consists of zero or
       # more reads or SQL statements followed by Commit. At any time before Commit,
-      # the client can send a Rollback request to abort the transaction. ### Semantics
+      # the client can send a Rollback request to abort the transaction. ## Semantics
       # Cloud Spanner can commit the transaction if all read locks it acquired are
       # still valid at commit time, and it is able to acquire write locks for all
       # writes. Cloud Spanner can abort the transaction for any reason. If a commit
@@ -3143,7 +3360,7 @@ module Google
       # not modified any user data in Cloud Spanner. Unless the transaction commits,
       # Cloud Spanner makes no guarantees about how long the transaction's locks were
       # held for. It is an error to use Cloud Spanner locks for any sort of mutual
-      # exclusion other than between Cloud Spanner transactions themselves. ###
+      # exclusion other than between Cloud Spanner transactions themselves. ##
       # Retrying Aborted Transactions When a transaction aborts, the application can
       # choose to retry the whole transaction again. To maximize the chances of
       # successfully committing the retry, the client should execute the retry in the
@@ -3154,7 +3371,7 @@ module Google
       # can abort many times in a short period before successfully committing. Thus,
       # it is not a good idea to cap the number of retries a transaction can attempt;
       # instead, it is better to limit the total amount of wall time spent retrying. ##
-      # # Idle Transactions A transaction is considered idle if it has no outstanding
+      # Idle Transactions A transaction is considered idle if it has no outstanding
       # reads or SQL queries and has not started a read or SQL query within the last
       # 10 seconds. Idle transactions can be aborted by Cloud Spanner so that they don'
       # t hold on to locks indefinitely. In that case, the commit will fail with error
@@ -3178,7 +3395,7 @@ module Google
       # is geographically distributed, stale read-only transactions can execute more
       # quickly than strong or read-write transaction, because they are able to
       # execute far from the leader replica. Each type of timestamp bound is discussed
-      # in detail below. ### Strong Strong reads are guaranteed to see the effects of
+      # in detail below. ## Strong Strong reads are guaranteed to see the effects of
       # all transactions that have committed before the start of the read. Furthermore,
       # all rows yielded by a single read are consistent with each other -- if any
       # part of the read observes a transaction, all parts of the read see the
@@ -3186,7 +3403,7 @@ module Google
       # transactions might return inconsistent results if there are concurrent writes.
       # If consistency across reads is required, the reads should be executed within a
       # transaction or at an exact read timestamp. See TransactionOptions.ReadOnly.
-      # strong. ### Exact Staleness These timestamp bounds execute reads at a user-
+      # strong. ## Exact Staleness These timestamp bounds execute reads at a user-
       # specified timestamp. Reads at a timestamp are guaranteed to see a consistent
       # prefix of the global transaction history: they observe modifications done by
       # all transactions with a commit timestamp <= the read timestamp, and observe
@@ -3198,7 +3415,7 @@ module Google
       # to pick a timestamp. As a result, they execute slightly faster than the
       # equivalent boundedly stale concurrency modes. On the other hand, boundedly
       # stale reads usually return fresher results. See TransactionOptions.ReadOnly.
-      # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ### Bounded
+      # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ## Bounded
       # Staleness Bounded staleness modes allow Cloud Spanner to pick the read
       # timestamp, subject to a user-provided staleness bound. Cloud Spanner chooses
       # the newest timestamp within the staleness bound that allows execution of the
@@ -3216,7 +3433,7 @@ module Google
       # timestamp negotiation requires up-front knowledge of which rows will be read,
       # it can only be used with single-use read-only transactions. See
       # TransactionOptions.ReadOnly.max_staleness and TransactionOptions.ReadOnly.
-      # min_read_timestamp. ### Old Read Timestamps and Garbage Collection Cloud
+      # min_read_timestamp. ## Old Read Timestamps and Garbage Collection Cloud
       # Spanner continuously garbage collects deleted and overwritten data in the
       # background to reclaim storage space. This process is known as "version GC". By
       # default, version GC reclaims versions after they are one hour old. Because of
@@ -3330,7 +3547,7 @@ module Google
         # inactivity at the client may cause Cloud Spanner to release a transaction's
         # locks and abort it. Conceptually, a read-write transaction consists of zero or
         # more reads or SQL statements followed by Commit. At any time before Commit,
-        # the client can send a Rollback request to abort the transaction. ### Semantics
+        # the client can send a Rollback request to abort the transaction. ## Semantics
         # Cloud Spanner can commit the transaction if all read locks it acquired are
         # still valid at commit time, and it is able to acquire write locks for all
         # writes. Cloud Spanner can abort the transaction for any reason. If a commit
@@ -3338,7 +3555,7 @@ module Google
         # not modified any user data in Cloud Spanner. Unless the transaction commits,
         # Cloud Spanner makes no guarantees about how long the transaction's locks were
         # held for. It is an error to use Cloud Spanner locks for any sort of mutual
-        # exclusion other than between Cloud Spanner transactions themselves. ###
+        # exclusion other than between Cloud Spanner transactions themselves. ##
         # Retrying Aborted Transactions When a transaction aborts, the application can
         # choose to retry the whole transaction again. To maximize the chances of
         # successfully committing the retry, the client should execute the retry in the
@@ -3349,7 +3566,7 @@ module Google
         # can abort many times in a short period before successfully committing. Thus,
         # it is not a good idea to cap the number of retries a transaction can attempt;
         # instead, it is better to limit the total amount of wall time spent retrying. ##
-        # # Idle Transactions A transaction is considered idle if it has no outstanding
+        # Idle Transactions A transaction is considered idle if it has no outstanding
         # reads or SQL queries and has not started a read or SQL query within the last
         # 10 seconds. Idle transactions can be aborted by Cloud Spanner so that they don'
         # t hold on to locks indefinitely. In that case, the commit will fail with error
@@ -3373,7 +3590,7 @@ module Google
         # is geographically distributed, stale read-only transactions can execute more
         # quickly than strong or read-write transaction, because they are able to
         # execute far from the leader replica. Each type of timestamp bound is discussed
-        # in detail below. ### Strong Strong reads are guaranteed to see the effects of
+        # in detail below. ## Strong Strong reads are guaranteed to see the effects of
         # all transactions that have committed before the start of the read. Furthermore,
         # all rows yielded by a single read are consistent with each other -- if any
         # part of the read observes a transaction, all parts of the read see the
@@ -3381,7 +3598,7 @@ module Google
         # transactions might return inconsistent results if there are concurrent writes.
         # If consistency across reads is required, the reads should be executed within a
         # transaction or at an exact read timestamp. See TransactionOptions.ReadOnly.
-        # strong. ### Exact Staleness These timestamp bounds execute reads at a user-
+        # strong. ## Exact Staleness These timestamp bounds execute reads at a user-
         # specified timestamp. Reads at a timestamp are guaranteed to see a consistent
         # prefix of the global transaction history: they observe modifications done by
         # all transactions with a commit timestamp <= the read timestamp, and observe
@@ -3393,7 +3610,7 @@ module Google
         # to pick a timestamp. As a result, they execute slightly faster than the
         # equivalent boundedly stale concurrency modes. On the other hand, boundedly
         # stale reads usually return fresher results. See TransactionOptions.ReadOnly.
-        # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ### Bounded
+        # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ## Bounded
         # Staleness Bounded staleness modes allow Cloud Spanner to pick the read
         # timestamp, subject to a user-provided staleness bound. Cloud Spanner chooses
         # the newest timestamp within the staleness bound that allows execution of the
@@ -3411,7 +3628,7 @@ module Google
         # timestamp negotiation requires up-front knowledge of which rows will be read,
         # it can only be used with single-use read-only transactions. See
         # TransactionOptions.ReadOnly.max_staleness and TransactionOptions.ReadOnly.
-        # min_read_timestamp. ### Old Read Timestamps and Garbage Collection Cloud
+        # min_read_timestamp. ## Old Read Timestamps and Garbage Collection Cloud
         # Spanner continuously garbage collects deleted and overwritten data in the
         # background to reclaim storage space. This process is known as "version GC". By
         # default, version GC reclaims versions after they are one hour old. Because of
@@ -3499,7 +3716,7 @@ module Google
         # inactivity at the client may cause Cloud Spanner to release a transaction's
         # locks and abort it. Conceptually, a read-write transaction consists of zero or
         # more reads or SQL statements followed by Commit. At any time before Commit,
-        # the client can send a Rollback request to abort the transaction. ### Semantics
+        # the client can send a Rollback request to abort the transaction. ## Semantics
         # Cloud Spanner can commit the transaction if all read locks it acquired are
         # still valid at commit time, and it is able to acquire write locks for all
         # writes. Cloud Spanner can abort the transaction for any reason. If a commit
@@ -3507,7 +3724,7 @@ module Google
         # not modified any user data in Cloud Spanner. Unless the transaction commits,
         # Cloud Spanner makes no guarantees about how long the transaction's locks were
         # held for. It is an error to use Cloud Spanner locks for any sort of mutual
-        # exclusion other than between Cloud Spanner transactions themselves. ###
+        # exclusion other than between Cloud Spanner transactions themselves. ##
         # Retrying Aborted Transactions When a transaction aborts, the application can
         # choose to retry the whole transaction again. To maximize the chances of
         # successfully committing the retry, the client should execute the retry in the
@@ -3518,7 +3735,7 @@ module Google
         # can abort many times in a short period before successfully committing. Thus,
         # it is not a good idea to cap the number of retries a transaction can attempt;
         # instead, it is better to limit the total amount of wall time spent retrying. ##
-        # # Idle Transactions A transaction is considered idle if it has no outstanding
+        # Idle Transactions A transaction is considered idle if it has no outstanding
         # reads or SQL queries and has not started a read or SQL query within the last
         # 10 seconds. Idle transactions can be aborted by Cloud Spanner so that they don'
         # t hold on to locks indefinitely. In that case, the commit will fail with error
@@ -3542,7 +3759,7 @@ module Google
         # is geographically distributed, stale read-only transactions can execute more
         # quickly than strong or read-write transaction, because they are able to
         # execute far from the leader replica. Each type of timestamp bound is discussed
-        # in detail below. ### Strong Strong reads are guaranteed to see the effects of
+        # in detail below. ## Strong Strong reads are guaranteed to see the effects of
         # all transactions that have committed before the start of the read. Furthermore,
         # all rows yielded by a single read are consistent with each other -- if any
         # part of the read observes a transaction, all parts of the read see the
@@ -3550,7 +3767,7 @@ module Google
         # transactions might return inconsistent results if there are concurrent writes.
         # If consistency across reads is required, the reads should be executed within a
         # transaction or at an exact read timestamp. See TransactionOptions.ReadOnly.
-        # strong. ### Exact Staleness These timestamp bounds execute reads at a user-
+        # strong. ## Exact Staleness These timestamp bounds execute reads at a user-
         # specified timestamp. Reads at a timestamp are guaranteed to see a consistent
         # prefix of the global transaction history: they observe modifications done by
         # all transactions with a commit timestamp <= the read timestamp, and observe
@@ -3562,7 +3779,7 @@ module Google
         # to pick a timestamp. As a result, they execute slightly faster than the
         # equivalent boundedly stale concurrency modes. On the other hand, boundedly
         # stale reads usually return fresher results. See TransactionOptions.ReadOnly.
-        # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ### Bounded
+        # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ## Bounded
         # Staleness Bounded staleness modes allow Cloud Spanner to pick the read
         # timestamp, subject to a user-provided staleness bound. Cloud Spanner chooses
         # the newest timestamp within the staleness bound that allows execution of the
@@ -3580,7 +3797,7 @@ module Google
         # timestamp negotiation requires up-front knowledge of which rows will be read,
         # it can only be used with single-use read-only transactions. See
         # TransactionOptions.ReadOnly.max_staleness and TransactionOptions.ReadOnly.
-        # min_read_timestamp. ### Old Read Timestamps and Garbage Collection Cloud
+        # min_read_timestamp. ## Old Read Timestamps and Garbage Collection Cloud
         # Spanner continuously garbage collects deleted and overwritten data in the
         # background to reclaim storage space. This process is known as "version GC". By
         # default, version GC reclaims versions after they are one hour old. Because of

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.1.0"
+      GEM_VERSION = "0.6.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.1.1"
+      GENERATOR_VERSION = "0.2.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20201130"
+      REVISION = "20210309"
     end
   end
 end

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

@@ -76,6 +76,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CommitStats
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class CreateBackupMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -130,6 +136,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class EncryptionConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class EncryptionInfo
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ExecuteBatchDmlRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -364,6 +382,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class RestoreDatabaseEncryptionConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class RestoreDatabaseMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -513,11 +537,14 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :create_time, as: 'createTime'
           property :database, as: 'database'
+          property :encryption_info, as: 'encryptionInfo', class: Google::Apis::SpannerV1::EncryptionInfo, decorator: Google::Apis::SpannerV1::EncryptionInfo::Representation
+      
           property :expire_time, as: 'expireTime'
           property :name, as: 'name'
           collection :referencing_databases, as: 'referencingDatabases'
           property :size_bytes, :numeric_string => true, as: 'sizeBytes'
           property :state, as: 'state'
+          property :version_time, as: 'versionTime'
         end
       end
       
@@ -527,6 +554,7 @@ module Google
           property :backup, as: 'backup'
           property :create_time, as: 'createTime'
           property :source_database, as: 'sourceDatabase'
+          property :version_time, as: 'versionTime'
         end
       end
       
@@ -579,6 +607,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           collection :mutations, as: 'mutations', class: Google::Apis::SpannerV1::Mutation, decorator: Google::Apis::SpannerV1::Mutation::Representation
       
+          property :return_commit_stats, as: 'returnCommitStats'
           property :single_use_transaction, as: 'singleUseTransaction', class: Google::Apis::SpannerV1::TransactionOptions, decorator: Google::Apis::SpannerV1::TransactionOptions::Representation
       
           property :transaction_id, :base64 => true, as: 'transactionId'
@@ -588,10 +617,19 @@ module Google
       class CommitResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :commit_stats, as: 'commitStats', class: Google::Apis::SpannerV1::CommitStats, decorator: Google::Apis::SpannerV1::CommitStats::Representation
+      
           property :commit_timestamp, as: 'commitTimestamp'
         end
       end
       
+      class CommitStats
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :mutation_count, :numeric_string => true, as: 'mutationCount'
+        end
+      end
+      
       class CreateBackupMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -614,6 +652,8 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :create_statement, as: 'createStatement'
+          property :encryption_config, as: 'encryptionConfig', class: Google::Apis::SpannerV1::EncryptionConfig, decorator: Google::Apis::SpannerV1::EncryptionConfig::Representation
+      
           collection :extra_statements, as: 'extraStatements'
         end
       end
@@ -650,10 +690,16 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :create_time, as: 'createTime'
+          property :earliest_version_time, as: 'earliestVersionTime'
+          property :encryption_config, as: 'encryptionConfig', class: Google::Apis::SpannerV1::EncryptionConfig, decorator: Google::Apis::SpannerV1::EncryptionConfig::Representation
+      
+          collection :encryption_info, as: 'encryptionInfo', class: Google::Apis::SpannerV1::EncryptionInfo, decorator: Google::Apis::SpannerV1::EncryptionInfo::Representation
+      
           property :name, as: 'name'
           property :restore_info, as: 'restoreInfo', class: Google::Apis::SpannerV1::RestoreInfo, decorator: Google::Apis::SpannerV1::RestoreInfo::Representation
       
           property :state, as: 'state'
+          property :version_retention_period, as: 'versionRetentionPeriod'
         end
       end
       
@@ -672,6 +718,23 @@ module Google
         end
       end
       
+      class EncryptionConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :kms_key_name, as: 'kmsKeyName'
+        end
+      end
+      
+      class EncryptionInfo
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :encryption_status, as: 'encryptionStatus', class: Google::Apis::SpannerV1::Status, decorator: Google::Apis::SpannerV1::Status::Representation
+      
+          property :encryption_type, as: 'encryptionType'
+          property :kms_key_version, as: 'kmsKeyVersion'
+        end
+      end
+      
       class ExecuteBatchDmlRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -850,6 +913,7 @@ module Google
           collection :instances, as: 'instances', class: Google::Apis::SpannerV1::Instance, decorator: Google::Apis::SpannerV1::Instance::Representation
       
           property :next_page_token, as: 'nextPageToken'
+          collection :unreachable, as: 'unreachable'
         end
       end
       
@@ -1018,6 +1082,7 @@ module Google
       class QueryOptions
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :optimizer_statistics_package, as: 'optimizerStatisticsPackage'
           property :optimizer_version, as: 'optimizerVersion'
         end
       end
@@ -1073,6 +1138,14 @@ module Google
         end
       end
       
+      class RestoreDatabaseEncryptionConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :encryption_type, as: 'encryptionType'
+          property :kms_key_name, as: 'kmsKeyName'
+        end
+      end
+      
       class RestoreDatabaseMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1092,6 +1165,8 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :backup, as: 'backup'
           property :database_id, as: 'databaseId'
+          property :encryption_config, as: 'encryptionConfig', class: Google::Apis::SpannerV1::RestoreDatabaseEncryptionConfig, decorator: Google::Apis::SpannerV1::RestoreDatabaseEncryptionConfig::Representation
+      
         end
       end
       

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

@@ -290,6 +290,10 @@ module Google
         #   value of the label contains the string "dev". * `name:howl labels.env:dev` -->
         #   The instance's name contains "howl" and it has the label "env" with its value
         #   containing "dev".
+        # @param [String] instance_deadline
+        #   Deadline used while retrieving metadata for instances. Instances whose
+        #   metadata cannot be retrieved within this deadline will be added to unreachable
+        #   in ListInstancesResponse.
         # @param [Fixnum] page_size
         #   Number of instances to be returned in the response. If 0 or less, defaults to
         #   the server's maximum allowed page size.
@@ -313,12 +317,13 @@ module Google
         # @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 list_project_instances(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_project_instances(parent, filter: nil, instance_deadline: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1/{+parent}/instances', options)
           command.response_representation = Google::Apis::SpannerV1::ListInstancesResponse::Representation
           command.response_class = Google::Apis::SpannerV1::ListInstancesResponse
           command.params['parent'] = parent unless parent.nil?
           command.query['filter'] = filter unless filter.nil?
+          command.query['instanceDeadline'] = instance_deadline unless instance_deadline.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
           command.query['fields'] = fields unless fields.nil?
@@ -544,6 +549,12 @@ module Google
         # @param [String] backup_id
         #   Required. The id of the backup to be created. The `backup_id` appended to `
         #   parent` forms the full backup name of the form `projects//instances//backups/`.
+        # @param [String] encryption_config_encryption_type
+        #   Required. The encryption type of the backup.
+        # @param [String] encryption_config_kms_key_name
+        #   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/`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -561,7 +572,7 @@ module Google
         # @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 create_project_instance_backup(parent, backup_object = nil, backup_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def create_project_instance_backup(parent, backup_object = nil, backup_id: nil, encryption_config_encryption_type: nil, encryption_config_kms_key_name: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:post, 'v1/{+parent}/backups', options)
           command.request_representation = Google::Apis::SpannerV1::Backup::Representation
           command.request_object = backup_object
@@ -569,6 +580,8 @@ module Google
           command.response_class = Google::Apis::SpannerV1::Operation
           command.params['parent'] = parent unless parent.nil?
           command.query['backupId'] = backup_id unless backup_id.nil?
+          command.query['encryptionConfig.encryptionType'] = encryption_config_encryption_type unless encryption_config_encryption_type.nil?
+          command.query['encryptionConfig.kmsKeyName'] = encryption_config_kms_key_name unless encryption_config_kms_key_name.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -688,18 +701,19 @@ module Google
         #   contains operator. Filter rules are not case sensitive. The following fields
         #   in the 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) * `size_bytes`
-        #   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: * `name:
-        #   Howl` - The backup's name contains the string "howl". * `database:prod` - The
-        #   database's name contains the string "prod". * `state:CREATING` - The backup is
-        #   pending creation. * `state:READY` - The backup is fully created and ready for
-        #   use. * `(name:howl) AND (create_time < \"2018-03-28T14:50:00Z\")` - The backup
-        #   name contains the string "howl" and `create_time` of the backup is before 2018-
-        #   03-28T14:50:00Z. * `expire_time < \"2018-03-28T14:50:00Z\"` - The backup `
-        #   expire_time` is before 2018-03-28T14:50:00Z. * `size_bytes > 10000000000` -
-        #   The backup's size is greater than 10GB
+        #   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 parentheses. By default, expressions are combined with AND logic, but you
+        #   can specify AND, OR, and NOT logic explicitly. Here are a few examples: * `
+        #   name:Howl` - The backup's name contains the string "howl". * `database:prod` -
+        #   The database's name contains the string "prod". * `state:CREATING` - The
+        #   backup is pending creation. * `state:READY` - The backup is fully created and
+        #   ready for use. * `(name:howl) AND (create_time < \"2018-03-28T14:50:00Z\")` -
+        #   The backup name contains the string "howl" and `create_time` of the backup is
+        #   before 2018-03-28T14:50:00Z. * `expire_time < \"2018-03-28T14:50:00Z\"` - The
+        #   backup `expire_time` is before 2018-03-28T14:50:00Z. * `size_bytes >
+        #   10000000000` - The backup's size is greater than 10GB
         # @param [Fixnum] page_size
         #   Number of backups to be returned in the response. If 0 or less, defaults to
         #   the server's maximum allowed page size.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-spanner_v1
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-01-08 00:00:00.000000000 Z
+date: 2021-03-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -52,7 +52,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/master/generated/google-apis-spanner_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.1.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.6.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-spanner_v1
 post_install_message: 
 rdoc_options: []
@@ -62,14 +62,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.4'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.2.13
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Cloud Spanner API V1