Amazon DocumentDB
Developer Guide

Step 4: (Optional) Delete the Amazon DocumentDB Instance and Cluster

If you are no longer using your Amazon DocumentDB cluster, you should delete it so that you aren't charged for resources that you're not using.

Using the AWS Management Console

First, delete all instances related to your cluster.

To delete an instance

  1. Open the Amazon DocumentDB console at

  2. In the navigation pane, choose Instances.

  3. Choose your Amazon DocumentDB instance. Choose Actions, and then choose Delete. In the confirmation dialog box, choose Delete.

Monitor the status of the instances. When they are no longer listed on the console or are not listed when you run the following AWS CLI operation, continue with deleting the cluster itself.

aws docdb describe-db-instances \ --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceStatus]'

To delete a cluster

  1. In the navigation pane, choose Clusters. Then in the list of clusters, choose the button to the left of the name of the cluster that you want to delete.

  2. In the Actions menu, choose Delete.

  3. In the Delete <cluster-name> dialog box, do the following:

    1. Create final cluster snapshot?: Choose Yes to create a final snapshot before deleting the cluster, or choose No to delete the cluster without creating a final snapshot.

    2. Final snapshot name: If you chose Yes, either accept the name provided by Amazon DocumentDB for your final snapshot, or enter another name.

    3. If you chose No for creating a final snapshot, read and acknowledge the paragraph that describes what will not be available to you after the cluster is deleted.

  4. To delete the cluster, choose Delete. To retain the cluster, choose Cancel.


    If you choose Delete, the process cannot be stopped or reversed.

  5. Optionally, monitor the status of your cluster.

    aws docdb describe-db-clusters \ --query 'DBClusters[*].[DBClusterIdentifier,Status]'