Skip to main content
DELETE/vault/hyok/clusters/{cluster_id}

Delete Cluster

Deletes a cluster and its host memberships.

It is refused while a project is attached: detach the project first.

Deleting a cluster that is already gone returns 404.

Needs ORG_ADMIN.

Parameters
orgId *query

The organisation's id.

cluster_id *path

The cluster's id: hyokcluster_ and a UUID.

Responses
HTTPK9O CodeDescription
204The cluster was deleted.
404No such cluster.
409`K9O_HYOK_CLUSTER_IN_USE`: a project is attached.
500An internal error. Retry later.
cURL
curl -X DELETE 'https://<org>.api-<region>.k9o.io/@storefront/vault/hyok/clusters/<clusterId>' \
  -H 'Authorization: Bearer $K9O_TOKEN'

Showing example in cURL

More in HYOK Clusters & Hosts