Deleting an Amazon DocumentDB Instance

    Note

    Amazon DocumentDB stores all of your data in the cluster volume. The data persists in that cluster volume, even if you remove all the instances from your cluster. If you need to access the data again, you can add an instance to the cluster at any time and pick up where you left off.

    Deleting the last instance of an Amazon DocumentDB cluster will also delete the cluster, as well as the automatic snapshots and continuous backups associated with that cluster. Amazon DocumentDB enforces deletion protection for a cluster whether you perform the delete operation using the AWS Management Console or the AWS CLI. If deletion protection is enabled, you can’t delete a cluster.

    To delete a cluster that has deletion protection enabled, you must first modify the cluster and disable deletion protection. For more information, see Deleting an Amazon DocumentDB Cluster.

    The following procedure deletes a specified Amazon DocumentDB instance using the console.

    1. Sign in to the AWS Management Console, and open the Amazon DocumentDB console at .

    2. In the navigation pane, choose Clusters .

      Tip

      If you don’t see the navigation pane on the left side of your screen, choose the menu icon () in the upper-left corner of the page.

    3. Check the box to the left of the instance you wish to delete.

    4. Select Actions, and then choose Delete.

      1. If you are deleting the last instance in your cluster:

        • Create final cluster snapshot? — Choose Yes if you want to create a final snapshot before the cluster is deleted. Otherwise, choose No.

        • Final snapshot name — If you choose to create a final snapshot, enter the cluster snapshot identifier of the new cluster snapshot created.

      2. If you are not deleting the last instance in your cluster:

        • Delete <instance-name> instance? — Enter the phrase delete me into the field to confirm the deletion.
    1. Select Delete to delete the instance.

    It takes several minutes for an instance to be deleted. To monitor the status of an instance, see Monitoring an Amazon DocumentDB Instance’s Status.

    1. First, determine how many instances are in your Amazon DocumentDB cluster:

      To determine how many instances are in your cluster, run the command, as follows.

      Output from this operation looks something like the following.

    2. If there are more than one instances in your Amazon DocumentDB cluster:

      To delete a specified Amazon DocumentDB instance, use the command with the parameter, as shown below. It takes several minutes for an instance to be deleted. To monitor the status of an instance, see .

      Output from this operation looks something like the following.