The parent (project and location) where the clusters will be listed. Specified in the formatprojects/*/locations/*. Location "-" matches all zones and all regions.
Authorization requires the followingIAMpermission on the specified resourceparent:
container.clusters.list
Query parameters
Parameters
projectId (deprecated)
string
Deprecated. The Google Developers Consoleproject ID or project number. This field has been deprecated and replaced by the parent field.
zone (deprecated)
string
Deprecated. The name of the Google Compute Enginezonein which the cluster resides, or "-" for all zones. This field has been deprecated and replaced by the parent field.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-08 UTC."],[],[],null,["# Method: projects.locations.clusters.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all clusters owned by a project in either the specified zone or all zones.\n\n### HTTP request\n\n`GET https://container.googleapis.com/v1/{parent=projects/*/locations/*}/clusters`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [ListClustersResponse](/kubernetes-engine/docs/reference/rest/v1/ListClustersResponse).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
