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 returned Operation.metadata will be ClusterOperationMetadata.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
projectId	string Required. The ID of the Google Cloud Platform project that the cluster belongs to. Authorization requires the following IAM permission on the specified resource projectId: dataproc.clusters.create
region	string Required. The Dataproc region in which to handle the request.

Query parameters

Parameters
requestId	string Optional. A unique ID used to identify the request. If the server receives two CreateClusterRequests 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. It is recommended to always set this value to a UUID. The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40 characters.
actionOnFailedPrimaryWorkers	enum (FailureAction) Optional. Failure action when primary worker creation fails.

Request body

The request body contains an instance of Cluster.

Response body

If successful, the response body contains a newly created instance of Operation.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication 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.