Vultr DocsLatest Articles

How to Delete Vultr Kubernetes Engine Cluster

Updated on December 9, 2024

Deleting a Vultr Kubernetes Engine (VKE) cluster involves completely removing your VKE cluster’s infrastructure, including the control plane, worker nodes, and all associated resources. This process is final and should be performed carefully. VKE cluster provides a simple method to ensure the thorough and efficient deletion of your VKE cluster when it’s no longer required.

Follow this guide delete a VKE cluster from your Vultr account using the Vultr Customer Portal, API, or CLI.

  • Vultr Customer Portal
  • Vultr API
  • Vultr CLI

  1. Navigate to Products and click Kubernetes.

  2. Click your target VKE cluster to open its management page.

  3. Click delete on top-right of the overview page.

    Button to open the delete cluster dialog box

  4. Click Destroy VKE Cluster on the confirmation prompt to permanently delete the target VKE cluster.

    Button to confirm the deletion of the cluster

  1. Send a GET request to the List Kubernetes Clusters endpoint and note the target VKE cluster's ID.

    console 
    $ curl -X GET "https://api.vultr.com/v2/kubernetes/clusters" \
    -H "Authorization: Bearer ${VULTR_API_KEY}" \
    -H "Content-Type: application/json"

  2. Send a DELETE request to the Delete Kubernetes Cluster endpoint to delete the target VKE cluster.

    console 
    $ curl -X DELETE "https://api.vultr.com/v2/kubernetes/clusters/<cluster-id>" \
    -H "Authorization: Bearer ${VULTR_API_KEY}"

  3. Send a DELETE request to the Delete Kubernetes Cluster with Linked Resources endpoint to delete the target VKE cluster with all linked resources.

    console 
    $ curl -X DELETE "https://api.vultr.com/v2/kubernetes/clusters/<cluster-id>/delete-with-linked-resources" \
    -H "Authorization: Bearer ${VULTR_API_KEY}"

  1. List the available VKE clusters and note the target VKE cluster's ID.

    console 
    $ vultr-cli kubernetes list --summarize

  2. Delete the target VKE cluster.

    console 
    $ vultr-cli kubernetes delete <cluster-id>

  3. Delete the target VKE cluster along with its resources.

    console 
    $ vultr-cli kubernetes delete --delete-resources <cluster-id>