Method: projects.zones.clusters.list

Lists all clusters owned by a project in either the specified zone or all zones.

HTTP request

GET https://container.googleapis.com/v1beta1/projects/{projectId}/zones/{zone}/clusters

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
projectId
(deprecated)

string

Required. Deprecated. The Google Developers Console project ID or project number. This field has been deprecated and replaced by the parent field.

zone
(deprecated)

string

Required. Deprecated. The name of the Google Compute Engine zone in which the cluster resides, or "-" for all zones. This field has been deprecated and replaced by the parent field.

Query parameters

Parameters
parent

string

The parent (project and location) where the clusters will be listed. Specified in the format projects/*/locations/*. Location "-" matches all zones and all regions.

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

  • container.clusters.list

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of ListClustersResponse.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.