Deleting a Kubernetes cluster

Written by

Updated at September 4, 2026

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 that you can get by using this 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

In the folder where you want to delete a Managed Service for Kubernetes cluster, open the Managed Service for Kubernetes section.
Click in the row with the Managed Service for Kubernetes cluster to delete and select Delete.
In the window that opens, confirm the cluster deletion.

If you do not have the Yandex Cloud CLI 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 guides on the Terraform website or its mirror.

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

To manage infrastructure using Terraform under a service account or user accounts (a Yandex account, a federated account, or a local user), authenticate using the appropriate method.

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 REST API method for the Cluster resource or the ClusterService/Delete gRPC API call.

Deleting a Kubernetes cluster

Was the article helpful?