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 following IAM permission on the specified resource clusterName:
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 the clusterUuid 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 two StartClusterRequests with the same id, then the second request will be ignored and the first google.longrunning.Operation created and stored in the backend is returned.
[[["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-06-20 UTC."],[[["\u003cp\u003eThis API endpoint is used to start a cluster within a specified Google Cloud project and region.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the \u003ccode\u003eprojectId\u003c/code\u003e, \u003ccode\u003eregion\u003c/code\u003e, and \u003ccode\u003eclusterName\u003c/code\u003e as path parameters to identify the target cluster.\u003c/p\u003e\n"],["\u003cp\u003eThe request body can optionally include a \u003ccode\u003eclusterUuid\u003c/code\u003e to ensure the specified cluster exists and a \u003ccode\u003erequestId\u003c/code\u003e for idempotent request handling.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests will return an \u003ccode\u003eOperation\u003c/code\u003e instance, and authorization requires the \u003ccode\u003edataproc.clusters.start\u003c/code\u003e IAM permission along with the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request method is a \u003ccode\u003ePOST\u003c/code\u003e request to the provided URL which uses gRPC Transcoding syntax.\u003c/p\u003e\n"]]],[],null,["# Method: projects.regions.clusters.start\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nStarts a cluster in a project.\n\n### HTTP request\n\n`POST https://dataproc.googleapis.com/v1/projects/{projectId}/regions/{region}/clusters/{clusterName}:start`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/dataproc/docs/reference/rest/v1/projects.locations.operations#Operation).\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)."]]
