Amazon DocumentDB
Developer Guide

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Deleting a Cluster Snapshot

A manual snapshot is a full backup that is deleted only when you manually delete it using the AWS Management Console or AWS CLI. You cannot manually delete an automatic snapshot because automatic snapshots are deleted only when the snapshot's retention period expires or you delete the snapshot's cluster.

Using the AWS Management Console

To delete a manual cluster snapshot using the console

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

  2. In the navigation pane, choose Snapshots.

    Tip

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

  3. In the list of snapshots, choose the button to the left of the snapshot that you want to delete. The snapshot's type must be manual.

  4. On the Actions menu, choose Delete. If the Delete option is unavailable, you probably chose an automatic snapshot.

  5. On the delete confirmation screen, to delete the snapshot, choose Delete. To keep the snapshot, choose Cancel.

Using the AWS CLI

An Amazon DocumentDB manual cluster snapshot is a full backup that you can manually delete using the AWS CLI. You cannot manually delete an automatic snapshot.

To delete a manual cluster snapshot using the AWS CLI, use the delete-db-cluster-snapshot operation with the following parameters.

Parameters

  • --db-cluster-snapshot-identifier—Required. The name of the manual snapshot to delete.

The following example deletes the cluster snapshot sample-cluster-snapshot.

For Linux, macOS, or Unix:

aws docdb delete-db-cluster-snapshot \ --db-cluster-snapshot-identifier sample-cluster-snapshot

For Windows:

aws docdb delete-db-cluster-snapshot ^ --db-cluster-snapshot-identifier sample-cluster-snapshot

Output from this operation looks something like the following (JSON format).

{ "DBClusterSnapshot": { "DBClusterIdentifier": "sample-cluster", "Port": 0, "KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/EXAMPLE-KMS-KEY-ID", "Status": "available", "SnapshotCreateTime": "2018-11-05T21:25:34.841Z", "MasterUsername": "user-name", "PercentProgress": 100, "ClusterCreateTime": "2018-11-05T21:01:18.946Z", "DBClusterSnapshotIdentifier": "sample-cluster-snapshot", "Engine": "docdb", "EngineVersion": "3.6.0", "VpcId": "vpc-91280df6", "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:012345678901:cluster-snapshot:sample-cluster-snapshot", "SnapshotType": "manual", "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1c", "us-east-1d", "us-east-1e", "us-east-1f" ], "StorageEncrypted": true } }