Lists information about clusters in an instance.
HTTP request
GET https://bigtableadmin.googleapis.com/v2/{parent=projects/*/instances/*}/clusters
The URL uses gRPC Transcoding syntax.
Path parameters
parent
string
Required. The unique name of the instance for which a list of clusters is requested. Values are of the form projects/{project}/instances/{instance}
. Use {instance} = '-'
to list Clusters for all Instances in a project, e.g., projects/myproject/instances/-
.
Authorization requires the following IAM
permission on the specified resource parent
:
-
bigtable.clusters.list
Query parameters
| Parameters | |
|---|---|
pageToken
|
DEPRECATED: This field is unused and ignored. |
Request body
The request body must be empty.
Response body
Response message for BigtableInstanceAdmin.ListClusters.
If successful, the response body contains data with the following structure:
| JSON representation |
|---|
{
"clusters"
:
[
{
object (
|
| Fields | |
|---|---|
clusters[]
|
The list of requested clusters. |
failedLocations[]
|
Locations from which Cluster information could not be retrieved, due to an outage or some other transient condition. Clusters from these locations may be missing from |
nextPageToken
|
DEPRECATED: This field is unused and ignored. |
Authorization scopes
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 Authentication Overview .

