Method: projects.locations.attachedClusters.delete

Deletes a specific AttachedCluster resource.

If successful, the response contains a newly created Operation resource that can be described to track the status of the operation.

HTTP request

DELETE https://{endpoint}/v1/{name=projects/*/locations/*/attachedClusters/*}

Where {endpoint} is one of the supported service endpoints.

The URLs use gRPC Transcoding syntax.

Path parameters



Required. The resource name the AttachedCluster to delete.

AttachedCluster names are formatted as projects/<project-id>/locations/<region>/attachedClusters/<cluster-id>.

See Resource Names for more details on Google Cloud Platform resource names.

Query parameters



If set, only validate the request, but do not actually delete the resource.



If set to true, and the AttachedCluster resource is not found, the request will succeed but no action will be taken on the server and a completed Operation will be returned.

Useful for idempotent deletion.



If set to true, the deletion of AttachedCluster resource will succeed even if errors occur during deleting in cluster resources. Using this parameter may result in orphaned resources in the cluster.



The current etag of the AttachedCluster.

Allows clients to perform deletions through optimistic concurrency control.

If the provided etag does not match the current etag of the cluster, the request will fail and an ABORTED error will be returned.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of Operation.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the name resource:

  • gkemulticloud.attachedClusters.delete

For more information, see the IAM documentation.