Stay organized with collections
Save and categorize content based on your preferences.
Lists all clusters owned by a project in either the specified zone or
all zones.
Arguments
Parameters
projectId
string
Deprecated. (Although deprecated, this is a required parameter.) The Google Developers Console project ID or project number. This field has been deprecated and replaced by the parent field.
zone
string
Deprecated. (Although deprecated, this is a required parameter.) 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.
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.
Raised exceptions
Exceptions
ConnectionError
In case of a network problem (such as DNS failure or refused connection).
HttpError
If the response status is >= 400 (excluding 429 and 503).
TimeoutError
If a long-running operation takes longer to finish than the specified timeout limit.
TypeError
If an operation or function receives an argument of the wrong type.
ValueError
If an operation or function receives an argument of the right type but an inappropriate value. For example, a negative timeout.
[[["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-08-28 UTC."],[],[],null,["# Method: googleapis.container.v1.projects.zones.clusters.list\n\nLists all clusters owned by a project in either the specified zone or\nall zones.\n\nArguments\n---------\n\nRaised exceptions\n-----------------\n\nResponse\n--------\n\nIf successful, the response contains an instance of [`ListClustersResponse`](/workflows/docs/reference/googleapis/container/v1/Overview#ListClustersResponse).\n\nSubworkflow snippet\n-------------------\n\nSome fields might be optional or required.\nTo identify required fields, refer to the [API documentation](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.zones.clusters/list). \n\n### YAML\n\n```yaml\n- list:\n call: googleapis.container.v1.projects.zones.clusters.list\n args:\n projectId: ...\n zone: ...\n parent: ...\n result: listResult\n```\n\n### JSON\n\n```json\n[\n {\n \"list\": {\n \"call\": \"googleapis.container.v1.projects.zones.clusters.list\",\n \"args\": {\n \"projectId\": \"...\",\n \"zone\": \"...\",\n \"parent\": \"...\"\n },\n \"result\": \"listResult\"\n }\n }\n]\n```"]]