Deleting a cluster - Amazon ElastiCache

Deleting a cluster

As long as a cluster is in the available state, you are being charged for it, whether or not you are actively using it. To stop incurring charges, delete the cluster.

Warning

  • When you delete an ElastiCache cluster, your manual snapshots are retained. You can also create a final snapshot before the cluster is deleted. Automatic cache snapshots are not retained. For more information, see Snapshot and restore.

  • CreateSnapshot permission is required to create a final snapshot. Without this permission, the API call will fail with an Access Denied exception.

The following procedure deletes a single cluster from your deployment. To delete multiple clusters, repeat the procedure for each cluster that you want to delete. You do not need to wait for one cluster to finish deleting before starting the procedure to delete another cluster.

To delete a cluster

  1. Sign in to the AWS Management Console and open the Amazon ElastiCache console at https://console.aws.amazon.com/elasticache/.

  2. In the ElastiCache engine dashboard, choose Valkey or Redis OSS.

    A list of all caches running on that engine appears.

  3. To choose the cluster to delete, choose the cluster's name from the list of clusters. In this case, the name of the cluster you created at Step 2: Create a cluster.

    Important

    You can only delete one cluster at a time from the ElastiCache console. Choosing multiple clusters disables the delete operation.

  4. For Actions, choose Delete.

  5. In the Delete Cluster confirmation screen, type the name of the cluster and choose Final Backup. Then choose Delete to delete the cluster, or choose Cancel to keep the cluster.

    If you chose Delete, the status of the cluster changes to deleting.

As soon as your cluster is no longer listed in the list of clusters, you stop incurring charges for it.

The following code deletes the cache cluster my-cluster. In this case, substitute my-cluster with the name of the cluster you created at Step 2: Create a cluster.

aws elasticache delete-cache-cluster --cache-cluster-id my-cluster

The delete-cache-cluster CLI action only deletes one cache cluster. To delete multiple cache clusters, call delete-cache-cluster for each cache cluster that you want to delete. You do not need to wait for one cache cluster to finish deleting before deleting another.

For Linux, macOS, or Unix:

aws elasticache delete-cache-cluster \
    --cache-cluster-id my-cluster \
    --region us-east-2

For Windows:

aws elasticache delete-cache-cluster ^
    --cache-cluster-id my-cluster ^
    --region us-east-2

For more information, see the AWS CLI for ElastiCache topic delete-cache-cluster.