Method: projects.instances.list

Lists all instances in the given project.

HTTP request

GET https://spanner.googleapis.com/v1/{parent=projects/*}/instances

The URL uses Google API HTTP annotation syntax.

Path parameters

Parameters
parent

string

Required. The name of the project for which a list of instances is requested. Values are of the form projects/<project>.

Authorization requires the following Google IAM permission on the specified resource parent:

  • spanner.instances.list

Query parameters

Parameters
pageSize

number

Number of instances to be returned in the response. If 0 or less, defaults to the server's maximum allowed page size.

pageToken

string

If non-empty, pageToken should contain a nextPageToken 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
  • displayName
  • 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".

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

The response for instances.list.

JSON representation
{
  "instances": [
    {
      object(Instance)
    }
  ],
  "nextPageToken": string,
}
Fields
instances[]

object(Instance)

The list of requested instances.

nextPageToken

string

nextPageToken can be sent in a subsequent instances.list call to fetch more of the matching instances.

Authorization

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/spanner.admin
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Auth Guide.

Try it!

Send feedback about...

Cloud Spanner Documentation