Delete a Kubernetes cluster

Deletes a cluster from your account.

🚧

Deleting a cluster is a destructive action and can't be undone.

When a cluster is deleted, all supporting Kubernetes services are removed from your account along with all Linodes in your cluster's node pools. You must have read_write permission to the cluster to initiate deletion.

Some additional services associated with your cluster remain active on your account. These services include NodeBalancers and Block Storage volumes. To avoid further charges, delete these services manually through Cloud Manager, the Linode CLI, or the Linode API.

Account administrators can configure a resource lock with the Create a resource lock operation to prevent a cluster from being deleted. They can also remove the lock with the Delete a resource lock operation.

Permissions and scopes

To call this operation, you need the following:

  • Identity and access permissions. Your user needs these roles assigned. Learn more.

    • Roles: lkecluster_admin
  • OAuth scopes. Your user needs these scopes assigned. Learn more.

    • Scopes: lke:read_write

CLI

linode-cli lke cluster-delete 12345

Learn more

Path Params
string
enum
required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:
integer
required

ID of the Kubernetes cluster to look up.

Responses

Language
Credentials
LoadingLoading…
Response
Choose an example:
application/json