Required. The ID of the Google Cloud Platform project that 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.delete
Query parameters
Parameters
clusterUuid
string
Optional. Specifying the clusterUuid means the RPC should fail (with error NOT_FOUND) if cluster with specified UUID does not exist.
requestId
string
Optional. A unique ID used to identify the request. If the server receives two DeleteClusterRequests 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.
Optional. The graceful termination timeout for the deletion of the cluster. Indicate the time the request will wait to complete the running jobs on the cluster before its forceful deletion. Default value is 0 indicating that the user has not enabled the graceful termination. Value can be between 60 second and 6 Hours, in case the graceful termination is enabled. (There is no separate flag to check the enabling or disabling of graceful termination, it can be checked by the values in the field).
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of Operation.
[[["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 endpoint facilitates the deletion of a specified cluster within a designated Google Cloud Platform project and region.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires three path parameters: \u003ccode\u003eprojectId\u003c/code\u003e, \u003ccode\u003eregion\u003c/code\u003e, and \u003ccode\u003eclusterName\u003c/code\u003e, to identify the cluster that is to be deleted.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters, \u003ccode\u003eclusterUuid\u003c/code\u003e, \u003ccode\u003erequestId\u003c/code\u003e, and \u003ccode\u003egracefulTerminationTimeout\u003c/code\u003e, provide additional control over the deletion process, allowing specification of a unique cluster ID, request ID, and time allowed for jobs to finish before deletion, respectively.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and a successful response will return an \u003ccode\u003eOperation\u003c/code\u003e instance containing the information about the operation.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e and the IAM permission \u003ccode\u003edataproc.clusters.delete\u003c/code\u003e for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: projects.regions.clusters.delete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nDeletes a cluster in a project. The returned [Operation.metadata](/dataproc/docs/reference/rest/v1/projects.locations.operations#Operation.FIELDS.metadata) will be [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata).\n\n### HTTP request\n\n`DELETE https://dataproc.googleapis.com/v1/projects/{projectId}/regions/{region}/clusters/{clusterName}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\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)."]]
