Menu
Amazon Relational Database Service
API Reference (API Version 2014-10-31)

DeleteDBClusterSnapshot

Deletes a DB cluster snapshot. If the snapshot is being copied, the copy operation is terminated.

Note

The DB cluster snapshot must be in the available state to be deleted.

For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

DBClusterSnapshotIdentifier

The identifier of the DB cluster snapshot to delete.

Constraints: Must be the name of an existing DB cluster snapshot in the available state.

Type: String

Required: Yes

Response Elements

The following element is returned by the service.

DBClusterSnapshot

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBClusterSnapshots action.

Type: DBClusterSnapshot object

Errors

For information about the errors that are common to all actions, see Common Errors.

DBClusterSnapshotNotFoundFault

DBClusterSnapshotIdentifier does not refer to an existing DB cluster snapshot.

HTTP Status Code: 404

InvalidDBClusterSnapshotStateFault

The supplied value is not a valid DB cluster snapshot state.

HTTP Status Code: 400

Example

Sample Request

Copy
https://rds.us-east-1.amazonaws.com/ ?Action=DeleteDBClusterSnapshot &DBClusterSnapshotIdentifier=sample-cluster-snapshot &SignatureMethod=HmacSHA256 &SignatureVersion=4 &Version=2014-10-31 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIADQKE4SARGYLE/20150318/us-east-1/rds/aws4_request &X-Amz-Date=20150318T215614Z &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date &X-Amz-Signature=7aaab0a295151051bc4723f5b1f7b6b535615b8db9256bd56993c4dc6df4c2c4

Sample Response

Copy
<DeleteDBClusterSnapshotResponse xmlns="http://rds.amazonaws.com/doc/2014-10-31/"> <DeleteDBClusterSnapshotResult> <DBClusterSnapshot> <Port>0</Port> <Status>available</Status> <Engine>aurora</Engine> <SnapshotType>manual</SnapshotType> <LicenseModel>aurora</LicenseModel> <DBClusterSnapshotIdentifier>sample-cluster-snapshot</DBClusterSnapshotIdentifier> <SnapshotCreateTime>2015-03-18T20:53:22.523Z</SnapshotCreateTime> <DBClusterIdentifier>sample-cluster</DBClusterIdentifier> <VpcId>vpc-3fabee54</VpcId> <ClusterCreateTime>2015-03-06T22:11:13.826Z</ClusterCreateTime> <PercentProgress>100</PercentProgress> <AllocatedStorage>1</AllocatedStorage> <MasterUsername>awsuser</MasterUsername> </DBClusterSnapshot> </DeleteDBClusterSnapshotResult> <ResponseMetadata> <RequestId>994ab08d-cdb9-2ce4-abf9-7528e6348483</RequestId> </ResponseMetadata> </DeleteDBClusterSnapshotResponse>

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: