Deleting a Kubernetes cluster

Written by

Updated at November 11, 2025

Alert

When deleting a Managed Service for Kubernetes cluster, Compute Cloud disks attached to PersistentVolumes are not deleted automatically.

To access a Kubernetes cluster, use its name or unique ID. You can get them by using the following command:

yc managed-kubernetes cluster list

Result:

+----------------------+----------+---------------------+---------+---------+-------------------------+-----------------------+
|          ID          |   NAME   |     CREATED AT      | HEALTH  | STATUS  |    EXTERNAL ENDPOINT    |   INTERNAL ENDPOINT   |
+----------------------+----------+---------------------+---------+---------+-------------------------+-----------------------+
| cati493bu7ia******** | k8s-demo | 2019-11-20 11:26:36 | HEALTHY | RUNNING | https://84.201.174.147/ | https://192.168.0.27/ |
+----------------------+----------+---------------------+---------+---------+-------------------------+-----------------------+

Management console

CLI

Terraform

API

Open Managed Service for Kubernetes in the folder where you want to delete a Kubernetes cluster.
Click in the row of the Kubernetes cluster you need to delete.
In the menu that opens, click Delete.
In the window that opens, click Delete.

If you do not have the Yandex Cloud CLI installed yet, install and initialize it.

Delete the Kubernetes cluster:

yc managed-kubernetes cluster delete test-k8s-cluster

Result:

done

Make sure the Kubernetes cluster was deleted:

yc managed-kubernetes cluster list

Result:

+----+------+------------+--------+--------+-------------------+-------------------+
| ID | NAME | CREATED AT | HEALTH | STATUS | EXTERNAL ENDPOINT | INTERNAL ENDPOINT |
+----+------+------------+--------+--------+-------------------+-------------------+
+----+------+------------+--------+--------+-------------------+-------------------+

With Terraform, you can quickly create a cloud infrastructure in Yandex Cloud and manage it using configuration files. These files store the infrastructure description written in HashiCorp Configuration Language (HCL). If you change the configuration files, Terraform automatically detects which part of your configuration is already deployed, and what should be added or removed.

Terraform is distributed under the Business Source License. The Yandex Cloud provider for Terraform is distributed under the MPL-2.0 license.

For more information about the provider resources, see the relevant documentation on the Terraform website or its mirror.

If you do not have Terraform yet, install it and configure the Yandex Cloud provider.

To delete a cluster created using Terraform:

In the command line, go to the folder that houses the current Terraform configuration file with an infrastructure plan.
Delete the resources using this command:
```
terraform destroy
```
Alert

Terraform will delete all the resources you created using it, such as clusters, networks, subnets, and VMs.
Type yes and press Enter.

To delete a Kubernetes cluster, use the delete method for the Cluster resource.

Deleting a Kubernetes cluster

Was the article helpful?