# Cloud Spanner API . projects . instances

## Instance Methods

Returns the backupOperations Resource.

Returns the backups Resource.

Returns the databaseOperations Resource.

Returns the databases Resource.

Returns the operations Resource.

Creates an instance and begins preparing it to begin serving. The

Deletes an instance.

Gets information about a particular instance.

Gets the access control policy for an instance resource. Returns an empty

Lists all instances in the given project.

Retrieves the next page of results.

Updates an instance, and begins allocating or releasing resources

Sets the access control policy on an instance resource. Replaces any

Returns permissions that the caller has on the specified instance resource.

### Method Details

`create(parent, body=None, x__xgafv=None)`

    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.

    Args:
      parent: string, Required. The name of the project in which to create the instance. Values
    are of the form `projects/<project>`. (required)
      body: object, The request body.
        The object takes the form of:

    { # The request for CreateInstance.
        "instanceId": "A String", # Required. The ID of the instance to create.  Valid identifiers are of the
            # form `a-z*[a-z0-9]` and must be between 2 and 64 characters in
            # length.
        "instance": { # An isolated set of Cloud Spanner resources on which databases can be hosted. # Required. The instance to create.  The name may be omitted, but if
            # specified must be `<parent>/instances/<instance_id>`.
          "name": "A String", # 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.
          "labels": { # Cloud Labels are a flexible and lightweight mechanism for organizing cloud
              # resources into groups that reflect a customer's organizational needs and
              # deployment strategies. Cloud Labels can be used to filter collections of
              # resources. They can be used to control how resource metrics are aggregated.
              # And they can be used as arguments to policy management rules (e.g. route,
              # firewall, load balancing, etc.).
              #
              #  * Label keys must be between 1 and 63 characters long and must conform to
              #    the following regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?`.
              #  * Label values must be between 0 and 63 characters long and must conform
              #    to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`.
              #  * No more than 64 labels can be associated with a given resource.
              #
              # See https://goo.gl/xmQnxf for more information on and examples of labels.
              #
              # If you plan to use labels in your own code, please note that additional
              # characters may be allowed in the future. And so you are advised to use an
              # internal label representation, such as JSON, which doesn't rely upon
              # specific characters being disallowed.  For example, representing labels
              # as the string:  name + "_" + value  would prove problematic if we were to
              # allow "_" in a future release.
            "a_key": "A String",
          },
          "endpointUris": [ # Deprecated. This field is not populated.
            "A String",
          ],
          "displayName": "A String", # Required. The descriptive name for this instance as it appears in UIs.
              # Must be unique per project and between 4 and 30 characters in length.
          "nodeCount": 42, # The number of nodes allocated to this instance. This
              # may be zero in API responses for instances that are not yet in state
              # `READY`.
              #
              # See [the
              # documentation](https://cloud.google.com/spanner/docs/instances#node_count)
              # for more information about nodes.
          "state": "A String", # Output only. The current instance state. For
              # CreateInstance, the state must be
              # either omitted or set to `CREATING`. For
              # UpdateInstance, the state must be
              # either omitted or set to `READY`.
          "config": "A String", # Required. The name of the instance's configuration. Values are of the form
              # `projects/<project>/instanceConfigs/<configuration>`. See
              # also InstanceConfig and
              # ListInstanceConfigs.
        },
      }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # This resource represents a long-running operation that is the result of a
          # network API call.
        "error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
            # different programming environments, including REST APIs and RPC APIs. It is
            # used by [gRPC](https://github.com/grpc). Each `Status` message contains
            # three pieces of data: error code, error message, and error details.
            #
            # You can find out more about this error model and how to work with it in the
            # [API Design Guide](https://cloud.google.com/apis/design/errors).
          "details": [ # A list of messages that carry the error details.  There is a common set of
              # message types for APIs to use.
            {
              "a_key": "", # Properties of the object. Contains field @type with type URL.
            },
          ],
          "message": "A String", # A developer-facing error message, which should be in English. Any
              # user-facing error message should be localized and sent in the
              # google.rpc.Status.details field, or localized by the client.
          "code": 42, # The status code, which should be an enum value of google.rpc.Code.
        },
        "metadata": { # Service-specific metadata associated with the operation.  It typically
            # contains progress information and common metadata such as create time.
            # Some services might not provide such metadata.  Any method that returns a
            # long-running operation should document the metadata type, if any.
          "a_key": "", # Properties of the object. Contains field @type with type URL.
        },
        "name": "A String", # The server-assigned name, which is only unique within the same service that
            # originally returns it. If you use the default HTTP mapping, the
            # `name` should be a resource name ending with `operations/{unique_id}`.
        "done": True or False, # If the value is `false`, it means the operation is still in progress.
            # If `true`, the operation is completed, and either `error` or `response` is
            # available.
        "response": { # The normal response of the operation in case of success.  If the original
            # method returns no data on success, such as `Delete`, the response is
            # `google.protobuf.Empty`.  If the original method is standard
            # `Get`/`Create`/`Update`, the response should be the resource.  For other
            # methods, the response should have the type `XxxResponse`, where `Xxx`
            # is the original method name.  For example, if the original method name
            # is `TakeSnapshot()`, the inferred response type is
            # `TakeSnapshotResponse`.
          "a_key": "", # Properties of the object. Contains field @type with type URL.
        },
      }

`delete(name, x__xgafv=None)`

    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.

    Args:
      name: string, Required. The name of the instance to be deleted. Values are of the form
    `projects/<project>/instances/<instance>` (required)
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # A generic empty message that you can re-use to avoid defining duplicated
          # empty messages in your APIs. A typical example is to use it as the request
          # or the response type of an API method. For instance:
          #
          #     service Foo {
          #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
          #     }
          #
          # The JSON representation for `Empty` is empty JSON object `{}`.
      }

`get(name, fieldMask=None, x__xgafv=None)`

    Gets information about a particular instance.

    Args:
      name: string, Required. The name of the requested instance. Values are of the form
    `projects/<project>/instances/<instance>`. (required)
      fieldMask: string, If field_mask is present, specifies the subset of Instance fields that
    should be returned.
    If absent, all Instance fields are returned.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # An isolated set of Cloud Spanner resources on which databases can be hosted.
        "name": "A String", # 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.
        "labels": { # Cloud Labels are a flexible and lightweight mechanism for organizing cloud
            # resources into groups that reflect a customer's organizational needs and
            # deployment strategies. Cloud Labels can be used to filter collections of
            # resources. They can be used to control how resource metrics are aggregated.
            # And they can be used as arguments to policy management rules (e.g. route,
            # firewall, load balancing, etc.).
            #
            #  * Label keys must be between 1 and 63 characters long and must conform to
            #    the following regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?`.
            #  * Label values must be between 0 and 63 characters long and must conform
            #    to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`.
            #  * No more than 64 labels can be associated with a given resource.
            #
            # See https://goo.gl/xmQnxf for more information on and examples of labels.
            #
            # If you plan to use labels in your own code, please note that additional
            # characters may be allowed in the future. And so you are advised to use an
            # internal label representation, such as JSON, which doesn't rely upon
            # specific characters being disallowed.  For example, representing labels
            # as the string:  name + "_" + value  would prove problematic if we were to
            # allow "_" in a future release.
          "a_key": "A String",
        },
        "endpointUris": [ # Deprecated. This field is not populated.
          "A String",
        ],
        "displayName": "A String", # Required. The descriptive name for this instance as it appears in UIs.
            # Must be unique per project and between 4 and 30 characters in length.
        "nodeCount": 42, # The number of nodes allocated to this instance. This
            # may be zero in API responses for instances that are not yet in state
            # `READY`.
            #
            # See [the
            # documentation](https://cloud.google.com/spanner/docs/instances#node_count)
            # for more information about nodes.
        "state": "A String", # Output only. The current instance state. For
            # CreateInstance, the state must be
            # either omitted or set to `CREATING`. For
            # UpdateInstance, the state must be
            # either omitted or set to `READY`.
        "config": "A String", # Required. The name of the instance's configuration. Values are of the form
            # `projects/<project>/instanceConfigs/<configuration>`. See
            # also InstanceConfig and
            # ListInstanceConfigs.
      }

`getIamPolicy(resource, body=None, x__xgafv=None)`

    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.

    Args:
      resource: string, 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. (required)
      body: object, The request body.
        The object takes the form of:

    { # Request message for `GetIamPolicy` method.
        "options": { # Encapsulates settings provided to GetIamPolicy. # OPTIONAL: A `GetPolicyOptions` object for specifying options to
            # `GetIamPolicy`.
          "requestedPolicyVersion": 42, # Optional. The policy format version to be returned.
              #
              # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
              # rejected.
              #
              # Requests for policies with any conditional bindings must specify version 3.
              # Policies without any conditional bindings may specify any valid value or
              # leave the field unset.
              #
              # To learn which resources support conditions in their IAM policies, see the
              # [IAM
              # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
        },
      }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # An Identity and Access Management (IAM) policy, which specifies access
          # controls for Google Cloud resources.
          #
          #
          # A `Policy` is a collection of `bindings`. A `binding` binds one or more
          # `members` to a single `role`. Members can be user accounts, service accounts,
          # Google groups, and domains (such as G Suite). A `role` is a named list of
          # permissions; each `role` can be an IAM predefined role or a user-created
          # custom role.
          #
          # For some types of Google Cloud resources, a `binding` can also specify a
          # `condition`, which is a logical expression that allows access to a resource
          # only if the expression evaluates to `true`. A condition can add constraints
          # based on attributes of the request, the resource, or both. To learn which
          # resources support conditions in their IAM policies, see the
          # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
          #
          # **JSON example:**
          #
          #     {
          #       "bindings": [
          #         {
          #           "role": "roles/resourcemanager.organizationAdmin",
          #           "members": [
          #             "user:mike@example.com",
          #             "group:admins@example.com",
          #             "domain:google.com",
          #             "serviceAccount:my-project-id@appspot.gserviceaccount.com"
          #           ]
          #         },
          #         {
          #           "role": "roles/resourcemanager.organizationViewer",
          #           "members": [
          #             "user:eve@example.com"
          #           ],
          #           "condition": {
          #             "title": "expirable access",
          #             "description": "Does not grant access after Sep 2020",
          #             "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')",
          #           }
          #         }
          #       ],
          #       "etag": "BwWWja0YfJA=",
          #       "version": 3
          #     }
          #
          # **YAML example:**
          #
          #     bindings:
          #     - members:
          #       - user:mike@example.com
          #       - group:admins@example.com
          #       - domain:google.com
          #       - serviceAccount:my-project-id@appspot.gserviceaccount.com
          #       role: roles/resourcemanager.organizationAdmin
          #     - members:
          #       - user:eve@example.com
          #       role: roles/resourcemanager.organizationViewer
          #       condition:
          #         title: expirable access
          #         description: Does not grant access after Sep 2020
          #         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
          #     - etag: BwWWja0YfJA=
          #     - version: 3
          #
          # For a description of IAM and its features, see the
          # [IAM documentation](https://cloud.google.com/iam/docs/).
        "bindings": [ # Associates a list of `members` to a `role`. Optionally, may specify a
            # `condition` that determines how and when the `bindings` are applied. Each
            # of the `bindings` must contain at least one member.
          { # Associates `members` with a `role`.
            "role": "A String", # Role that is assigned to `members`.
                # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
            "condition": { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
                #
                # If the condition evaluates to `true`, then this binding applies to the
                # current request.
                #
                # If the condition evaluates to `false`, then this binding does not apply to
                # the current request. However, a different role binding might grant the same
                # role to one or more of the members in this binding.
                #
                # To learn which resources support conditions in their IAM policies, see the
                # [IAM
                # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
                # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
                # are documented at https://github.com/google/cel-spec.
                #
                # Example (Comparison):
                #
                #     title: "Summary size limit"
                #     description: "Determines if a summary is less than 100 chars"
                #     expression: "document.summary.size() < 100"
                #
                # Example (Equality):
                #
                #     title: "Requestor is owner"
                #     description: "Determines if requestor is the document owner"
                #     expression: "document.owner == request.auth.claims.email"
                #
                # Example (Logic):
                #
                #     title: "Public documents"
                #     description: "Determine whether the document should be publicly visible"
                #     expression: "document.type != 'private' && document.type != 'internal'"
                #
                # Example (Data Manipulation):
                #
                #     title: "Notification string"
                #     description: "Create a notification string with a timestamp."
                #     expression: "'New message received at ' + string(document.create_time)"
                #
                # The exact variables and functions that may be referenced within an expression
                # are determined by the service that evaluates it. See the service
                # documentation for additional information.
              "location": "A String", # Optional. String indicating the location of the expression for error
                  # reporting, e.g. a file name and a position in the file.
              "expression": "A String", # Textual representation of an expression in Common Expression Language
                  # syntax.
              "description": "A String", # Optional. Description of the expression. This is a longer text which
                  # describes the expression, e.g. when hovered over it in a UI.
              "title": "A String", # Optional. Title for the expression, i.e. a short string describing
                  # its purpose. This can be used e.g. in UIs which allow to enter the
                  # expression.
            },
            "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
                # `members` can have the following values:
                #
                # * `allUsers`: A special identifier that represents anyone who is
                #    on the internet; with or without a Google account.
                #
                # * `allAuthenticatedUsers`: A special identifier that represents anyone
                #    who is authenticated with a Google account or a service account.
                #
                # * `user:{emailid}`: An email address that represents a specific Google
                #    account. For example, `alice@example.com` .
                #
                #
                # * `serviceAccount:{emailid}`: An email address that represents a service
                #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
                #
                # * `group:{emailid}`: An email address that represents a Google group.
                #    For example, `admins@example.com`.
                #
                # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
                #    identifier) representing a user that has been recently deleted. For
                #    example, `alice@example.com?uid=123456789012345678901`. If the user is
                #    recovered, this value reverts to `user:{emailid}` and the recovered user
                #    retains the role in the binding.
                #
                # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
                #    unique identifier) representing a service account that has been recently
                #    deleted. For example,
                #    `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
                #    If the service account is undeleted, this value reverts to
                #    `serviceAccount:{emailid}` and the undeleted service account retains the
                #    role in the binding.
                #
                # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
                #    identifier) representing a Google group that has been recently
                #    deleted. For example, `admins@example.com?uid=123456789012345678901`. If
                #    the group is recovered, this value reverts to `group:{emailid}` and the
                #    recovered group retains the role in the binding.
                #
                #
                # * `domain:{domain}`: The G Suite domain (primary) that represents all the
                #    users of that domain. For example, `google.com` or `example.com`.
                #
              "A String",
            ],
          },
        ],
        "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
            # prevent simultaneous updates of a policy from overwriting each other.
            # It is strongly suggested that systems make use of the `etag` in the
            # read-modify-write cycle to perform policy updates in order to avoid race
            # conditions: An `etag` is returned in the response to `getIamPolicy`, and
            # systems are expected to put that etag in the request to `setIamPolicy` to
            # ensure that their change will be applied to the same version of the policy.
            #
            # **Important:** If you use IAM Conditions, you must include the `etag` field
            # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
            # you to overwrite a version `3` policy with a version `1` policy, and all of
            # the conditions in the version `3` policy are lost.
        "version": 42, # Specifies the format of the policy.
            #
            # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
            # are rejected.
            #
            # Any operation that affects conditional role bindings must specify version
            # `3`. This requirement applies to the following operations:
            #
            # * Getting a policy that includes a conditional role binding
            # * Adding a conditional role binding to a policy
            # * Changing a conditional role binding in a policy
            # * Removing any role binding, with or without a condition, from a policy
            #   that includes conditions
            #
            # **Important:** If you use IAM Conditions, you must include the `etag` field
            # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
            # you to overwrite a version `3` policy with a version `1` policy, and all of
            # the conditions in the version `3` policy are lost.
            #
            # If a policy does not include any conditions, operations on that policy may
            # specify any valid version or leave the field unset.
            #
            # To learn which resources support conditions in their IAM policies, see the
            # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
      }

`list(parent, pageToken=None, filter=None, pageSize=None, x__xgafv=None)`

    Lists all instances in the given project.

    Args:
      parent: string, Required. The name of the project for which a list of instances is
    requested. Values are of the form `projects/<project>`. (required)
      pageToken: string, If non-empty, `page_token` should contain a
    next_page_token from a
    previous ListInstancesResponse.
      filter: string, 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".
      pageSize: integer, Number of instances to be returned in the response. If 0 or less, defaults
    to the server's maximum allowed page size.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # The response for ListInstances.
        "instances": [ # The list of requested instances.
          { # An isolated set of Cloud Spanner resources on which databases can be hosted.
            "name": "A String", # 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.
            "labels": { # Cloud Labels are a flexible and lightweight mechanism for organizing cloud
                # resources into groups that reflect a customer's organizational needs and
                # deployment strategies. Cloud Labels can be used to filter collections of
                # resources. They can be used to control how resource metrics are aggregated.
                # And they can be used as arguments to policy management rules (e.g. route,
                # firewall, load balancing, etc.).
                #
                #  * Label keys must be between 1 and 63 characters long and must conform to
                #    the following regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?`.
                #  * Label values must be between 0 and 63 characters long and must conform
                #    to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`.
                #  * No more than 64 labels can be associated with a given resource.
                #
                # See https://goo.gl/xmQnxf for more information on and examples of labels.
                #
                # If you plan to use labels in your own code, please note that additional
                # characters may be allowed in the future. And so you are advised to use an
                # internal label representation, such as JSON, which doesn't rely upon
                # specific characters being disallowed.  For example, representing labels
                # as the string:  name + "_" + value  would prove problematic if we were to
                # allow "_" in a future release.
              "a_key": "A String",
            },
            "endpointUris": [ # Deprecated. This field is not populated.
              "A String",
            ],
            "displayName": "A String", # Required. The descriptive name for this instance as it appears in UIs.
                # Must be unique per project and between 4 and 30 characters in length.
            "nodeCount": 42, # The number of nodes allocated to this instance. This
                # may be zero in API responses for instances that are not yet in state
                # `READY`.
                #
                # See [the
                # documentation](https://cloud.google.com/spanner/docs/instances#node_count)
                # for more information about nodes.
            "state": "A String", # Output only. The current instance state. For
                # CreateInstance, the state must be
                # either omitted or set to `CREATING`. For
                # UpdateInstance, the state must be
                # either omitted or set to `READY`.
            "config": "A String", # Required. The name of the instance's configuration. Values are of the form
                # `projects/<project>/instanceConfigs/<configuration>`. See
                # also InstanceConfig and
                # ListInstanceConfigs.
          },
        ],
        "nextPageToken": "A String", # `next_page_token` can be sent in a subsequent
            # ListInstances call to fetch more
            # of the matching instances.
      }

`list_next(previous_request, previous_response)`

    Retrieves the next page of results.

    Args:
      previous_request: The request for the previous page. (required)
      previous_response: The response from the request for the previous page. (required)

    Returns:
      A request object that you can call 'execute()' on to request the next
      page. Returns None if there are no more items in the collection.

`patch(name, body=None, x__xgafv=None)`

    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.

    Args:
      name: string, 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)
      body: object, The request body.
        The object takes the form of:

    { # The request for UpdateInstance.
        "instance": { # An isolated set of Cloud Spanner resources on which databases can be hosted. # Required. The instance to update, which must always include the instance
            # name.  Otherwise, only fields mentioned in field_mask need be included.
          "name": "A String", # 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.
          "labels": { # Cloud Labels are a flexible and lightweight mechanism for organizing cloud
              # resources into groups that reflect a customer's organizational needs and
              # deployment strategies. Cloud Labels can be used to filter collections of
              # resources. They can be used to control how resource metrics are aggregated.
              # And they can be used as arguments to policy management rules (e.g. route,
              # firewall, load balancing, etc.).
              #
              #  * Label keys must be between 1 and 63 characters long and must conform to
              #    the following regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?`.
              #  * Label values must be between 0 and 63 characters long and must conform
              #    to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`.
              #  * No more than 64 labels can be associated with a given resource.
              #
              # See https://goo.gl/xmQnxf for more information on and examples of labels.
              #
              # If you plan to use labels in your own code, please note that additional
              # characters may be allowed in the future. And so you are advised to use an
              # internal label representation, such as JSON, which doesn't rely upon
              # specific characters being disallowed.  For example, representing labels
              # as the string:  name + "_" + value  would prove problematic if we were to
              # allow "_" in a future release.
            "a_key": "A String",
          },
          "endpointUris": [ # Deprecated. This field is not populated.
            "A String",
          ],
          "displayName": "A String", # Required. The descriptive name for this instance as it appears in UIs.
              # Must be unique per project and between 4 and 30 characters in length.
          "nodeCount": 42, # The number of nodes allocated to this instance. This
              # may be zero in API responses for instances that are not yet in state
              # `READY`.
              #
              # See [the
              # documentation](https://cloud.google.com/spanner/docs/instances#node_count)
              # for more information about nodes.
          "state": "A String", # Output only. The current instance state. For
              # CreateInstance, the state must be
              # either omitted or set to `CREATING`. For
              # UpdateInstance, the state must be
              # either omitted or set to `READY`.
          "config": "A String", # Required. The name of the instance's configuration. Values are of the form
              # `projects/<project>/instanceConfigs/<configuration>`. See
              # also InstanceConfig and
              # ListInstanceConfigs.
        },
        "fieldMask": "A String", # Required. A mask specifying which fields in Instance should be updated.
            # The field mask must always be specified; this prevents any future fields in
            # Instance from being erased accidentally by clients that do not know
            # about them.
      }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # This resource represents a long-running operation that is the result of a
          # network API call.
        "error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
            # different programming environments, including REST APIs and RPC APIs. It is
            # used by [gRPC](https://github.com/grpc). Each `Status` message contains
            # three pieces of data: error code, error message, and error details.
            #
            # You can find out more about this error model and how to work with it in the
            # [API Design Guide](https://cloud.google.com/apis/design/errors).
          "details": [ # A list of messages that carry the error details.  There is a common set of
              # message types for APIs to use.
            {
              "a_key": "", # Properties of the object. Contains field @type with type URL.
            },
          ],
          "message": "A String", # A developer-facing error message, which should be in English. Any
              # user-facing error message should be localized and sent in the
              # google.rpc.Status.details field, or localized by the client.
          "code": 42, # The status code, which should be an enum value of google.rpc.Code.
        },
        "metadata": { # Service-specific metadata associated with the operation.  It typically
            # contains progress information and common metadata such as create time.
            # Some services might not provide such metadata.  Any method that returns a
            # long-running operation should document the metadata type, if any.
          "a_key": "", # Properties of the object. Contains field @type with type URL.
        },
        "name": "A String", # The server-assigned name, which is only unique within the same service that
            # originally returns it. If you use the default HTTP mapping, the
            # `name` should be a resource name ending with `operations/{unique_id}`.
        "done": True or False, # If the value is `false`, it means the operation is still in progress.
            # If `true`, the operation is completed, and either `error` or `response` is
            # available.
        "response": { # The normal response of the operation in case of success.  If the original
            # method returns no data on success, such as `Delete`, the response is
            # `google.protobuf.Empty`.  If the original method is standard
            # `Get`/`Create`/`Update`, the response should be the resource.  For other
            # methods, the response should have the type `XxxResponse`, where `Xxx`
            # is the original method name.  For example, if the original method name
            # is `TakeSnapshot()`, the inferred response type is
            # `TakeSnapshotResponse`.
          "a_key": "", # Properties of the object. Contains field @type with type URL.
        },
      }

`setIamPolicy(resource, body=None, x__xgafv=None)`

    Sets the access control policy on an instance resource. Replaces any
    existing policy.

    Authorization requires `spanner.instances.setIamPolicy` on
    resource.

    Args:
      resource: string, 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. (required)
      body: object, The request body.
        The object takes the form of:

    { # Request message for `SetIamPolicy` method.
        "policy": { # An Identity and Access Management (IAM) policy, which specifies access # REQUIRED: The complete policy to be applied to the `resource`. The size of
            # the policy is limited to a few 10s of KB. An empty policy is a
            # valid policy but certain Cloud Platform services (such as Projects)
            # might reject them.
            # controls for Google Cloud resources.
            #
            #
            # A `Policy` is a collection of `bindings`. A `binding` binds one or more
            # `members` to a single `role`. Members can be user accounts, service accounts,
            # Google groups, and domains (such as G Suite). A `role` is a named list of
            # permissions; each `role` can be an IAM predefined role or a user-created
            # custom role.
            #
            # For some types of Google Cloud resources, a `binding` can also specify a
            # `condition`, which is a logical expression that allows access to a resource
            # only if the expression evaluates to `true`. A condition can add constraints
            # based on attributes of the request, the resource, or both. To learn which
            # resources support conditions in their IAM policies, see the
            # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
            #
            # **JSON example:**
            #
            #     {
            #       "bindings": [
            #         {
            #           "role": "roles/resourcemanager.organizationAdmin",
            #           "members": [
            #             "user:mike@example.com",
            #             "group:admins@example.com",
            #             "domain:google.com",
            #             "serviceAccount:my-project-id@appspot.gserviceaccount.com"
            #           ]
            #         },
            #         {
            #           "role": "roles/resourcemanager.organizationViewer",
            #           "members": [
            #             "user:eve@example.com"
            #           ],
            #           "condition": {
            #             "title": "expirable access",
            #             "description": "Does not grant access after Sep 2020",
            #             "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')",
            #           }
            #         }
            #       ],
            #       "etag": "BwWWja0YfJA=",
            #       "version": 3
            #     }
            #
            # **YAML example:**
            #
            #     bindings:
            #     - members:
            #       - user:mike@example.com
            #       - group:admins@example.com
            #       - domain:google.com
            #       - serviceAccount:my-project-id@appspot.gserviceaccount.com
            #       role: roles/resourcemanager.organizationAdmin
            #     - members:
            #       - user:eve@example.com
            #       role: roles/resourcemanager.organizationViewer
            #       condition:
            #         title: expirable access
            #         description: Does not grant access after Sep 2020
            #         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
            #     - etag: BwWWja0YfJA=
            #     - version: 3
            #
            # For a description of IAM and its features, see the
            # [IAM documentation](https://cloud.google.com/iam/docs/).
          "bindings": [ # Associates a list of `members` to a `role`. Optionally, may specify a
              # `condition` that determines how and when the `bindings` are applied. Each
              # of the `bindings` must contain at least one member.
            { # Associates `members` with a `role`.
              "role": "A String", # Role that is assigned to `members`.
                  # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
              "condition": { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
                  #
                  # If the condition evaluates to `true`, then this binding applies to the
                  # current request.
                  #
                  # If the condition evaluates to `false`, then this binding does not apply to
                  # the current request. However, a different role binding might grant the same
                  # role to one or more of the members in this binding.
                  #
                  # To learn which resources support conditions in their IAM policies, see the
                  # [IAM
                  # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
                  # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
                  # are documented at https://github.com/google/cel-spec.
                  #
                  # Example (Comparison):
                  #
                  #     title: "Summary size limit"
                  #     description: "Determines if a summary is less than 100 chars"
                  #     expression: "document.summary.size() < 100"
                  #
                  # Example (Equality):
                  #
                  #     title: "Requestor is owner"
                  #     description: "Determines if requestor is the document owner"
                  #     expression: "document.owner == request.auth.claims.email"
                  #
                  # Example (Logic):
                  #
                  #     title: "Public documents"
                  #     description: "Determine whether the document should be publicly visible"
                  #     expression: "document.type != 'private' && document.type != 'internal'"
                  #
                  # Example (Data Manipulation):
                  #
                  #     title: "Notification string"
                  #     description: "Create a notification string with a timestamp."
                  #     expression: "'New message received at ' + string(document.create_time)"
                  #
                  # The exact variables and functions that may be referenced within an expression
                  # are determined by the service that evaluates it. See the service
                  # documentation for additional information.
                "location": "A String", # Optional. String indicating the location of the expression for error
                    # reporting, e.g. a file name and a position in the file.
                "expression": "A String", # Textual representation of an expression in Common Expression Language
                    # syntax.
                "description": "A String", # Optional. Description of the expression. This is a longer text which
                    # describes the expression, e.g. when hovered over it in a UI.
                "title": "A String", # Optional. Title for the expression, i.e. a short string describing
                    # its purpose. This can be used e.g. in UIs which allow to enter the
                    # expression.
              },
              "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
                  # `members` can have the following values:
                  #
                  # * `allUsers`: A special identifier that represents anyone who is
                  #    on the internet; with or without a Google account.
                  #
                  # * `allAuthenticatedUsers`: A special identifier that represents anyone
                  #    who is authenticated with a Google account or a service account.
                  #
                  # * `user:{emailid}`: An email address that represents a specific Google
                  #    account. For example, `alice@example.com` .
                  #
                  #
                  # * `serviceAccount:{emailid}`: An email address that represents a service
                  #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
                  #
                  # * `group:{emailid}`: An email address that represents a Google group.
                  #    For example, `admins@example.com`.
                  #
                  # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
                  #    identifier) representing a user that has been recently deleted. For
                  #    example, `alice@example.com?uid=123456789012345678901`. If the user is
                  #    recovered, this value reverts to `user:{emailid}` and the recovered user
                  #    retains the role in the binding.
                  #
                  # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
                  #    unique identifier) representing a service account that has been recently
                  #    deleted. For example,
                  #    `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
                  #    If the service account is undeleted, this value reverts to
                  #    `serviceAccount:{emailid}` and the undeleted service account retains the
                  #    role in the binding.
                  #
                  # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
                  #    identifier) representing a Google group that has been recently
                  #    deleted. For example, `admins@example.com?uid=123456789012345678901`. If
                  #    the group is recovered, this value reverts to `group:{emailid}` and the
                  #    recovered group retains the role in the binding.
                  #
                  #
                  # * `domain:{domain}`: The G Suite domain (primary) that represents all the
                  #    users of that domain. For example, `google.com` or `example.com`.
                  #
                "A String",
              ],
            },
          ],
          "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
              # prevent simultaneous updates of a policy from overwriting each other.
              # It is strongly suggested that systems make use of the `etag` in the
              # read-modify-write cycle to perform policy updates in order to avoid race
              # conditions: An `etag` is returned in the response to `getIamPolicy`, and
              # systems are expected to put that etag in the request to `setIamPolicy` to
              # ensure that their change will be applied to the same version of the policy.
              #
              # **Important:** If you use IAM Conditions, you must include the `etag` field
              # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
              # you to overwrite a version `3` policy with a version `1` policy, and all of
              # the conditions in the version `3` policy are lost.
          "version": 42, # Specifies the format of the policy.
              #
              # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
              # are rejected.
              #
              # Any operation that affects conditional role bindings must specify version
              # `3`. This requirement applies to the following operations:
              #
              # * Getting a policy that includes a conditional role binding
              # * Adding a conditional role binding to a policy
              # * Changing a conditional role binding in a policy
              # * Removing any role binding, with or without a condition, from a policy
              #   that includes conditions
              #
              # **Important:** If you use IAM Conditions, you must include the `etag` field
              # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
              # you to overwrite a version `3` policy with a version `1` policy, and all of
              # the conditions in the version `3` policy are lost.
              #
              # If a policy does not include any conditions, operations on that policy may
              # specify any valid version or leave the field unset.
              #
              # To learn which resources support conditions in their IAM policies, see the
              # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
        },
      }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # An Identity and Access Management (IAM) policy, which specifies access
          # controls for Google Cloud resources.
          #
          #
          # A `Policy` is a collection of `bindings`. A `binding` binds one or more
          # `members` to a single `role`. Members can be user accounts, service accounts,
          # Google groups, and domains (such as G Suite). A `role` is a named list of
          # permissions; each `role` can be an IAM predefined role or a user-created
          # custom role.
          #
          # For some types of Google Cloud resources, a `binding` can also specify a
          # `condition`, which is a logical expression that allows access to a resource
          # only if the expression evaluates to `true`. A condition can add constraints
          # based on attributes of the request, the resource, or both. To learn which
          # resources support conditions in their IAM policies, see the
          # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
          #
          # **JSON example:**
          #
          #     {
          #       "bindings": [
          #         {
          #           "role": "roles/resourcemanager.organizationAdmin",
          #           "members": [
          #             "user:mike@example.com",
          #             "group:admins@example.com",
          #             "domain:google.com",
          #             "serviceAccount:my-project-id@appspot.gserviceaccount.com"
          #           ]
          #         },
          #         {
          #           "role": "roles/resourcemanager.organizationViewer",
          #           "members": [
          #             "user:eve@example.com"
          #           ],
          #           "condition": {
          #             "title": "expirable access",
          #             "description": "Does not grant access after Sep 2020",
          #             "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')",
          #           }
          #         }
          #       ],
          #       "etag": "BwWWja0YfJA=",
          #       "version": 3
          #     }
          #
          # **YAML example:**
          #
          #     bindings:
          #     - members:
          #       - user:mike@example.com
          #       - group:admins@example.com
          #       - domain:google.com
          #       - serviceAccount:my-project-id@appspot.gserviceaccount.com
          #       role: roles/resourcemanager.organizationAdmin
          #     - members:
          #       - user:eve@example.com
          #       role: roles/resourcemanager.organizationViewer
          #       condition:
          #         title: expirable access
          #         description: Does not grant access after Sep 2020
          #         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
          #     - etag: BwWWja0YfJA=
          #     - version: 3
          #
          # For a description of IAM and its features, see the
          # [IAM documentation](https://cloud.google.com/iam/docs/).
        "bindings": [ # Associates a list of `members` to a `role`. Optionally, may specify a
            # `condition` that determines how and when the `bindings` are applied. Each
            # of the `bindings` must contain at least one member.
          { # Associates `members` with a `role`.
            "role": "A String", # Role that is assigned to `members`.
                # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
            "condition": { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
                #
                # If the condition evaluates to `true`, then this binding applies to the
                # current request.
                #
                # If the condition evaluates to `false`, then this binding does not apply to
                # the current request. However, a different role binding might grant the same
                # role to one or more of the members in this binding.
                #
                # To learn which resources support conditions in their IAM policies, see the
                # [IAM
                # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
                # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
                # are documented at https://github.com/google/cel-spec.
                #
                # Example (Comparison):
                #
                #     title: "Summary size limit"
                #     description: "Determines if a summary is less than 100 chars"
                #     expression: "document.summary.size() < 100"
                #
                # Example (Equality):
                #
                #     title: "Requestor is owner"
                #     description: "Determines if requestor is the document owner"
                #     expression: "document.owner == request.auth.claims.email"
                #
                # Example (Logic):
                #
                #     title: "Public documents"
                #     description: "Determine whether the document should be publicly visible"
                #     expression: "document.type != 'private' && document.type != 'internal'"
                #
                # Example (Data Manipulation):
                #
                #     title: "Notification string"
                #     description: "Create a notification string with a timestamp."
                #     expression: "'New message received at ' + string(document.create_time)"
                #
                # The exact variables and functions that may be referenced within an expression
                # are determined by the service that evaluates it. See the service
                # documentation for additional information.
              "location": "A String", # Optional. String indicating the location of the expression for error
                  # reporting, e.g. a file name and a position in the file.
              "expression": "A String", # Textual representation of an expression in Common Expression Language
                  # syntax.
              "description": "A String", # Optional. Description of the expression. This is a longer text which
                  # describes the expression, e.g. when hovered over it in a UI.
              "title": "A String", # Optional. Title for the expression, i.e. a short string describing
                  # its purpose. This can be used e.g. in UIs which allow to enter the
                  # expression.
            },
            "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
                # `members` can have the following values:
                #
                # * `allUsers`: A special identifier that represents anyone who is
                #    on the internet; with or without a Google account.
                #
                # * `allAuthenticatedUsers`: A special identifier that represents anyone
                #    who is authenticated with a Google account or a service account.
                #
                # * `user:{emailid}`: An email address that represents a specific Google
                #    account. For example, `alice@example.com` .
                #
                #
                # * `serviceAccount:{emailid}`: An email address that represents a service
                #    account. For example, `my-other-app@appspot.gserviceaccount.com`.
                #
                # * `group:{emailid}`: An email address that represents a Google group.
                #    For example, `admins@example.com`.
                #
                # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
                #    identifier) representing a user that has been recently deleted. For
                #    example, `alice@example.com?uid=123456789012345678901`. If the user is
                #    recovered, this value reverts to `user:{emailid}` and the recovered user
                #    retains the role in the binding.
                #
                # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
                #    unique identifier) representing a service account that has been recently
                #    deleted. For example,
                #    `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
                #    If the service account is undeleted, this value reverts to
                #    `serviceAccount:{emailid}` and the undeleted service account retains the
                #    role in the binding.
                #
                # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
                #    identifier) representing a Google group that has been recently
                #    deleted. For example, `admins@example.com?uid=123456789012345678901`. If
                #    the group is recovered, this value reverts to `group:{emailid}` and the
                #    recovered group retains the role in the binding.
                #
                #
                # * `domain:{domain}`: The G Suite domain (primary) that represents all the
                #    users of that domain. For example, `google.com` or `example.com`.
                #
              "A String",
            ],
          },
        ],
        "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
            # prevent simultaneous updates of a policy from overwriting each other.
            # It is strongly suggested that systems make use of the `etag` in the
            # read-modify-write cycle to perform policy updates in order to avoid race
            # conditions: An `etag` is returned in the response to `getIamPolicy`, and
            # systems are expected to put that etag in the request to `setIamPolicy` to
            # ensure that their change will be applied to the same version of the policy.
            #
            # **Important:** If you use IAM Conditions, you must include the `etag` field
            # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
            # you to overwrite a version `3` policy with a version `1` policy, and all of
            # the conditions in the version `3` policy are lost.
        "version": 42, # Specifies the format of the policy.
            #
            # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
            # are rejected.
            #
            # Any operation that affects conditional role bindings must specify version
            # `3`. This requirement applies to the following operations:
            #
            # * Getting a policy that includes a conditional role binding
            # * Adding a conditional role binding to a policy
            # * Changing a conditional role binding in a policy
            # * Removing any role binding, with or without a condition, from a policy
            #   that includes conditions
            #
            # **Important:** If you use IAM Conditions, you must include the `etag` field
            # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
            # you to overwrite a version `3` policy with a version `1` policy, and all of
            # the conditions in the version `3` policy are lost.
            #
            # If a policy does not include any conditions, operations on that policy may
            # specify any valid version or leave the field unset.
            #
            # To learn which resources support conditions in their IAM policies, see the
            # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
      }

`testIamPermissions(resource, body=None, x__xgafv=None)`

    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.

    Args:
      resource: string, 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. (required)
      body: object, The request body.
        The object takes the form of:

    { # Request message for `TestIamPermissions` method.
        "permissions": [ # REQUIRED: The set of permissions to check for 'resource'.
            # Permissions with wildcards (such as '*', 'spanner.*', 'spanner.instances.*') are not allowed.
          "A String",
        ],
      }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Response message for `TestIamPermissions` method.
        "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
            # allowed.
          "A String",
        ],
      }