Method: projects.regions.clusters.create
- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- FailureAction
- Try it!
Creates a cluster in a project. The returnedOperation.metadata will beClusterOperationMetadata.
HTTP request
POST https://dataproc.googleapis.com/v1/projects/{projectId}/regions/{region}/clusters
The URL usesgRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
projectId |
Required. The ID of the Google Cloud Platform project that the cluster belongs to. Authorization requires the followingIAM permission on the specified resource
|
region |
Required. The Dataproc region in which to handle the request. |
Query parameters
| Parameters | |
|---|---|
requestId |
Optional. A unique ID used to identify the request. If the server receives twoCreateClusterRequests with the same id, then the second request will be ignored and the first It is recommended to always 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. |
actionOnFailedPrimaryWorkers |
Optional. Failure action when primary worker creation fails. |
Request body
The request body contains an instance ofCluster.
Response body
If successful, the response body contains a newly created instance ofOperation.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see theAuthentication Overview.
FailureAction
Actions in response to failure of a resource associated with a cluster.
| Enums | |
|---|---|
FAILURE_ACTION_UNSPECIFIED | When FailureAction is unspecified, failure action defaults to NO_ACTION. |
NO_ACTION | Take no action on failure to create a cluster resource. NO_ACTION is the default. |
DELETE | Delete the failed cluster resource. |
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.