Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1362267343.4 KB
projects

Creates a cluster in a project. The returned Operation.metadata will be ClusterOperationMetadata (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata).

post/v1/projects/{projectId}/regions/{region}/clusters

Path parameters

projectIdstring required

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

regionstring required

Required. The region in which to handle the request.

Query parameters

actionOnFailedPrimaryWorkers'FAILURE_ACTION_UNSPECIFIED' | 'NO_ACTION' | 'DELETE'

Optional. Failure action when primary worker creation fails.

requestIdstring

Optional. A unique ID used to identify the request. If the server receives two CreateClusterRequest (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#google.cloud.dataproc.v1.CreateClusterRequest)s 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 (https://en.wikipedia.org/wiki/Universally_unique_identifier).The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40 characters.

Request body

labelsobject

Optional. The labels to associate with this cluster. Label keys must contain 1 to 63 characters, and must conform to RFC 1035 (https://www.ietf.org/rfc/rfc1035.txt). Label values may be empty, but, if present, must contain 1 to 63 characters, and must conform to RFC 1035 (https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be associated with a cluster.

clusterUuidstring

Output only. A cluster UUID (Unique Universal Identifier). The service generates this value when it creates the cluster.

clusterNamestring

Required. The cluster name, which must be unique within a project. The name must start with a lowercase letter, and can contain up to 51 lowercase letters, numbers, and hyphens. It cannot end with a hyphen. The name of a deleted cluster can be reused.

projectIdstring

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

Response

Successful response