Method: projects.regions.clusters.list

Lists all regions/{region}/clusters in a project alphabetically.

HTTP request

GET https://dataproc.googleapis.com/v1/projects/{projectId}/regions/{region}/clusters

The URL usesgRPC Transcoding syntax.

Path parameters

Parameters
projectId

string

Required. The ID of the Google Cloud Platform project that the cluster belongs to.

Authorization requires the followingIAM permission on the specified resourceprojectId:

  • dataproc.clusters.list
region

string

Required. The Dataproc region in which to handle the request.

Query parameters

Parameters
filter

string

Optional. A filter constraining the clusters to list. Filters are case-sensitive and have the following syntax:

field = value [AND [field = value]] ...

wherefield is one ofstatus.state,clusterName, orlabels.[KEY], and[KEY] is a label key.value can be* to match all values.status.state can be one of the following:ACTIVE,INACTIVE,CREATING,RUNNING,ERROR,DELETING,UPDATING,STOPPING, orSTOPPED.ACTIVE contains theCREATING,UPDATING, andRUNNING states.INACTIVE contains theDELETING,ERROR,STOPPING, andSTOPPED states.clusterName is the name of the cluster provided at creation time. Only the logicalAND operator is supported; space-separated items are treated as having an implicitAND operator.

Example filter:

status.state = ACTIVE AND clusterName = mycluster AND labels.env = staging AND labels.starred = *

pageSize

integer

Optional. The standard List page size.

pageToken

string

Optional. The standard List page token.

Request body

The request body must be empty.

Response body

The list of all clusters in a project.

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

JSON representation
{"clusters":[{object (Cluster)}],"nextPageToken":string}
Fields
clusters[]

object (Cluster)

Output only. The clusters in the project.

nextPageToken

string

Output only. This token is included in the response if there are more results to fetch. To fetch additional results, provide this value as thepageToken in a subsequentListClustersRequest.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see theAuthentication Overview.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-06-20 UTC.