Method: projects.instances.list

Lists information about instances in a project.

HTTP request

GET https://bigtableadmin.googleapis.com/v2/{parent=projects/*}/instances

The URL uses Google API HTTP annotation syntax.

Path parameters

Parameters
parent

string

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

Query parameters

Parameters
pageToken

string

The value of nextPageToken returned by a previous call.

Request body

The request body must be empty.

Response body

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

Response message for BigtableInstanceAdmin.ListInstances.

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

object(Instance)

The list of requested instances.

failedLocations[]

string

Locations from which Instance information could not be retrieved, due to an outage or some other transient condition. Instances whose Clusters are all in one of the failed locations may be missing from instances, and Instances with at least one Cluster in a failed location may only have partial information returned.

nextPageToken

string

Set if not all instances could be returned in a single response. Pass this value to pageToken in another request to get the next page of results.

Authorization

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/bigtable.admin
  • https://www.googleapis.com/auth/bigtable.admin.cluster
  • https://www.googleapis.com/auth/bigtable.admin.instance
  • https://www.googleapis.com/auth/cloud-bigtable.admin
  • https://www.googleapis.com/auth/cloud-bigtable.admin.cluster
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-platform.read-only

For more information, see the Auth Guide.

Monitor your resources on the go

Get the Google Cloud Console app to help you manage your projects.

Send feedback about...

Cloud Bigtable Documentation