How to Delete a Cluster

Deleting a cluster removes the cluster subscription and its fabric associations. The underlying instances are not destroyed, they remain on your account as standalone servers.

This guide explains how to delete a cluster using the Vultr API.

1. Send a GET request to the Get Cluster endpoint to retrieve the cluster details and verify that no instances are attached. Replace {cluster-id} with the id of the cluster you want to delete.

   CONSOLE

   Copy

   $ curl "https://api.vultr.com/v2/clusters/{cluster-id}" \
       -X GET \
       -H "Authorization: Bearer ${VULTR_API_KEY}"

   Explain Code

   Powered by Vultr AgentBeta

   Verify that the cluster has no attached instances. If instances are attached, remove them first using How to Remove Instances from a Cluster.

2. Send a DELETE request to the Delete Cluster endpoint to delete the cluster. Replace {cluster-id} with the cluster id.

   CONSOLE

   Copy

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

   Explain Code

   Powered by Vultr AgentBeta

   A successful deletion returns an HTTP 204 No Content response with no response body.

3. Send a GET request to the List Clusters endpoint to retrieve all clusters.

   CONSOLE

   Copy

   $ curl "https://api.vultr.com/v2/clusters" \
       -X GET \
       -H "Authorization: Bearer ${VULTR_API_KEY}"

   Explain Code

   Powered by Vultr AgentBeta

   Verify that the deleted cluster no longer appears in the list.