google-api-client 0.43.0 → 0.44.0

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

@@ -50,8 +50,8 @@ module Google
         
         # Gets information about a particular instance configuration.
         # @param [String] name
-        #   Required. The name of the requested instance configuration. Values are of
-        #   the form `projects/<project>/instanceConfigs/<config>`.
+        #   Required. The name of the requested instance configuration. Values are of the
+        #   form `projects//instanceConfigs/`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -82,15 +82,13 @@ module Google
         # Lists the supported instance configurations for a given project.
         # @param [String] parent
         #   Required. The name of the project for which a list of supported instance
-        #   configurations is requested. Values are of the form
-        #   `projects/<project>`.
+        #   configurations is requested. Values are of the form `projects/`.
         # @param [Fixnum] page_size
-        #   Number of instance configurations to be returned in the response. If 0 or
-        #   less, defaults to the server's maximum allowed page size.
+        #   Number of instance configurations to be returned in the response. If 0 or less,
+        #   defaults to the server's maximum allowed page size.
         # @param [String] page_token
-        #   If non-empty, `page_token` should contain a
-        #   next_page_token
-        #   from a previous ListInstanceConfigsResponse.
+        #   If non-empty, `page_token` should contain a next_page_token from a previous
+        #   ListInstanceConfigsResponse.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -120,36 +118,25 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates an instance and begins preparing it to begin serving. The
-        # returned long-running operation
-        # can be used to track the progress of preparing the new
-        # instance. The instance name is assigned by the caller. If the
-        # named instance already exists, `CreateInstance` returns
-        # `ALREADY_EXISTS`.
-        # Immediately upon completion of this request:
-        # * The instance is readable via the API, with all requested attributes
-        # but no allocated resources. Its state is `CREATING`.
-        # Until completion of the returned operation:
-        # * Cancelling the operation renders the instance immediately unreadable
-        # via the API.
-        # * The instance can be deleted.
-        # * All other attempts to modify the instance are rejected.
-        # Upon completion of the returned operation:
-        # * Billing for all successfully-allocated resources begins (some types
-        # may have lower than the requested levels).
-        # * Databases can be created in the instance.
-        # * The instance's allocated resource levels are readable via the API.
-        # * The instance's state becomes `READY`.
-        # The returned long-running operation will
-        # have a name of the format `<instance_name>/operations/<operation_id>` and
-        # can be used to track creation of the instance.  The
-        # metadata field type is
-        # CreateInstanceMetadata.
-        # The response field type is
-        # Instance, if successful.
+        # Creates an instance and begins preparing it to begin serving. The returned
+        # long-running operation can be used to track the progress of preparing the new
+        # instance. The instance name is assigned by the caller. If the named instance
+        # already exists, `CreateInstance` returns `ALREADY_EXISTS`. Immediately upon
+        # completion of this request: * The instance is readable via the API, with all
+        # requested attributes but no allocated resources. Its state is `CREATING`.
+        # Until completion of the returned operation: * Cancelling the operation renders
+        # the instance immediately unreadable via the API. * The instance can be deleted.
+        # * All other attempts to modify the instance are rejected. Upon completion of
+        # the returned operation: * Billing for all successfully-allocated resources
+        # begins (some types may have lower than the requested levels). * Databases can
+        # be created in the instance. * The instance's allocated resource levels are
+        # readable via the API. * The instance's state becomes `READY`. The returned
+        # long-running operation will have a name of the format `/operations/` and can
+        # be used to track creation of the instance. The metadata field type is
+        # CreateInstanceMetadata. The response field type is Instance, if successful.
         # @param [String] parent
-        #   Required. The name of the project in which to create the instance. Values
-        #   are of the form `projects/<project>`.
+        #   Required. The name of the project in which to create the instance. Values are
+        #   of the form `projects/`.
         # @param [Google::Apis::SpannerV1::CreateInstanceRequest] create_instance_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -180,16 +167,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes an instance.
-        # Immediately upon completion of the request:
-        # * Billing ceases for all of the instance's reserved resources.
-        # Soon afterward:
-        # * The instance and *all of its databases* immediately and
-        # irrevocably disappear from the API. All data in the databases
-        # is permanently deleted.
+        # Deletes an instance. Immediately upon completion of the request: * Billing
+        # ceases for all of the instance's reserved resources. Soon afterward: * The
+        # instance and *all of its databases* immediately and irrevocably disappear from
+        # the API. All data in the databases is permanently deleted.
         # @param [String] name
-        #   Required. The name of the instance to be deleted. Values are of the form
-        #   `projects/<project>/instances/<instance>`
+        #   Required. The name of the instance to be deleted. Values are of the form `
+        #   projects//instances/`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -219,12 +203,11 @@ module Google
         
         # Gets information about a particular instance.
         # @param [String] name
-        #   Required. The name of the requested instance. Values are of the form
-        #   `projects/<project>/instances/<instance>`.
+        #   Required. The name of the requested instance. Values are of the form `projects/
+        #   /instances/`.
         # @param [String] field_mask
-        #   If field_mask is present, specifies the subset of Instance fields that
-        #   should be returned.
-        #   If absent, all Instance fields are returned.
+        #   If field_mask is present, specifies the subset of Instance fields that should
+        #   be returned. If absent, all Instance fields are returned.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -254,14 +237,12 @@ module Google
         end
         
         # Gets the access control policy for an instance resource. Returns an empty
-        # policy if an instance exists but does not have a policy set.
-        # Authorization requires `spanner.instances.getIamPolicy` on
-        # resource.
+        # policy if an instance exists but does not have a policy set. Authorization
+        # requires `spanner.instances.getIamPolicy` on resource.
         # @param [String] resource
         #   REQUIRED: The Cloud Spanner resource for which the policy is being retrieved.
-        #   The format is `projects/<project ID>/instances/<instance ID>` for instance
-        #   resources and `projects/<project ID>/instances/<instance ID>/databases/<
-        #   database ID>` for database resources.
+        #   The format is `projects//instances/` for instance resources and `projects//
+        #   instances//databases/` for database resources.
         # @param [Google::Apis::SpannerV1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -294,32 +275,25 @@ module Google
         
         # Lists all instances in the given project.
         # @param [String] parent
-        #   Required. The name of the project for which a list of instances is
-        #   requested. Values are of the form `projects/<project>`.
+        #   Required. The name of the project for which a list of instances is requested.
+        #   Values are of the form `projects/`.
         # @param [String] filter
-        #   An expression for filtering the results of the request. Filter rules are
-        #   case insensitive. The fields eligible for filtering are:
-        #   * `name`
-        #   * `display_name`
-        #   * `labels.key` where key is the name of a label
-        #   Some examples of using filters are:
-        #   * `name:*` --> The instance has a name.
-        #   * `name:Howl` --> The instance's name contains the string "howl".
-        #   * `name:HOWL` --> Equivalent to above.
-        #   * `NAME:howl` --> Equivalent to above.
-        #   * `labels.env:*` --> The instance has the label "env".
-        #   * `labels.env:dev` --> The instance has the label "env" and the 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
+        #   An expression for filtering the results of the request. Filter rules are case
+        #   insensitive. The fields eligible for filtering are: * `name` * `display_name` *
+        #   `labels.key` where key is the name of a label Some examples of using filters
+        #   are: * `name:*` --> The instance has a name. * `name:Howl` --> The instance's
+        #   name contains the string "howl". * `name:HOWL` --> Equivalent to above. * `
+        #   NAME:howl` --> Equivalent to above. * `labels.env:*` --> The instance has the
+        #   label "env". * `labels.env:dev` --> The instance has the label "env" and the
+        #   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 [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.
+        #   Number of instances to be returned in the response. If 0 or less, defaults to
+        #   the server's maximum allowed page size.
         # @param [String] page_token
-        #   If non-empty, `page_token` should contain a
-        #   next_page_token from a
-        #   previous ListInstancesResponse.
+        #   If non-empty, `page_token` should contain a next_page_token from a previous
+        #   ListInstancesResponse.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -350,43 +324,31 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates an instance, and begins allocating or releasing resources
-        # as requested. The returned long-running
-        # operation can be used to track the
-        # progress of updating the instance. If the named instance does not
-        # exist, returns `NOT_FOUND`.
-        # Immediately upon completion of this request:
-        # * For resource types for which a decrease in the instance's allocation
-        # has been requested, billing is based on the newly-requested level.
-        # Until completion of the returned operation:
-        # * Cancelling the operation sets its metadata's
-        # cancel_time, and begins
-        # restoring resources to their pre-request values. The operation
-        # is guaranteed to succeed at undoing all resource changes,
-        # after which point it terminates with a `CANCELLED` status.
-        # * All other attempts to modify the instance are rejected.
-        # * Reading the instance via the API continues to give the pre-request
-        # resource levels.
-        # Upon completion of the returned operation:
-        # * Billing begins for all successfully-allocated resources (some types
-        # may have lower than the requested levels).
-        # * All newly-reserved resources are available for serving the instance's
-        # tables.
-        # * The instance's new resource levels are readable via the API.
-        # The returned long-running operation will
-        # have a name of the format `<instance_name>/operations/<operation_id>` and
-        # can be used to track the instance modification.  The
-        # metadata field type is
-        # UpdateInstanceMetadata.
-        # The response field type is
-        # Instance, if successful.
-        # Authorization requires `spanner.instances.update` permission on
-        # resource name.
+        # Updates an instance, and begins allocating or releasing resources as requested.
+        # The returned long-running operation can be used to track the progress of
+        # updating the instance. If the named instance does not exist, returns `
+        # NOT_FOUND`. Immediately upon completion of this request: * For resource types
+        # for which a decrease in the instance's allocation has been requested, billing
+        # is based on the newly-requested level. Until completion of the returned
+        # operation: * Cancelling the operation sets its metadata's cancel_time, and
+        # begins restoring resources to their pre-request values. The operation is
+        # guaranteed to succeed at undoing all resource changes, after which point it
+        # terminates with a `CANCELLED` status. * All other attempts to modify the
+        # instance are rejected. * Reading the instance via the API continues to give
+        # the pre-request resource levels. Upon completion of the returned operation: *
+        # Billing begins for all successfully-allocated resources (some types may have
+        # lower than the requested levels). * All newly-reserved resources are available
+        # for serving the instance's tables. * The instance's new resource levels are
+        # readable via the API. The returned long-running operation will have a name of
+        # the format `/operations/` and can be used to track the instance modification.
+        # The metadata field type is UpdateInstanceMetadata. The response field type is
+        # Instance, if successful. Authorization requires `spanner.instances.update`
+        # permission on resource name.
         # @param [String] name
-        #   Required. A unique identifier for the instance, which cannot be changed
-        #   after the instance is created. Values are of the form
-        #   `projects/<project>/instances/a-z*[a-z0-9]`. The final
-        #   segment of the name must be between 2 and 64 characters in length.
+        #   Required. A unique identifier for the instance, which cannot be changed after
+        #   the instance is created. Values are of the form `projects//instances/a-z*[a-z0-
+        #   9]`. The final segment of the name must be between 2 and 64 characters in
+        #   length.
         # @param [Google::Apis::SpannerV1::UpdateInstanceRequest] update_instance_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -417,15 +379,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the access control policy on an instance resource. Replaces any
-        # existing policy.
-        # Authorization requires `spanner.instances.setIamPolicy` on
-        # resource.
+        # Sets the access control policy on an instance resource. Replaces any existing
+        # policy. Authorization requires `spanner.instances.setIamPolicy` on resource.
         # @param [String] resource
         #   REQUIRED: The Cloud Spanner resource for which the policy is being set. The
-        #   format is `projects/<project ID>/instances/<instance ID>` for instance
-        #   resources and `projects/<project ID>/instances/<instance ID>/databases/<
-        #   database ID>` for databases resources.
+        #   format is `projects//instances/` for instance resources and `projects//
+        #   instances//databases/` for databases resources.
         # @param [Google::Apis::SpannerV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -459,13 +418,12 @@ module Google
         # Returns permissions that the caller has on the specified instance resource.
         # Attempting this RPC on a non-existent Cloud Spanner instance resource will
         # result in a NOT_FOUND error if the user has `spanner.instances.list`
-        # permission on the containing Google Cloud Project. Otherwise returns an
-        # empty set of permissions.
+        # permission on the containing Google Cloud Project. Otherwise returns an empty
+        # set of permissions.
         # @param [String] resource
         #   REQUIRED: The Cloud Spanner resource for which permissions are being tested.
-        #   The format is `projects/<project ID>/instances/<instance ID>` for instance
-        #   resources and `projects/<project ID>/instances/<instance ID>/databases/<
-        #   database ID>` for database resources.
+        #   The format is `projects//instances/` for instance resources and `projects//
+        #   instances//databases/` for database resources.
         # @param [Google::Apis::SpannerV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -496,63 +454,47 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the backup long-running operations in
-        # the given instance. A backup operation has a name of the form
-        # `projects/<project>/instances/<instance>/backups/<backup>/operations/<
-        # operation>`.
-        # The long-running operation
-        # metadata field type
-        # `metadata.type_url` describes the type of the metadata. Operations returned
-        # include those that have completed/failed/canceled within the last 7 days,
-        # and pending operations. Operations returned are ordered by
-        # `operation.metadata.value.progress.start_time` in descending order starting
-        # from the most recently started operation.
+        # Lists the backup long-running operations in the given instance. A backup
+        # operation has a name of the form `projects//instances//backups//operations/`.
+        # The long-running operation metadata field type `metadata.type_url` describes
+        # the type of the metadata. Operations returned include those that have
+        # completed/failed/canceled within the last 7 days, and pending operations.
+        # Operations returned are ordered by `operation.metadata.value.progress.
+        # start_time` in descending order starting from the most recently started
+        # operation.
         # @param [String] parent
-        #   Required. The instance of the backup operations. Values are of
-        #   the form `projects/<project>/instances/<instance>`.
+        #   Required. The instance of the backup operations. Values are of the form `
+        #   projects//instances/`.
         # @param [String] filter
-        #   An expression that filters the list of returned backup operations.
-        #   A filter expression consists of a field name, a
-        #   comparison operator, and a value for filtering.
-        #   The value must be a string, a number, or a boolean. The comparison operator
-        #   must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`.
-        #   Colon `:` is the contains operator. Filter rules are not case sensitive.
-        #   The following fields in the operation
-        #   are eligible for filtering:
-        #   * `name` - The name of the long-running operation
-        #   * `done` - False if the operation is in progress, else true.
-        #   * `metadata.@type` - the type of metadata. For example, the type string
-        #   for CreateBackupMetadata is
-        #   `type.googleapis.com/google.spanner.admin.database.v1.
-        #   CreateBackupMetadata`.
-        #   * `metadata.<field_name>` - any field in metadata.value.
-        #   * `error` - Error associated with the long-running operation.
-        #   * `response.@type` - the type of response.
-        #   * `response.<field_name>` - any field in response.value.
-        #   You can combine multiple expressions by enclosing each expression in
-        #   parentheses. By default, expressions are combined with AND logic, but
-        #   you can specify AND, OR, and NOT logic explicitly.
-        #   Here are a few examples:
-        #   * `done:true` - The operation is complete.
-        #   * `metadata.database:prod` - The database the backup was taken from has
-        #   a name containing the string "prod".
-        #   * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.
-        #   CreateBackupMetadata) AND` \
-        #   `(metadata.name:howl) AND` \
-        #   `(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND` \
-        #   `(error:*)` - Returns operations where:
-        #   * The operation's metadata type is CreateBackupMetadata.
-        #   * The backup name contains the string "howl".
-        #   * The operation started before 2018-03-28T14:50:00Z.
-        #   * The operation resulted in an error.
+        #   An expression that filters the list of returned backup operations. A filter
+        #   expression consists of a field name, a comparison operator, and a value for
+        #   filtering. The value must be a string, a number, or a boolean. The comparison
+        #   operator must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`. Colon `:` is
+        #   the contains operator. Filter rules are not case sensitive. The following
+        #   fields in the operation are eligible for filtering: * `name` - The name of the
+        #   long-running operation * `done` - False if the operation is in progress, else
+        #   true. * `metadata.@type` - the type of metadata. For example, the type string
+        #   for CreateBackupMetadata is `type.googleapis.com/google.spanner.admin.database.
+        #   v1.CreateBackupMetadata`. * `metadata.` - any field in metadata.value. * `
+        #   error` - Error associated with the long-running operation. * `response.@type` -
+        #   the type of response. * `response.` - any field in response.value. You can
+        #   combine multiple expressions by enclosing each expression in parentheses. By
+        #   default, expressions are combined with AND logic, but you can specify AND, OR,
+        #   and NOT logic explicitly. Here are a few examples: * `done:true` - The
+        #   operation is complete. * `metadata.database:prod` - The database the backup
+        #   was taken from has a name containing the string "prod". * `(metadata.@type=
+        #   type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND`
+        #   \ `(metadata.name:howl) AND` \ `(metadata.progress.start_time < \"2018-03-
+        #   28T14:50:00Z\") AND` \ `(error:*)` - Returns operations where: * The operation'
+        #   s metadata type is CreateBackupMetadata. * The backup name contains the string
+        #   "howl". * The operation started before 2018-03-28T14:50:00Z. * The operation
+        #   resulted in an error.
         # @param [Fixnum] page_size
-        #   Number of operations to be returned in the response. If 0 or
-        #   less, defaults to the server's maximum allowed page size.
+        #   Number of operations to be returned in the response. If 0 or less, defaults to
+        #   the server's maximum allowed page size.
         # @param [String] page_token
-        #   If non-empty, `page_token` should contain a
-        #   next_page_token
-        #   from a previous ListBackupOperationsResponse to the
-        #   same `parent` and with the same `filter`.
+        #   If non-empty, `page_token` should contain a next_page_token from a previous
+        #   ListBackupOperationsResponse to the same `parent` and with the same `filter`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -583,31 +525,23 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Starts creating a new Cloud Spanner Backup.
-        # The returned backup long-running operation
-        # will have a name of the format
-        # `projects/<project>/instances/<instance>/backups/<backup>/operations/<
-        # operation_id>`
-        # and can be used to track creation of the backup. The
-        # metadata field type is
-        # CreateBackupMetadata. The
-        # response field type is
-        # Backup, if successful. Cancelling the returned operation will stop the
-        # creation and delete the backup.
-        # There can be only one pending backup creation per database. Backup creation
-        # of different databases can run concurrently.
+        # Starts creating a new Cloud Spanner Backup. The returned backup long-running
+        # operation will have a name of the format `projects//instances//backups//
+        # operations/` and can be used to track creation of the backup. The metadata
+        # field type is CreateBackupMetadata. The response field type is Backup, if
+        # successful. Cancelling the returned operation will stop the creation and
+        # delete the backup. There can be only one pending backup creation per database.
+        # Backup creation of different databases can run concurrently.
         # @param [String] parent
-        #   Required. The name of the instance in which the backup will be
-        #   created. This must be the same instance that contains the database the
-        #   backup will be created from. The backup will be stored in the
-        #   location(s) specified in the instance configuration of this
-        #   instance. Values are of the form
-        #   `projects/<project>/instances/<instance>`.
+        #   Required. The name of the instance in which the backup will be created. This
+        #   must be the same instance that contains the database the backup will be
+        #   created from. The backup will be stored in the location(s) specified in the
+        #   instance configuration of this instance. Values are of the form `projects//
+        #   instances/`.
         # @param [Google::Apis::SpannerV1::Backup] backup_object
         # @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/<project>/instances/<instance>/backups/<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] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -640,9 +574,8 @@ module Google
         
         # Deletes a pending or completed Backup.
         # @param [String] name
-        #   Required. Name of the backup to delete.
-        #   Values are of the form
-        #   `projects/<project>/instances/<instance>/backups/<backup>`.
+        #   Required. Name of the backup to delete. Values are of the form `projects//
+        #   instances//backups/`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -672,9 +605,8 @@ module Google
         
         # Gets metadata on a pending or completed Backup.
         # @param [String] name
-        #   Required. Name of the backup.
-        #   Values are of the form
-        #   `projects/<project>/instances/<instance>/backups/<backup>`.
+        #   Required. Name of the backup. Values are of the form `projects//instances//
+        #   backups/`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -702,18 +634,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a database or backup resource.
-        # Returns an empty policy if a database or backup exists but does not have a
-        # policy set.
-        # Authorization requires `spanner.databases.getIamPolicy` permission on
-        # resource.
-        # For backups, authorization requires `spanner.backups.getIamPolicy`
-        # permission on resource.
+        # Gets the access control policy for a database or backup resource. Returns an
+        # empty policy if a database or backup exists but does not have a policy set.
+        # Authorization requires `spanner.databases.getIamPolicy` permission on resource.
+        # For backups, authorization requires `spanner.backups.getIamPolicy` permission
+        # on resource.
         # @param [String] resource
         #   REQUIRED: The Cloud Spanner resource for which the policy is being retrieved.
-        #   The format is `projects/<project ID>/instances/<instance ID>` for instance
-        #   resources and `projects/<project ID>/instances/<instance ID>/databases/<
-        #   database ID>` for database resources.
+        #   The format is `projects//instances/` for instance resources and `projects//
+        #   instances//databases/` for database resources.
         # @param [Google::Apis::SpannerV1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -744,49 +673,37 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists completed and pending backups.
-        # Backups returned are ordered by `create_time` in descending order,
-        # starting from the most recent `create_time`.
+        # Lists completed and pending backups. Backups returned are ordered by `
+        # create_time` in descending order, starting from the most recent `create_time`.
         # @param [String] parent
-        #   Required. The instance to list backups from.  Values are of the
-        #   form `projects/<project>/instances/<instance>`.
+        #   Required. The instance to list backups from. Values are of the form `projects//
+        #   instances/`.
         # @param [String] filter
-        #   An expression that filters the list of returned backups.
-        #   A filter expression consists of a field name, a comparison operator, and a
-        #   value for filtering.
+        #   An expression that filters the list of returned backups. A filter expression
+        #   consists of a field name, a comparison operator, and a value for filtering.
         #   The value must be a string, a number, or a boolean. The comparison operator
-        #   must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`.
-        #   Colon `:` is the 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`
+        #   must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`. Colon `:` is the
+        #   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
+        #   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.
+        #   Number of backups to be returned in the response. If 0 or less, defaults to
+        #   the server's maximum allowed page size.
         # @param [String] page_token
-        #   If non-empty, `page_token` should contain a
-        #   next_page_token from a
-        #   previous ListBackupsResponse to the same `parent` and with the same
-        #   `filter`.
+        #   If non-empty, `page_token` should contain a next_page_token from a previous
+        #   ListBackupsResponse to the same `parent` and with the same `filter`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -819,24 +736,20 @@ module Google
         
         # Updates a pending or completed Backup.
         # @param [String] name
-        #   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>`.
+        #   Output only for the CreateBackup operation. Required for the UpdateBackup
+        #   operation. A globally unique identifier for the backup which cannot be changed.
+        #   Values are of the form `projects//instances//backups/a-z*[a-z0-9]` The final
+        #   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//instances/`.
         # @param [Google::Apis::SpannerV1::Backup] backup_object
         # @param [String] update_mask
-        #   Required. A mask specifying which fields (e.g. `expire_time`) in the
-        #   Backup resource should be updated. This mask is relative to the Backup
-        #   resource, not to the request message. The field mask must always be
-        #   specified; this prevents any future fields from being erased accidentally
-        #   by clients that do not know about them.
+        #   Required. A mask specifying which fields (e.g. `expire_time`) in the Backup
+        #   resource should be updated. This mask is relative to the Backup resource, not
+        #   to the request message. The field mask must always be specified; this prevents
+        #   any future fields from being erased accidentally by clients that do not know
+        #   about them.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -867,17 +780,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the access control policy on a database or backup resource.
-        # Replaces any existing policy.
-        # Authorization requires `spanner.databases.setIamPolicy`
-        # permission on resource.
-        # For backups, authorization requires `spanner.backups.setIamPolicy`
-        # permission on resource.
+        # Sets the access control policy on a database or backup resource. Replaces any
+        # existing policy. Authorization requires `spanner.databases.setIamPolicy`
+        # permission on resource. For backups, authorization requires `spanner.backups.
+        # setIamPolicy` permission on resource.
         # @param [String] resource
         #   REQUIRED: The Cloud Spanner resource for which the policy is being set. The
-        #   format is `projects/<project ID>/instances/<instance ID>` for instance
-        #   resources and `projects/<project ID>/instances/<instance ID>/databases/<
-        #   database ID>` for databases resources.
+        #   format is `projects//instances/` for instance resources and `projects//
+        #   instances//databases/` for databases resources.
         # @param [Google::Apis::SpannerV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -909,19 +819,16 @@ module Google
         end
         
         # Returns permissions that the caller has on the specified database or backup
-        # resource.
-        # Attempting this RPC on a non-existent Cloud Spanner database will
-        # result in a NOT_FOUND error if the user has
-        # `spanner.databases.list` permission on the containing Cloud
-        # Spanner instance. Otherwise returns an empty set of permissions.
-        # Calling this method on a backup that does not exist will
-        # result in a NOT_FOUND error if the user has
-        # `spanner.backups.list` permission on the containing instance.
+        # resource. Attempting this RPC on a non-existent Cloud Spanner database will
+        # result in a NOT_FOUND error if the user has `spanner.databases.list`
+        # permission on the containing Cloud Spanner instance. Otherwise returns an
+        # empty set of permissions. Calling this method on a backup that does not exist
+        # will result in a NOT_FOUND error if the user has `spanner.backups.list`
+        # permission on the containing instance.
         # @param [String] resource
         #   REQUIRED: The Cloud Spanner resource for which permissions are being tested.
-        #   The format is `projects/<project ID>/instances/<instance ID>` for instance
-        #   resources and `projects/<project ID>/instances/<instance ID>/databases/<
-        #   database ID>` for database resources.
+        #   The format is `projects//instances/` for instance resources and `projects//
+        #   instances//databases/` for database resources.
         # @param [Google::Apis::SpannerV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -952,15 +859,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Starts asynchronous cancellation on a long-running operation.  The server
-        # makes a best effort to cancel the operation, but success is not
-        # guaranteed.  If the server doesn't support this method, it returns
-        # `google.rpc.Code.UNIMPLEMENTED`.  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,
+        # Starts asynchronous cancellation on a long-running operation. The server makes
+        # a best effort to cancel the operation, but success is not guaranteed. If the
+        # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
+        # 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`.
         # @param [String] name
         #   The name of the operation resource to be cancelled.
@@ -991,10 +896,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a long-running operation. This method indicates that the client is
-        # no longer interested in the operation result. It does not cancel the
-        # operation. If the server doesn't support this method, it returns
-        # `google.rpc.Code.UNIMPLEMENTED`.
+        # Deletes a long-running operation. This method indicates that the client is no
+        # longer interested in the operation result. It does not cancel the operation.
+        # If the server doesn't support this method, it returns `google.rpc.Code.
+        # UNIMPLEMENTED`.
         # @param [String] name
         #   The name of the operation resource to be deleted.
         # @param [String] fields
@@ -1024,9 +929,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
-        # method to poll the operation result at intervals as recommended by the API
-        # service.
+        # Gets the latest state of a long-running operation. Clients can use this method
+        # to poll the operation result at intervals as recommended by the API service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -1056,15 +960,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists operations that match the specified filter in the request. If the
-        # server doesn't support this method, it returns `UNIMPLEMENTED`.
-        # NOTE: the `name` binding allows API services to override the binding
-        # to use different resource name schemes, such as `users/*/operations`. To
-        # override the binding, API services can add a binding such as
-        # `"/v1/`name=users/*`/operations"` to their service configuration.
-        # For backwards compatibility, the default name includes the operations
-        # collection id, however overriding users must ensure the name binding
-        # is the parent resource, without the operations collection id.
+        # Lists operations that match the specified filter in the request. If the server
+        # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
+        # binding allows API services to override the binding to use different resource
+        # name schemes, such as `users/*/operations`. To override the binding, API
+        # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
+        # service configuration. For backwards compatibility, the default name includes
+        # the operations collection id, however overriding users must ensure the name
+        # binding is the parent resource, without the operations collection id.
         # @param [String] name
         #   The name of the operation's parent resource.
         # @param [String] filter
@@ -1103,63 +1006,45 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists database longrunning-operations.
-        # A database operation has a name of the form
-        # `projects/<project>/instances/<instance>/databases/<database>/operations/<
-        # operation>`.
-        # The long-running operation
-        # metadata field type
-        # `metadata.type_url` describes the type of the metadata. Operations returned
-        # include those that have completed/failed/canceled within the last 7 days,
-        # and pending operations.
+        # Lists database longrunning-operations. A database operation has a name of the
+        # form `projects//instances//databases//operations/`. The long-running operation
+        # metadata field type `metadata.type_url` describes the type of the metadata.
+        # Operations returned include those that have completed/failed/canceled within
+        # the last 7 days, and pending operations.
         # @param [String] parent
-        #   Required. The instance of the database operations.
-        #   Values are of the form `projects/<project>/instances/<instance>`.
+        #   Required. The instance of the database operations. Values are of the form `
+        #   projects//instances/`.
         # @param [String] filter
-        #   An expression that filters the list of returned operations.
-        #   A filter expression consists of a field name, a
-        #   comparison operator, and a value for filtering.
-        #   The value must be a string, a number, or a boolean. The comparison operator
-        #   must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`.
-        #   Colon `:` is the contains operator. Filter rules are not case sensitive.
-        #   The following fields in the Operation
-        #   are eligible for filtering:
-        #   * `name` - The name of the long-running operation
-        #   * `done` - False if the operation is in progress, else true.
-        #   * `metadata.@type` - the type of metadata. For example, the type string
-        #   for RestoreDatabaseMetadata is
-        #   `type.googleapis.com/google.spanner.admin.database.v1.
-        #   RestoreDatabaseMetadata`.
-        #   * `metadata.<field_name>` - any field in metadata.value.
-        #   * `error` - Error associated with the long-running operation.
-        #   * `response.@type` - the type of response.
-        #   * `response.<field_name>` - any field in response.value.
-        #   You can combine multiple expressions by enclosing each expression in
-        #   parentheses. By default, expressions are combined with AND logic. However,
-        #   you can specify AND, OR, and NOT logic explicitly.
-        #   Here are a few examples:
-        #   * `done:true` - The operation is complete.
-        #   * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.
-        #   RestoreDatabaseMetadata) AND` \
-        #   `(metadata.source_type:BACKUP) AND` \
-        #   `(metadata.backup_info.backup:backup_howl) AND` \
-        #   `(metadata.name:restored_howl) AND` \
-        #   `(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND` \
-        #   `(error:*)` - Return operations where:
-        #   * The operation's metadata type is RestoreDatabaseMetadata.
-        #   * The database is restored from a backup.
-        #   * The backup name contains "backup_howl".
-        #   * The restored database's name contains "restored_howl".
-        #   * The operation started before 2018-03-28T14:50:00Z.
-        #   * The operation resulted in an error.
+        #   An expression that filters the list of returned operations. A filter
+        #   expression consists of a field name, a comparison operator, and a value for
+        #   filtering. The value must be a string, a number, or a boolean. The comparison
+        #   operator must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`. Colon `:` is
+        #   the contains operator. Filter rules are not case sensitive. The following
+        #   fields in the Operation are eligible for filtering: * `name` - The name of the
+        #   long-running operation * `done` - False if the operation is in progress, else
+        #   true. * `metadata.@type` - the type of metadata. For example, the type string
+        #   for RestoreDatabaseMetadata is `type.googleapis.com/google.spanner.admin.
+        #   database.v1.RestoreDatabaseMetadata`. * `metadata.` - any field in metadata.
+        #   value. * `error` - Error associated with the long-running operation. * `
+        #   response.@type` - the type of response. * `response.` - any field in response.
+        #   value. You can combine multiple expressions by enclosing each expression in
+        #   parentheses. By default, expressions are combined with AND logic. However, you
+        #   can specify AND, OR, and NOT logic explicitly. Here are a few examples: * `
+        #   done:true` - The operation is complete. * `(metadata.@type=type.googleapis.com/
+        #   google.spanner.admin.database.v1.RestoreDatabaseMetadata) AND` \ `(metadata.
+        #   source_type:BACKUP) AND` \ `(metadata.backup_info.backup:backup_howl) AND` \ `(
+        #   metadata.name:restored_howl) AND` \ `(metadata.progress.start_time < \"2018-03-
+        #   28T14:50:00Z\") AND` \ `(error:*)` - Return operations where: * The operation'
+        #   s metadata type is RestoreDatabaseMetadata. * The database is restored from a
+        #   backup. * The backup name contains "backup_howl". * The restored database's
+        #   name contains "restored_howl". * The operation started before 2018-03-28T14:50:
+        #   00Z. * The operation resulted in an error.
         # @param [Fixnum] page_size
-        #   Number of operations to be returned in the response. If 0 or
-        #   less, defaults to the server's maximum allowed page size.
+        #   Number of operations to be returned in the response. If 0 or less, defaults to
+        #   the server's maximum allowed page size.
         # @param [String] page_token
-        #   If non-empty, `page_token` should contain a
-        #   next_page_token
-        #   from a previous ListDatabaseOperationsResponse to the
-        #   same `parent` and with the same `filter`.
+        #   If non-empty, `page_token` should contain a next_page_token from a previous
+        #   ListDatabaseOperationsResponse to the same `parent` and with the same `filter`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1190,17 +1075,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new Cloud Spanner database and starts to prepare it for serving.
-        # The returned long-running operation will
-        # have a name of the format `<database_name>/operations/<operation_id>` and
-        # can be used to track preparation of the database. The
-        # metadata field type is
-        # CreateDatabaseMetadata. The
-        # response field type is
-        # Database, if successful.
+        # Creates a new Cloud Spanner database and starts to prepare it for serving. The
+        # returned long-running operation will have a name of the format `/operations/`
+        # and can be used to track preparation of the database. The metadata field type
+        # is CreateDatabaseMetadata. The response field type is Database, if successful.
         # @param [String] parent
-        #   Required. The name of the instance that will serve the new database.
-        #   Values are of the form `projects/<project>/instances/<instance>`.
+        #   Required. The name of the instance that will serve the new database. Values
+        #   are of the form `projects//instances/`.
         # @param [Google::Apis::SpannerV1::CreateDatabaseRequest] create_database_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1231,9 +1112,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Drops (aka deletes) a Cloud Spanner database.
-        # Completed backups for the database will be retained according to their
-        # `expire_time`.
+        # Drops (aka deletes) a Cloud Spanner database. Completed backups for the
+        # database will be retained according to their `expire_time`.
         # @param [String] database
         #   Required. The database to be dropped.
         # @param [String] fields
@@ -1265,8 +1145,8 @@ module Google
         
         # Gets the state of a Cloud Spanner database.
         # @param [String] name
-        #   Required. The name of the requested database. Values are of the form
-        #   `projects/<project>/instances/<instance>/databases/<database>`.
+        #   Required. The name of the requested database. Values are of the form `projects/
+        #   /instances//databases/`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1294,13 +1174,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the schema of a Cloud Spanner database as a list of formatted
-        # DDL statements. This method does not show pending schema updates, those may
-        # be queried using the Operations API.
+        # Returns the schema of a Cloud Spanner database as a list of formatted DDL
+        # statements. This method does not show pending schema updates, those may be
+        # queried using the Operations API.
         # @param [String] database
-        #   Required. The database whose schema we wish to get.
-        #   Values are of the form
-        #   `projects/<project>/instances/<instance>/databases/<database>`
+        #   Required. The database whose schema we wish to get. Values are of the form `
+        #   projects//instances//databases/`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1328,18 +1207,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a database or backup resource.
-        # Returns an empty policy if a database or backup exists but does not have a
-        # policy set.
-        # Authorization requires `spanner.databases.getIamPolicy` permission on
-        # resource.
-        # For backups, authorization requires `spanner.backups.getIamPolicy`
-        # permission on resource.
+        # Gets the access control policy for a database or backup resource. Returns an
+        # empty policy if a database or backup exists but does not have a policy set.
+        # Authorization requires `spanner.databases.getIamPolicy` permission on resource.
+        # For backups, authorization requires `spanner.backups.getIamPolicy` permission
+        # on resource.
         # @param [String] resource
         #   REQUIRED: The Cloud Spanner resource for which the policy is being retrieved.
-        #   The format is `projects/<project ID>/instances/<instance ID>` for instance
-        #   resources and `projects/<project ID>/instances/<instance ID>/databases/<
-        #   database ID>` for database resources.
+        #   The format is `projects//instances/` for instance resources and `projects//
+        #   instances//databases/` for database resources.
         # @param [Google::Apis::SpannerV1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1372,15 +1248,14 @@ module Google
         
         # Lists Cloud Spanner databases.
         # @param [String] parent
-        #   Required. The instance whose databases should be listed.
-        #   Values are of the form `projects/<project>/instances/<instance>`.
+        #   Required. The instance whose databases should be listed. Values are of the
+        #   form `projects//instances/`.
         # @param [Fixnum] page_size
-        #   Number of databases to be returned in the response. If 0 or less,
-        #   defaults to the server's maximum allowed page size.
+        #   Number of databases to be returned in the response. If 0 or less, defaults to
+        #   the server's maximum allowed page size.
         # @param [String] page_token
-        #   If non-empty, `page_token` should contain a
-        #   next_page_token from a
-        #   previous ListDatabasesResponse.
+        #   If non-empty, `page_token` should contain a next_page_token from a previous
+        #   ListDatabasesResponse.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1410,30 +1285,23 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Create a new database by restoring from a completed backup. The new
-        # database must be in the same project and in an instance with the same
-        # instance configuration as the instance containing
-        # the backup. The returned database long-running
-        # operation has a name of the format
-        # `projects/<project>/instances/<instance>/databases/<database>/operations/<
-        # operation_id>`,
-        # and can be used to track the progress of the operation, and to cancel it.
-        # The metadata field type is
-        # RestoreDatabaseMetadata.
-        # The response type
-        # is Database, if
-        # successful. Cancelling the returned operation will stop the restore and
-        # delete the database.
-        # There can be only one database being restored into an instance at a time.
-        # Once the restore operation completes, a new restore operation can be
+        # Create a new database by restoring from a completed backup. The new database
+        # must be in the same project and in an instance with the same instance
+        # configuration as the instance containing the backup. The returned database
+        # long-running operation has a name of the format `projects//instances//
+        # databases//operations/`, and can be used to track the progress of the
+        # operation, and to cancel it. The metadata field type is
+        # RestoreDatabaseMetadata. The response type is Database, if successful.
+        # Cancelling the returned operation will stop the restore and delete the
+        # database. There can be only one database being restored into an instance at a
+        # time. Once the restore operation completes, a new restore operation can be
         # initiated, without waiting for the optimize operation associated with the
         # first restore to complete.
         # @param [String] parent
-        #   Required. The name of the instance in which to create the
-        #   restored database. This instance must be in the same project and
-        #   have the same instance configuration as the instance containing
-        #   the source backup. Values are of the form
-        #   `projects/<project>/instances/<instance>`.
+        #   Required. The name of the instance in which to create the restored database.
+        #   This instance must be in the same project and have the same instance
+        #   configuration as the instance containing the source backup. Values are of the
+        #   form `projects//instances/`.
         # @param [Google::Apis::SpannerV1::RestoreDatabaseRequest] restore_database_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1464,17 +1332,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the access control policy on a database or backup resource.
-        # Replaces any existing policy.
-        # Authorization requires `spanner.databases.setIamPolicy`
-        # permission on resource.
-        # For backups, authorization requires `spanner.backups.setIamPolicy`
-        # permission on resource.
+        # Sets the access control policy on a database or backup resource. Replaces any
+        # existing policy. Authorization requires `spanner.databases.setIamPolicy`
+        # permission on resource. For backups, authorization requires `spanner.backups.
+        # setIamPolicy` permission on resource.
         # @param [String] resource
         #   REQUIRED: The Cloud Spanner resource for which the policy is being set. The
-        #   format is `projects/<project ID>/instances/<instance ID>` for instance
-        #   resources and `projects/<project ID>/instances/<instance ID>/databases/<
-        #   database ID>` for databases resources.
+        #   format is `projects//instances/` for instance resources and `projects//
+        #   instances//databases/` for databases resources.
         # @param [Google::Apis::SpannerV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1506,19 +1371,16 @@ module Google
         end
         
         # Returns permissions that the caller has on the specified database or backup
-        # resource.
-        # Attempting this RPC on a non-existent Cloud Spanner database will
-        # result in a NOT_FOUND error if the user has
-        # `spanner.databases.list` permission on the containing Cloud
-        # Spanner instance. Otherwise returns an empty set of permissions.
-        # Calling this method on a backup that does not exist will
-        # result in a NOT_FOUND error if the user has
-        # `spanner.backups.list` permission on the containing instance.
+        # resource. Attempting this RPC on a non-existent Cloud Spanner database will
+        # result in a NOT_FOUND error if the user has `spanner.databases.list`
+        # permission on the containing Cloud Spanner instance. Otherwise returns an
+        # empty set of permissions. Calling this method on a backup that does not exist
+        # will result in a NOT_FOUND error if the user has `spanner.backups.list`
+        # permission on the containing instance.
         # @param [String] resource
         #   REQUIRED: The Cloud Spanner resource for which permissions are being tested.
-        #   The format is `projects/<project ID>/instances/<instance ID>` for instance
-        #   resources and `projects/<project ID>/instances/<instance ID>/databases/<
-        #   database ID>` for database resources.
+        #   The format is `projects//instances/` for instance resources and `projects//
+        #   instances//databases/` for database resources.
         # @param [Google::Apis::SpannerV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1549,13 +1411,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the schema of a Cloud Spanner database by
-        # creating/altering/dropping tables, columns, indexes, etc. The returned
-        # long-running operation will have a name of
-        # the format `<database_name>/operations/<operation_id>` and can be used to
-        # track execution of the schema change(s). The
-        # metadata field type is
-        # UpdateDatabaseDdlMetadata.  The operation has no response.
+        # Updates the schema of a Cloud Spanner database by creating/altering/dropping
+        # tables, columns, indexes, etc. The returned long-running operation will have a
+        # name of the format `/operations/` and can be used to track execution of the
+        # schema change(s). The metadata field type is UpdateDatabaseDdlMetadata. The
+        # operation has no response.
         # @param [String] database
         #   Required. The database to update.
         # @param [Google::Apis::SpannerV1::UpdateDatabaseDdlRequest] update_database_ddl_request_object
@@ -1588,15 +1448,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Starts asynchronous cancellation on a long-running operation.  The server
-        # makes a best effort to cancel the operation, but success is not
-        # guaranteed.  If the server doesn't support this method, it returns
-        # `google.rpc.Code.UNIMPLEMENTED`.  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,
+        # Starts asynchronous cancellation on a long-running operation. The server makes
+        # a best effort to cancel the operation, but success is not guaranteed. If the
+        # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
+        # 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`.
         # @param [String] name
         #   The name of the operation resource to be cancelled.
@@ -1627,10 +1485,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a long-running operation. This method indicates that the client is
-        # no longer interested in the operation result. It does not cancel the
-        # operation. If the server doesn't support this method, it returns
-        # `google.rpc.Code.UNIMPLEMENTED`.
+        # Deletes a long-running operation. This method indicates that the client is no
+        # longer interested in the operation result. It does not cancel the operation.
+        # If the server doesn't support this method, it returns `google.rpc.Code.
+        # UNIMPLEMENTED`.
         # @param [String] name
         #   The name of the operation resource to be deleted.
         # @param [String] fields
@@ -1660,9 +1518,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
-        # method to poll the operation result at intervals as recommended by the API
-        # service.
+        # Gets the latest state of a long-running operation. Clients can use this method
+        # to poll the operation result at intervals as recommended by the API service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -1692,15 +1549,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists operations that match the specified filter in the request. If the
-        # server doesn't support this method, it returns `UNIMPLEMENTED`.
-        # NOTE: the `name` binding allows API services to override the binding
-        # to use different resource name schemes, such as `users/*/operations`. To
-        # override the binding, API services can add a binding such as
-        # `"/v1/`name=users/*`/operations"` to their service configuration.
-        # For backwards compatibility, the default name includes the operations
-        # collection id, however overriding users must ensure the name binding
-        # is the parent resource, without the operations collection id.
+        # Lists operations that match the specified filter in the request. If the server
+        # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
+        # binding allows API services to override the binding to use different resource
+        # name schemes, such as `users/*/operations`. To override the binding, API
+        # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
+        # service configuration. For backwards compatibility, the default name includes
+        # the operations collection id, however overriding users must ensure the name
+        # binding is the parent resource, without the operations collection id.
         # @param [String] name
         #   The name of the operation's parent resource.
         # @param [String] filter
@@ -1739,9 +1595,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates multiple new sessions.
-        # This API can be used to initialize a session cache on the clients.
-        # See https://goo.gl/TgSFN2 for best practices on session cache management.
+        # Creates multiple new sessions. This API can be used to initialize a session
+        # cache on the clients. See https://goo.gl/TgSFN2 for best practices on session
+        # cache management.
         # @param [String] database
         #   Required. The database in which the new sessions are created.
         # @param [Google::Apis::SpannerV1::BatchCreateSessionsRequest] batch_create_sessions_request_object
@@ -1774,10 +1630,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Begins a new transaction. This step can often be skipped:
-        # Read, ExecuteSql and
-        # Commit can begin a new transaction as a
-        # side-effect.
+        # Begins a new transaction. This step can often be skipped: Read, ExecuteSql and
+        # Commit can begin a new transaction as a side-effect.
         # @param [String] session
         #   Required. The session in which the transaction runs.
         # @param [Google::Apis::SpannerV1::BeginTransactionRequest] begin_transaction_request_object
@@ -1810,18 +1664,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Commits a transaction. The request includes the mutations to be
-        # applied to rows in the database.
-        # `Commit` might return an `ABORTED` error. This can occur at any time;
-        # commonly, the cause is conflicts with concurrent
-        # transactions. However, it can also happen for a variety of other
-        # reasons. If `Commit` returns `ABORTED`, the caller should re-attempt
-        # the transaction from the beginning, re-using the same session.
-        # On very rare occasions, `Commit` might return `UNKNOWN`. This can happen,
-        # for example, if the client job experiences a 1+ hour networking failure.
-        # At that point, Cloud Spanner has lost track of the transaction outcome and
-        # we recommend that you perform another read from the database to see the
-        # state of things as they are now.
+        # Commits a transaction. The request includes the mutations to be applied to
+        # rows in the database. `Commit` might return an `ABORTED` error. This can occur
+        # at any time; commonly, the cause is conflicts with concurrent transactions.
+        # However, it can also happen for a variety of other reasons. If `Commit`
+        # returns `ABORTED`, the caller should re-attempt the transaction from the
+        # beginning, re-using the same session. On very rare occasions, `Commit` might
+        # return `UNKNOWN`. This can happen, for example, if the client job experiences
+        # a 1+ hour networking failure. At that point, Cloud Spanner has lost track of
+        # the transaction outcome and we recommend that you perform another read from
+        # the database to see the state of things as they are now.
         # @param [String] session
         #   Required. The session in which the transaction to be committed is running.
         # @param [Google::Apis::SpannerV1::CommitRequest] commit_request_object
@@ -1854,22 +1706,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new session. A session can be used to perform
-        # transactions that read and/or modify data in a Cloud Spanner database.
-        # Sessions are meant to be reused for many consecutive
-        # transactions.
-        # Sessions can only execute one transaction at a time. To execute
-        # multiple concurrent read-write/write-only transactions, create
-        # multiple sessions. Note that standalone reads and queries use a
-        # transaction internally, and count toward the one transaction
-        # limit.
+        # Creates a new session. A session can be used to perform transactions that read
+        # and/or modify data in a Cloud Spanner database. Sessions are meant to be
+        # reused for many consecutive transactions. Sessions can only execute one
+        # transaction at a time. To execute multiple concurrent read-write/write-only
+        # transactions, create multiple sessions. Note that standalone reads and queries
+        # use a transaction internally, and count toward the one transaction limit.
         # Active sessions use additional server resources, so it is a good idea to
-        # delete idle and unneeded sessions.
-        # Aside from explicit deletes, Cloud Spanner may delete sessions for which no
-        # operations are sent for more than an hour. If a session is deleted,
-        # requests to it return `NOT_FOUND`.
-        # Idle sessions can be kept alive by sending a trivial SQL query
-        # periodically, e.g., `"SELECT 1"`.
+        # delete idle and unneeded sessions. Aside from explicit deletes, Cloud Spanner
+        # may delete sessions for which no operations are sent for more than an hour. If
+        # a session is deleted, requests to it return `NOT_FOUND`. Idle sessions can be
+        # kept alive by sending a trivial SQL query periodically, e.g., `"SELECT 1"`.
         # @param [String] database
         #   Required. The database in which the new session is created.
         # @param [Google::Apis::SpannerV1::CreateSessionRequest] create_session_request_object
@@ -1934,15 +1781,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Executes a batch of SQL DML statements. This method allows many statements
-        # to be run with lower latency than submitting them sequentially with
-        # ExecuteSql.
-        # Statements are executed in sequential order. A request can succeed even if
-        # a statement fails. The ExecuteBatchDmlResponse.status field in the
-        # response provides information about the statement that failed. Clients must
-        # inspect this field to determine whether an error occurred.
-        # Execution stops after the first failed statement; the remaining statements
-        # are not executed.
+        # Executes a batch of SQL DML statements. This method allows many statements to
+        # be run with lower latency than submitting them sequentially with ExecuteSql.
+        # Statements are executed in sequential order. A request can succeed even if a
+        # statement fails. The ExecuteBatchDmlResponse.status field in the response
+        # provides information about the statement that failed. Clients must inspect
+        # this field to determine whether an error occurred. Execution stops after the
+        # first failed statement; the remaining statements are not executed.
         # @param [String] session
         #   Required. The session in which the DML statements should be performed.
         # @param [Google::Apis::SpannerV1::ExecuteBatchDmlRequest] execute_batch_dml_request_object
@@ -1976,14 +1821,12 @@ module Google
         end
         
         # Executes an SQL statement, returning all results in a single reply. This
-        # method cannot be used to return a result set larger than 10 MiB;
-        # if the query yields more data than that, the query fails with
-        # a `FAILED_PRECONDITION` error.
-        # Operations inside read-write transactions might return `ABORTED`. If
-        # this occurs, the application should restart the transaction from
-        # the beginning. See Transaction for more details.
-        # Larger result sets can be fetched in streaming fashion by calling
-        # ExecuteStreamingSql instead.
+        # method cannot be used to return a result set larger than 10 MiB; if the query
+        # yields more data than that, the query fails with a `FAILED_PRECONDITION` error.
+        # Operations inside read-write transactions might return `ABORTED`. If this
+        # occurs, the application should restart the transaction from the beginning. See
+        # Transaction for more details. Larger result sets can be fetched in streaming
+        # fashion by calling ExecuteStreamingSql instead.
         # @param [String] session
         #   Required. The session in which the SQL query should be performed.
         # @param [Google::Apis::SpannerV1::ExecuteSqlRequest] execute_sql_request_object
@@ -2016,11 +1859,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Like ExecuteSql, except returns the result
-        # set as a stream. Unlike ExecuteSql, there
-        # is no limit on the size of the returned result set. However, no
-        # individual row in the result set can exceed 100 MiB, and no
-        # column value can exceed 10 MiB.
+        # Like ExecuteSql, except returns the result set as a stream. Unlike ExecuteSql,
+        # there is no limit on the size of the returned result set. However, no
+        # individual row in the result set can exceed 100 MiB, and no column value can
+        # exceed 10 MiB.
         # @param [String] session
         #   Required. The session in which the SQL query should be performed.
         # @param [Google::Apis::SpannerV1::ExecuteSqlRequest] execute_sql_request_object
@@ -2053,9 +1895,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a session. Returns `NOT_FOUND` if the session does not exist.
-        # This is mainly useful for determining whether a session is still
-        # alive.
+        # Gets a session. Returns `NOT_FOUND` if the session does not exist. This is
+        # mainly useful for determining whether a session is still alive.
         # @param [String] name
         #   Required. The name of the session to retrieve.
         # @param [String] fields
@@ -2089,19 +1930,16 @@ module Google
         # @param [String] database
         #   Required. The database in which to list sessions.
         # @param [String] filter
-        #   An expression for filtering the results of the request. Filter rules are
-        #   case insensitive. The fields eligible for filtering are:
-        #   * `labels.key` where key is the name of a label
-        #   Some examples of using filters are:
-        #   * `labels.env:*` --> The session has the label "env".
-        #   * `labels.env:dev` --> The session has the label "env" and the value of
-        #   the label contains the string "dev".
+        #   An expression for filtering the results of the request. Filter rules are case
+        #   insensitive. The fields eligible for filtering are: * `labels.key` where key
+        #   is the name of a label Some examples of using filters are: * `labels.env:*` -->
+        #   The session has the label "env". * `labels.env:dev` --> The session has the
+        #   label "env" and the value of the label contains the string "dev".
         # @param [Fixnum] page_size
-        #   Number of sessions to be returned in the response. If 0 or less, defaults
-        #   to the server's maximum allowed page size.
+        #   Number of sessions to be returned in the response. If 0 or less, defaults to
+        #   the server's maximum allowed page size.
         # @param [String] page_token
-        #   If non-empty, `page_token` should contain a
-        #   next_page_token from a previous
+        #   If non-empty, `page_token` should contain a next_page_token from a previous
         #   ListSessionsResponse.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2134,15 +1972,14 @@ module Google
         end
         
         # Creates a set of partition tokens that can be used to execute a query
-        # operation in parallel.  Each of the returned partition tokens can be used
-        # by ExecuteStreamingSql to specify a subset
-        # of the query result to read.  The same session and read-only transaction
-        # must be used by the PartitionQueryRequest used to create the
-        # partition tokens and the ExecuteSqlRequests that use the partition tokens.
-        # Partition tokens become invalid when the session used to create them
-        # is deleted, is idle for too long, begins a new transaction, or becomes too
-        # old.  When any of these happen, it is not possible to resume the query, and
-        # the whole operation must be restarted from the beginning.
+        # operation in parallel. Each of the returned partition tokens can be used by
+        # ExecuteStreamingSql to specify a subset of the query result to read. The same
+        # session and read-only transaction must be used by the PartitionQueryRequest
+        # used to create the partition tokens and the ExecuteSqlRequests that use the
+        # partition tokens. Partition tokens become invalid when the session used to
+        # create them is deleted, is idle for too long, begins a new transaction, or
+        # becomes too old. When any of these happen, it is not possible to resume the
+        # query, and the whole operation must be restarted from the beginning.
         # @param [String] session
         #   Required. The session used to create the partitions.
         # @param [Google::Apis::SpannerV1::PartitionQueryRequest] partition_query_request_object
@@ -2175,18 +2012,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a set of partition tokens that can be used to execute a read
-        # operation in parallel.  Each of the returned partition tokens can be used
-        # by StreamingRead to specify a subset of the read
-        # result to read.  The same session and read-only transaction must be used by
-        # the PartitionReadRequest used to create the partition tokens and the
-        # ReadRequests that use the partition tokens.  There are no ordering
-        # guarantees on rows returned among the returned partition tokens, or even
-        # within each individual StreamingRead call issued with a partition_token.
-        # Partition tokens become invalid when the session used to create them
-        # is deleted, is idle for too long, begins a new transaction, or becomes too
-        # old.  When any of these happen, it is not possible to resume the read, and
-        # the whole operation must be restarted from the beginning.
+        # Creates a set of partition tokens that can be used to execute a read operation
+        # in parallel. Each of the returned partition tokens can be used by
+        # StreamingRead to specify a subset of the read result to read. The same session
+        # and read-only transaction must be used by the PartitionReadRequest used to
+        # create the partition tokens and the ReadRequests that use the partition tokens.
+        # There are no ordering guarantees on rows returned among the returned
+        # partition tokens, or even within each individual StreamingRead call issued
+        # with a partition_token. Partition tokens become invalid when the session used
+        # to create them is deleted, is idle for too long, begins a new transaction, or
+        # becomes too old. When any of these happen, it is not possible to resume the
+        # read, and the whole operation must be restarted from the beginning.
         # @param [String] session
         #   Required. The session used to create the partitions.
         # @param [Google::Apis::SpannerV1::PartitionReadRequest] partition_read_request_object
@@ -2219,15 +2055,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Reads rows from the database using key lookups and scans, as a
-        # simple key/value style alternative to
-        # ExecuteSql.  This method cannot be used to
-        # return a result set larger than 10 MiB; if the read matches more
-        # data than that, the read fails with a `FAILED_PRECONDITION`
-        # error.
-        # Reads inside read-write transactions might return `ABORTED`. If
-        # this occurs, the application should restart the transaction from
-        # the beginning. See Transaction for more details.
+        # Reads rows from the database using key lookups and scans, as a simple key/
+        # value style alternative to ExecuteSql. This method cannot be used to return a
+        # result set larger than 10 MiB; if the read matches more data than that, the
+        # read fails with a `FAILED_PRECONDITION` error. Reads inside read-write
+        # transactions might return `ABORTED`. If this occurs, the application should
+        # restart the transaction from the beginning. See Transaction for more details.
         # Larger result sets can be yielded in streaming fashion by calling
         # StreamingRead instead.
         # @param [String] session
@@ -2262,13 +2095,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Rolls back a transaction, releasing any locks it holds. It is a good
-        # idea to call this for any transaction that includes one or more
-        # Read or ExecuteSql requests and
-        # ultimately decides not to commit.
-        # `Rollback` returns `OK` if it successfully aborts the transaction, the
-        # transaction was already aborted, or the transaction is not
-        # found. `Rollback` never returns `ABORTED`.
+        # Rolls back a transaction, releasing any locks it holds. It is a good idea to
+        # call this for any transaction that includes one or more Read or ExecuteSql
+        # requests and ultimately decides not to commit. `Rollback` returns `OK` if it
+        # successfully aborts the transaction, the transaction was already aborted, or
+        # the transaction is not found. `Rollback` never returns `ABORTED`.
         # @param [String] session
         #   Required. The session in which the transaction to roll back is running.
         # @param [Google::Apis::SpannerV1::RollbackRequest] rollback_request_object
@@ -2301,11 +2132,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Like Read, except returns the result set as a
-        # stream. Unlike Read, there is no limit on the
-        # size of the returned result set. However, no individual row in
-        # the result set can exceed 100 MiB, and no column value can exceed
-        # 10 MiB.
+        # Like Read, except returns the result set as a stream. Unlike Read, there is no
+        # limit on the size of the returned result set. However, no individual row in
+        # the result set can exceed 100 MiB, and no column value can exceed 10 MiB.
         # @param [String] session
         #   Required. The session in which the read should be performed.
         # @param [Google::Apis::SpannerV1::ReadRequest] read_request_object
@@ -2338,15 +2167,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Starts asynchronous cancellation on a long-running operation.  The server
-        # makes a best effort to cancel the operation, but success is not
-        # guaranteed.  If the server doesn't support this method, it returns
-        # `google.rpc.Code.UNIMPLEMENTED`.  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,
+        # Starts asynchronous cancellation on a long-running operation. The server makes
+        # a best effort to cancel the operation, but success is not guaranteed. If the
+        # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
+        # 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`.
         # @param [String] name
         #   The name of the operation resource to be cancelled.
@@ -2377,10 +2204,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a long-running operation. This method indicates that the client is
-        # no longer interested in the operation result. It does not cancel the
-        # operation. If the server doesn't support this method, it returns
-        # `google.rpc.Code.UNIMPLEMENTED`.
+        # Deletes a long-running operation. This method indicates that the client is no
+        # longer interested in the operation result. It does not cancel the operation.
+        # If the server doesn't support this method, it returns `google.rpc.Code.
+        # UNIMPLEMENTED`.
         # @param [String] name
         #   The name of the operation resource to be deleted.
         # @param [String] fields
@@ -2410,9 +2237,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
-        # method to poll the operation result at intervals as recommended by the API
-        # service.
+        # Gets the latest state of a long-running operation. Clients can use this method
+        # to poll the operation result at intervals as recommended by the API service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -2442,15 +2268,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists operations that match the specified filter in the request. If the
-        # server doesn't support this method, it returns `UNIMPLEMENTED`.
-        # NOTE: the `name` binding allows API services to override the binding
-        # to use different resource name schemes, such as `users/*/operations`. To
-        # override the binding, API services can add a binding such as
-        # `"/v1/`name=users/*`/operations"` to their service configuration.
-        # For backwards compatibility, the default name includes the operations
-        # collection id, however overriding users must ensure the name binding
-        # is the parent resource, without the operations collection id.
+        # Lists operations that match the specified filter in the request. If the server
+        # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
+        # binding allows API services to override the binding to use different resource
+        # name schemes, such as `users/*/operations`. To override the binding, API
+        # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
+        # service configuration. For backwards compatibility, the default name includes
+        # the operations collection id, however overriding users must ensure the name
+        # binding is the parent resource, without the operations collection id.
         # @param [String] name
         #   The name of the operation's parent resource.
         # @param [String] filter