Method: projects.regions.clusters.start

Starts a cluster in a project.

HTTP request

POST https://dataproc.googleapis.com/v1/projects/{projectId}/regions/{region}/clusters/{clusterName}:start

The URL usesgRPC Transcoding syntax.

Path parameters

Parameters
projectId

string

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

region

string

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

clusterName

string

Required. The cluster name.

Authorization requires the followingIAM permission on the specified resourceclusterName:

  • dataproc.clusters.start

Request body

The request body contains data with the following structure:

JSON representation
{"clusterUuid":string,"requestId":string}
Fields
clusterUuid

string

Optional. Specifying theclusterUuid means the RPC will fail (with error NOT_FOUND) if a cluster with the specified UUID does not exist.

requestId

string

Optional. A unique ID used to identify the request. If the server receives twoStartClusterRequests with the same id, then the second request will be ignored and the firstgoogle.longrunning.Operation created and stored in the backend is returned.

Recommendation: Set this value to aUUID.

The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40 characters.

Response body

If successful, the response body contains an instance ofOperation.

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.