google-api-client 0.32.1 → 0.40.0

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

@@ -22,6 +22,121 @@ module Google
   module Apis
     module SpannerV1
       
+      # A backup of a Cloud Spanner database.
+      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.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Required for the CreateBackup operation.
+        # Name of the database from which this backup was
+        # created. This needs to be in the same instance as the backup.
+        # Values are of the form
+        # `projects/<project>/instances/<instance>/databases/<database>`.
+        # Corresponds to the JSON property `database`
+        # @return [String]
+        attr_accessor :database
+      
+        # 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 `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
+      
+        # 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/<project>/instances/<instance>/backups/a-z*[a-z0-9]`
+        # The final segment of the name must be between 2 and 60 characters
+        # in length.
+        # The backup is stored in the location(s) specified in the instance
+        # configuration of the instance containing the backup, identified
+        # by the prefix of the backup name of the form
+        # `projects/<project>/instances/<instance>`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Output only. The names of the restored databases that reference the backup.
+        # The database names are of
+        # the form `projects/<project>/instances/<instance>/databases/<database>`.
+        # Referencing databases may exist in different instances. The existence of
+        # any referencing database prevents the backup from being deleted. When a
+        # restored database from the backup enters the `READY` state, the reference
+        # to the backup is removed.
+        # Corresponds to the JSON property `referencingDatabases`
+        # @return [Array<String>]
+        attr_accessor :referencing_databases
+      
+        # Output only. Size of the backup in bytes.
+        # Corresponds to the JSON property `sizeBytes`
+        # @return [Fixnum]
+        attr_accessor :size_bytes
+      
+        # Output only. The current state of the backup.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @database = args[:database] if args.key?(:database)
+          @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)
+        end
+      end
+      
+      # Information about a backup.
+      class BackupInfo
+        include Google::Apis::Core::Hashable
+      
+        # Name of the backup.
+        # Corresponds to the JSON property `backup`
+        # @return [String]
+        attr_accessor :backup
+      
+        # The backup contains an externally consistent copy of `source_database` at
+        # the timestamp specified by `create_time`.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Name of the database the backup was created from.
+        # Corresponds to the JSON property `sourceDatabase`
+        # @return [String]
+        attr_accessor :source_database
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @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)
+        end
+      end
+      
       # The request for BatchCreateSessions.
       class BatchCreateSessionsRequest
         include Google::Apis::Core::Hashable
@@ -307,10 +422,28 @@ module Google
       class Binding
         include Google::Apis::Core::Hashable
       
-        # Represents an expression text. Example:
-        # title: "User account presence"
-        # description: "Determines whether the request has a user account"
-        # expression: "size(request.user) > 0"
+        # Represents a textual expression in the Common Expression Language (CEL)
+        # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+        # are documented at https://github.com/google/cel-spec.
+        # Example (Comparison):
+        # title: "Summary size limit"
+        # description: "Determines if a summary is less than 100 chars"
+        # expression: "document.summary.size() < 100"
+        # Example (Equality):
+        # title: "Requestor is owner"
+        # description: "Determines if requestor is the document owner"
+        # expression: "document.owner == request.auth.claims.email"
+        # Example (Logic):
+        # title: "Public documents"
+        # description: "Determine whether the document should be publicly visible"
+        # expression: "document.type != 'private' && document.type != 'internal'"
+        # Example (Data Manipulation):
+        # title: "Notification string"
+        # description: "Create a notification string with a timestamp."
+        # expression: "'New message received at ' + string(document.create_time)"
+        # The exact variables and functions that may be referenced within an expression
+        # are determined by the service that evaluates it. See the service
+        # documentation for additional information.
         # Corresponds to the JSON property `condition`
         # @return [Google::Apis::SpannerV1::Expr]
         attr_accessor :condition
@@ -327,6 +460,23 @@ module Google
         # account. For example, `my-other-app@appspot.gserviceaccount.com`.
         # * `group:`emailid``: An email address that represents a Google group.
         # For example, `admins@example.com`.
+        # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # identifier) representing a user that has been recently deleted. For
+        # example, `alice@example.com?uid=123456789012345678901`. If the user is
+        # recovered, this value reverts to `user:`emailid`` and the recovered user
+        # retains the role in the binding.
+        # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus
+        # unique identifier) representing a service account that has been recently
+        # deleted. For example,
+        # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
+        # If the service account is undeleted, this value reverts to
+        # `serviceAccount:`emailid`` and the undeleted service account retains the
+        # role in the binding.
+        # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # identifier) representing a Google group that has been recently
+        # deleted. For example, `admins@example.com?uid=123456789012345678901`. If
+        # the group is recovered, this value reverts to `group:`emailid`` and the
+        # recovered group retains the role in the binding.
         # * `domain:`domain``: The G Suite domain (primary) that represents all the
         # users of that domain. For example, `google.com` or `example.com`.
         # Corresponds to the JSON property `members`
@@ -660,6 +810,55 @@ module Google
         end
       end
       
+      # Metadata type for the operation returned by
+      # CreateBackup.
+      class CreateBackupMetadata
+        include Google::Apis::Core::Hashable
+      
+        # The time at which cancellation of this 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 database the backup is created from.
+        # Corresponds to the JSON property `database`
+        # @return [String]
+        attr_accessor :database
+      
+        # The name of the backup being created.
+        # 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
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @cancel_time = args[:cancel_time] if args.key?(:cancel_time)
+          @database = args[:database] if args.key?(:database)
+          @name = args[:name] if args.key?(:name)
+          @progress = args[:progress] if args.key?(:progress)
+        end
+      end
+      
       # Metadata type for the operation returned by
       # CreateDatabase.
       class CreateDatabaseMetadata
@@ -693,7 +892,7 @@ module Google
         # @return [String]
         attr_accessor :create_statement
       
-        # An optional list of DDL statements to run inside the newly created
+        # 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 statement, the database is not created.
@@ -804,6 +1003,11 @@ module Google
       class Database
         include Google::Apis::Core::Hashable
       
+        # Output only. If exists, the time at which the database creation started.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
         # Required. The name of the database. Values are of the form
         # `projects/<project>/instances/<instance>/databases/<database>`,
         # where `<database>` is as specified in the `CREATE DATABASE`
@@ -813,6 +1017,11 @@ module Google
         # @return [String]
         attr_accessor :name
       
+        # Information about the database restore.
+        # Corresponds to the JSON property `restoreInfo`
+        # @return [Google::Apis::SpannerV1::RestoreInfo]
+        attr_accessor :restore_info
+      
         # Output only. The current database state.
         # Corresponds to the JSON property `state`
         # @return [String]
@@ -824,7 +1033,9 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
           @name = args[:name] if args.key?(:name)
+          @restore_info = args[:restore_info] if args.key?(:restore_info)
           @state = args[:state] if args.key?(:state)
         end
       end
@@ -882,7 +1093,8 @@ module Google
       class ExecuteBatchDmlRequest
         include Google::Apis::Core::Hashable
       
-        # A per-transaction sequence number used to identify this request. This field
+        # Required. A per-transaction sequence number used to identify this request.
+        # This field
         # makes each request idempotent such that if the request is received multiple
         # times, at most one will succeed.
         # The sequence number must be monotonically increasing within the
@@ -893,7 +1105,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :seqno
       
-        # The list of statements to execute in this batch. Statements are executed
+        # Required. The list of statements to execute in this batch. Statements are
+        # executed
         # serially, such that the effects of statement `i` are visible to statement
         # `i+1`. Each statement must be a DML statement. Execution stops at the
         # first failed statement; the remaining statements are not executed.
@@ -1018,6 +1231,11 @@ module Google
         # @return [String]
         attr_accessor :query_mode
       
+        # Query optimizer configuration.
+        # Corresponds to the JSON property `queryOptions`
+        # @return [Google::Apis::SpannerV1::QueryOptions]
+        attr_accessor :query_options
+      
         # If this request is resuming a previously interrupted SQL statement
         # execution, `resume_token` should be copied from the last
         # PartialResultSet yielded before the interruption. Doing this
@@ -1064,6 +1282,7 @@ module Google
           @params = args[:params] if args.key?(:params)
           @partition_token = args[:partition_token] if args.key?(:partition_token)
           @query_mode = args[:query_mode] if args.key?(:query_mode)
+          @query_options = args[:query_options] if args.key?(:query_options)
           @resume_token = args[:resume_token] if args.key?(:resume_token)
           @seqno = args[:seqno] if args.key?(:seqno)
           @sql = args[:sql] if args.key?(:sql)
@@ -1071,34 +1290,50 @@ module Google
         end
       end
       
-      # Represents an expression text. Example:
-      # title: "User account presence"
-      # description: "Determines whether the request has a user account"
-      # expression: "size(request.user) > 0"
+      # Represents a textual expression in the Common Expression Language (CEL)
+      # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+      # are documented at https://github.com/google/cel-spec.
+      # Example (Comparison):
+      # title: "Summary size limit"
+      # description: "Determines if a summary is less than 100 chars"
+      # expression: "document.summary.size() < 100"
+      # Example (Equality):
+      # title: "Requestor is owner"
+      # description: "Determines if requestor is the document owner"
+      # expression: "document.owner == request.auth.claims.email"
+      # Example (Logic):
+      # title: "Public documents"
+      # description: "Determine whether the document should be publicly visible"
+      # expression: "document.type != 'private' && document.type != 'internal'"
+      # Example (Data Manipulation):
+      # title: "Notification string"
+      # description: "Create a notification string with a timestamp."
+      # expression: "'New message received at ' + string(document.create_time)"
+      # The exact variables and functions that may be referenced within an expression
+      # are determined by the service that evaluates it. See the service
+      # documentation for additional information.
       class Expr
         include Google::Apis::Core::Hashable
       
-        # An optional description of the expression. This is a longer text which
+        # Optional. Description of the expression. This is a longer text which
         # describes the expression, e.g. when hovered over it in a UI.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Textual representation of an expression in
-        # Common Expression Language syntax.
-        # The application context of the containing message determines which
-        # well-known feature set of CEL is supported.
+        # Textual representation of an expression in Common Expression Language
+        # syntax.
         # Corresponds to the JSON property `expression`
         # @return [String]
         attr_accessor :expression
       
-        # An optional string indicating the location of the expression for error
+        # Optional. String indicating the location of the expression for error
         # reporting, e.g. a file name and a position in the file.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
       
-        # An optional title for the expression, i.e. a short string describing
+        # Optional. Title for the expression, i.e. a short string describing
         # its purpose. This can be used e.g. in UIs which allow to enter the
         # expression.
         # Corresponds to the JSON property `title`
@@ -1194,9 +1429,14 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. The policy format version to be returned.
-        # Acceptable values are 0, 1, and 3.
-        # If the value is 0, or the field is omitted, policy format version 1 will be
-        # returned.
+        # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        # rejected.
+        # Requests for policies with any conditional bindings must specify version 3.
+        # Policies without any conditional bindings may specify any valid value or
+        # leave the field unset.
+        # To learn which resources support conditions in their IAM policies, see the
+        # [IAM
+        # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # Corresponds to the JSON property `requestedPolicyVersion`
         # @return [Fixnum]
         attr_accessor :requested_policy_version
@@ -1229,6 +1469,11 @@ module Google
         # @return [String]
         attr_accessor :display_name
       
+        # Deprecated. This field is not populated.
+        # Corresponds to the JSON property `endpointUris`
+        # @return [Array<String>]
+        attr_accessor :endpoint_uris
+      
         # Cloud Labels are a flexible and lightweight mechanism for organizing cloud
         # resources into groups that reflect a customer's organizational needs and
         # deployment strategies. Cloud Labels can be used to filter collections of
@@ -1259,8 +1504,9 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # Required. The number of nodes allocated to this instance. This may be zero
-        # in API responses for instances that are not yet in state `READY`.
+        # The number of nodes allocated to this instance. This
+        # may be zero in API responses for instances that are not yet in state
+        # `READY`.
         # See [the
         # documentation](https://cloud.google.com/spanner/docs/instances#node_count)
         # for more information about nodes.
@@ -1285,6 +1531,7 @@ module Google
         def update!(**args)
           @config = args[:config] if args.key?(:config)
           @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)
           @name = args[:name] if args.key?(:name)
           @node_count = args[:node_count] if args.key?(:node_count)
@@ -1470,6 +1717,102 @@ module Google
         end
       end
       
+      # The response for
+      # ListBackupOperations.
+      class ListBackupOperationsResponse
+        include Google::Apis::Core::Hashable
+      
+        # `next_page_token` can be sent in a subsequent
+        # ListBackupOperations
+        # call to fetch more of the matching metadata.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        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.
+        # Corresponds to the JSON property `operations`
+        # @return [Array<Google::Apis::SpannerV1::Operation>]
+        attr_accessor :operations
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @operations = args[:operations] if args.key?(:operations)
+        end
+      end
+      
+      # The response for ListBackups.
+      class ListBackupsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The list of matching backups. Backups returned are ordered by `create_time`
+        # in descending order, starting from the most recent `create_time`.
+        # Corresponds to the JSON property `backups`
+        # @return [Array<Google::Apis::SpannerV1::Backup>]
+        attr_accessor :backups
+      
+        # `next_page_token` can be sent in a subsequent
+        # ListBackups call to fetch more
+        # of the matching backups.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @backups = args[:backups] if args.key?(:backups)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
+      # The response for
+      # ListDatabaseOperations.
+      class ListDatabaseOperationsResponse
+        include Google::Apis::Core::Hashable
+      
+        # `next_page_token` can be sent in a subsequent
+        # ListDatabaseOperations
+        # call to fetch more of the matching metadata.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # The list of matching database long-running
+        # operations. Each operation's name will be
+        # prefixed by the database's name. The operation's
+        # metadata field type
+        # `metadata.type_url` describes the type of the metadata.
+        # Corresponds to the JSON property `operations`
+        # @return [Array<Google::Apis::SpannerV1::Operation>]
+        attr_accessor :operations
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @operations = args[:operations] if args.key?(:operations)
+        end
+      end
+      
       # The response for ListDatabases.
       class ListDatabasesResponse
         include Google::Apis::Core::Hashable
@@ -1716,6 +2059,69 @@ module Google
         end
       end
       
+      # Encapsulates progress related information for a Cloud Spanner long
+      # running operation.
+      class OperationProgress
+        include Google::Apis::Core::Hashable
+      
+        # If set, the time at which this operation failed or was completed
+        # successfully.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # Percent completion of the operation.
+        # Values are between 0 and 100 inclusive.
+        # Corresponds to the JSON property `progressPercent`
+        # @return [Fixnum]
+        attr_accessor :progress_percent
+      
+        # Time the request was received.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @progress_percent = args[:progress_percent] if args.key?(:progress_percent)
+          @start_time = args[:start_time] if args.key?(:start_time)
+        end
+      end
+      
+      # Metadata type for the long-running operation used to track the progress
+      # of optimizations performed on a newly restored database. This long-running
+      # operation is automatically created by the system after the successful
+      # completion of a database restore, and cannot be cancelled.
+      class OptimizeRestoredDatabaseMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Name of the restored database being optimized.
+        # 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
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+          @progress = args[:progress] if args.key?(:progress)
+        end
+      end
+      
       # Partial results from a streaming read or SQL query. Streaming reads and
       # SQL queries better tolerate large result sets, large rows, and large
       # values, but are a little trickier to consume.
@@ -1919,7 +2325,8 @@ module Google
         # @return [Google::Apis::SpannerV1::PartitionOptions]
         attr_accessor :partition_options
       
-        # The query request to generate partitions for. The request will fail if
+        # Required. The query request to generate partitions for. The request will fail
+        # if
         # the query is not root partitionable. The query plan of a root
         # partitionable query has a single distributed union operator. A distributed
         # union operator conceptually divides one or more tables into multiple
@@ -2123,48 +2530,73 @@ module Google
         end
       end
       
-      # Defines an Identity and Access Management (IAM) policy. It is used to
-      # specify access control policies for Cloud Platform resources.
-      # A `Policy` consists of a list of `bindings`. A `binding` binds a list of
-      # `members` to a `role`, where the members can be user accounts, Google groups,
-      # Google domains, and service accounts. A `role` is a named list of permissions
-      # defined by IAM.
-      # **JSON Example**
+      # An Identity and Access Management (IAM) policy, which specifies access
+      # controls for Google Cloud resources.
+      # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+      # `members` to a single `role`. Members can be user accounts, service accounts,
+      # Google groups, and domains (such as G Suite). A `role` is a named list of
+      # permissions; each `role` can be an IAM predefined role or a user-created
+      # custom role.
+      # For some types of Google Cloud resources, a `binding` can also specify a
+      # `condition`, which is a logical expression that allows access to a resource
+      # only if the expression evaluates to `true`. A condition can add constraints
+      # based on attributes of the request, the resource, or both. To learn which
+      # resources support conditions in their IAM policies, see the
+      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+      # policies).
+      # **JSON example:**
       # `
       # "bindings": [
       # `
-      # "role": "roles/owner",
+      # "role": "roles/resourcemanager.organizationAdmin",
       # "members": [
       # "user:mike@example.com",
       # "group:admins@example.com",
       # "domain:google.com",
-      # "serviceAccount:my-other-app@appspot.gserviceaccount.com"
+      # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
       # ]
       # `,
       # `
-      # "role": "roles/viewer",
-      # "members": ["user:sean@example.com"]
+      # "role": "roles/resourcemanager.organizationViewer",
+      # "members": [
+      # "user:eve@example.com"
+      # ],
+      # "condition": `
+      # "title": "expirable access",
+      # "description": "Does not grant access after Sep 2020",
+      # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')
+      # ",
       # `
-      # ]
       # `
-      # **YAML Example**
+      # ],
+      # "etag": "BwWWja0YfJA=",
+      # "version": 3
+      # `
+      # **YAML example:**
       # bindings:
       # - members:
       # - user:mike@example.com
       # - group:admins@example.com
       # - domain:google.com
-      # - serviceAccount:my-other-app@appspot.gserviceaccount.com
-      # role: roles/owner
+      # - serviceAccount:my-project-id@appspot.gserviceaccount.com
+      # role: roles/resourcemanager.organizationAdmin
       # - members:
-      # - user:sean@example.com
-      # role: roles/viewer
+      # - user:eve@example.com
+      # role: roles/resourcemanager.organizationViewer
+      # condition:
+      # title: expirable access
+      # description: Does not grant access after Sep 2020
+      # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
+      # - etag: BwWWja0YfJA=
+      # - version: 3
       # For a description of IAM and its features, see the
-      # [IAM developer's guide](https://cloud.google.com/iam/docs).
+      # [IAM documentation](https://cloud.google.com/iam/docs/).
       class Policy
         include Google::Apis::Core::Hashable
       
-        # Associates a list of `members` to a `role`.
-        # `bindings` with no members will result in an error.
+        # Associates a list of `members` to a `role`. Optionally, may specify a
+        # `condition` that determines how and when the `bindings` are applied. Each
+        # of the `bindings` must contain at least one member.
         # Corresponds to the JSON property `bindings`
         # @return [Array<Google::Apis::SpannerV1::Binding>]
         attr_accessor :bindings
@@ -2176,14 +2608,34 @@ module Google
         # conditions: An `etag` is returned in the response to `getIamPolicy`, and
         # systems are expected to put that etag in the request to `setIamPolicy` to
         # ensure that their change will be applied to the same version of the policy.
-        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
-        # policy is overwritten.
+        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # the conditions in the version `3` policy are lost.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :etag
       
-        # Deprecated.
+        # Specifies the format of the policy.
+        # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
+        # are rejected.
+        # Any operation that affects conditional role bindings must specify version
+        # `3`. This requirement applies to the following operations:
+        # * Getting a policy that includes a conditional role binding
+        # * Adding a conditional role binding to a policy
+        # * Changing a conditional role binding in a policy
+        # * Removing any role binding, with or without a condition, from a policy
+        # that includes conditions
+        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # the conditions in the version `3` policy are lost.
+        # If a policy does not include any conditions, operations on that policy may
+        # specify any valid version or leave the field unset.
+        # To learn which resources support conditions in their IAM policies, see the
+        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # policies).
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -2200,6 +2652,40 @@ module Google
         end
       end
       
+      # Query optimizer configuration.
+      class QueryOptions
+        include Google::Apis::Core::Hashable
+      
+        # 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 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.
+        # Corresponds to the JSON property `optimizerVersion`
+        # @return [String]
+        attr_accessor :optimizer_version
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @optimizer_version = args[:optimizer_version] if args.key?(:optimizer_version)
+        end
+      end
+      
       # Contains an ordered list of nodes appearing in the query plan.
       class QueryPlan
         include Google::Apis::Core::Hashable
@@ -2312,7 +2798,7 @@ module Google
       class ReadRequest
         include Google::Apis::Core::Hashable
       
-        # The columns of table to be returned for each row matching
+        # Required. The columns of table to be returned for each row matching
         # this request.
         # Corresponds to the JSON property `columns`
         # @return [Array<String>]
@@ -2441,6 +2927,133 @@ module Google
         end
       end
       
+      # Metadata type for the long-running operation returned by
+      # RestoreDatabase.
+      class RestoreDatabaseMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Information about a backup.
+        # Corresponds to the JSON property `backupInfo`
+        # @return [Google::Apis::SpannerV1::BackupInfo]
+        attr_accessor :backup_info
+      
+        # The time at which cancellation of this 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
+      
+        # Name of the database being created and restored to.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # If exists, the name of the long-running operation that will be used to
+        # track the post-restore optimization process to optimize the performance of
+        # the restored database, and remove the dependency on the restore source.
+        # The name is of the form
+        # `projects/<project>/instances/<instance>/databases/<database>/operations/<
+        # operation>`
+        # where the <database> is the name of database being created and restored to.
+        # The metadata type of the  long-running operation is
+        # OptimizeRestoredDatabaseMetadata. This long-running operation will be
+        # automatically created by the system after the RestoreDatabase long-running
+        # operation completes successfully. This operation will not be created if the
+        # restore was not successful.
+        # Corresponds to the JSON property `optimizeDatabaseOperationName`
+        # @return [String]
+        attr_accessor :optimize_database_operation_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 type of the restore source.
+        # Corresponds to the JSON property `sourceType`
+        # @return [String]
+        attr_accessor :source_type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @backup_info = args[:backup_info] if args.key?(:backup_info)
+          @cancel_time = args[:cancel_time] if args.key?(:cancel_time)
+          @name = args[:name] if args.key?(:name)
+          @optimize_database_operation_name = args[:optimize_database_operation_name] if args.key?(:optimize_database_operation_name)
+          @progress = args[:progress] if args.key?(:progress)
+          @source_type = args[:source_type] if args.key?(:source_type)
+        end
+      end
+      
+      # The request for
+      # RestoreDatabase.
+      class RestoreDatabaseRequest
+        include Google::Apis::Core::Hashable
+      
+        # Name of the backup from which to restore.  Values are of the form
+        # `projects/<project>/instances/<instance>/backups/<backup>`.
+        # Corresponds to the JSON property `backup`
+        # @return [String]
+        attr_accessor :backup
+      
+        # Required. The id of the database to create and restore to. This
+        # database must not already exist. The `database_id` appended to
+        # `parent` forms the full database name of the form
+        # `projects/<project>/instances/<instance>/databases/<database_id>`.
+        # Corresponds to the JSON property `databaseId`
+        # @return [String]
+        attr_accessor :database_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @backup = args[:backup] if args.key?(:backup)
+          @database_id = args[:database_id] if args.key?(:database_id)
+        end
+      end
+      
+      # Information about the database restore.
+      class RestoreInfo
+        include Google::Apis::Core::Hashable
+      
+        # Information about a backup.
+        # Corresponds to the JSON property `backupInfo`
+        # @return [Google::Apis::SpannerV1::BackupInfo]
+        attr_accessor :backup_info
+      
+        # The type of the restore source.
+        # Corresponds to the JSON property `sourceType`
+        # @return [String]
+        attr_accessor :source_type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @backup_info = args[:backup_info] if args.key?(:backup_info)
+          @source_type = args[:source_type] if args.key?(:source_type)
+        end
+      end
+      
       # Results from Read or
       # ExecuteSql.
       class ResultSet
@@ -2617,43 +3230,67 @@ module Google
       class SetIamPolicyRequest
         include Google::Apis::Core::Hashable
       
-        # Defines an Identity and Access Management (IAM) policy. It is used to
-        # specify access control policies for Cloud Platform resources.
-        # A `Policy` consists of a list of `bindings`. A `binding` binds a list of
-        # `members` to a `role`, where the members can be user accounts, Google groups,
-        # Google domains, and service accounts. A `role` is a named list of permissions
-        # defined by IAM.
-        # **JSON Example**
+        # An Identity and Access Management (IAM) policy, which specifies access
+        # controls for Google Cloud resources.
+        # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+        # `members` to a single `role`. Members can be user accounts, service accounts,
+        # Google groups, and domains (such as G Suite). A `role` is a named list of
+        # permissions; each `role` can be an IAM predefined role or a user-created
+        # custom role.
+        # For some types of Google Cloud resources, a `binding` can also specify a
+        # `condition`, which is a logical expression that allows access to a resource
+        # only if the expression evaluates to `true`. A condition can add constraints
+        # based on attributes of the request, the resource, or both. To learn which
+        # resources support conditions in their IAM policies, see the
+        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # policies).
+        # **JSON example:**
         # `
         # "bindings": [
         # `
-        # "role": "roles/owner",
+        # "role": "roles/resourcemanager.organizationAdmin",
         # "members": [
         # "user:mike@example.com",
         # "group:admins@example.com",
         # "domain:google.com",
-        # "serviceAccount:my-other-app@appspot.gserviceaccount.com"
+        # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
         # ]
         # `,
         # `
-        # "role": "roles/viewer",
-        # "members": ["user:sean@example.com"]
+        # "role": "roles/resourcemanager.organizationViewer",
+        # "members": [
+        # "user:eve@example.com"
+        # ],
+        # "condition": `
+        # "title": "expirable access",
+        # "description": "Does not grant access after Sep 2020",
+        # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')
+        # ",
+        # `
         # `
-        # ]
+        # ],
+        # "etag": "BwWWja0YfJA=",
+        # "version": 3
         # `
-        # **YAML Example**
+        # **YAML example:**
         # bindings:
         # - members:
         # - user:mike@example.com
         # - group:admins@example.com
         # - domain:google.com
-        # - serviceAccount:my-other-app@appspot.gserviceaccount.com
-        # role: roles/owner
+        # - serviceAccount:my-project-id@appspot.gserviceaccount.com
+        # role: roles/resourcemanager.organizationAdmin
         # - members:
-        # - user:sean@example.com
-        # role: roles/viewer
+        # - user:eve@example.com
+        # role: roles/resourcemanager.organizationViewer
+        # condition:
+        # title: expirable access
+        # description: Does not grant access after Sep 2020
+        # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
+        # - etag: BwWWja0YfJA=
+        # - version: 3
         # For a description of IAM and its features, see the
-        # [IAM developer's guide](https://cloud.google.com/iam/docs).
+        # [IAM documentation](https://cloud.google.com/iam/docs/).
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::SpannerV1::Policy]
         attr_accessor :policy
@@ -3698,7 +4335,7 @@ module Google
         # @return [String]
         attr_accessor :operation_id
       
-        # DDL statements to be applied to the database.
+        # Required. DDL statements to be applied to the database.
         # Corresponds to the JSON property `statements`
         # @return [Array<String>]
         attr_accessor :statements
@@ -3759,11 +4396,9 @@ module Google
       class UpdateInstanceRequest
         include Google::Apis::Core::Hashable
       
-        # Required. A mask specifying which fields in [][google.spanner.admin.instance.
-        # v1.UpdateInstanceRequest.instance] should be updated.
+        # Required. A mask specifying which fields in Instance should be updated.
         # The field mask must always be specified; this prevents any future fields in
-        # [][google.spanner.admin.instance.v1.Instance] from being erased accidentally
-        # by clients that do not know
+        # Instance from being erased accidentally by clients that do not know
         # about them.
         # Corresponds to the JSON property `fieldMask`
         # @return [String]