eks.clusters.deleteDelete a cluster, its control plane, node groups and nodes
409 while deletion protection is on. By default a final etcd snapshot is taken and the cluster can be restored for 7 days (`deleted-clusters restore`): its settings, key material and PersistentVolumes’ volumes are kept, detached and free. `permanent=true` keeps nothing.
Request syntax
DELETE /eks/api/clusters/{cluster}Path parameters
clusterRequiredstring
Constraints: /^(ewk-[0-9a-f]{12}|[a-z]([a-z0-9-]{0,38}[a-z0-9])?)$/
Query parameters
permanentOptionalenum
true: nothing is kept (no final snapshot, volumes deleted), the cluster cannot be restored. Default: restorable for 7 days
One of:
true,false
Response
200 with { id, status: "deleting", permanent }; the machines, endpoint and firewall are removed in the background, and the cluster then appears in `deleted-clusters list` unless permanent. Deleting a cluster already being deleted answers 200 with { id, status: "deleting" } and changes nothing. 409 while deletion protection is on. 404 when no cluster has that id or name, 403 without the permission on it.
A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.
Errors
- 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
- 401No credentials, or an access key that is unknown, revoked or expired.
- 403The caller's policies do not allow eks:DeleteCluster on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
- 404The resource does not exist in your organization.
Examples
The required parameters only, with example values. Replace id and the other placeholders with your own.
dcloud eks clusters delete clustercurl -X DELETE "https://console.platform-development.deutschecloud.app/eks/api/clusters/cluster" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY"Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_eks_clusters_delete.