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

DeleteDBSnapshot

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

Note

The DBSnapshot must be in the available state to be deleted.

Request Parameters

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

DBSnapshotIdentifier

The DBSnapshot identifier.

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

Type: String

Required: Yes

Response Elements

The following element is returned by the service.

DBSnapshot

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

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

Type: DBSnapshot object

Errors

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

DBSnapshotNotFound

DBSnapshotIdentifier does not refer to an existing DB snapshot.

HTTP Status Code: 404

InvalidDBSnapshotState

The state of the DB snapshot does not allow deletion.

HTTP Status Code: 400

Example

Sample Request

Copy to clipboard
https://rds.us-east-1.amazonaws.com/ ?Action=DeleteDBSnapshot &DBSnapshotIdentifier=mysqldb-snap-02 &SignatureMethod=HmacSHA256 &SignatureVersion=4 &Version=2014-09-01 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIADQKE4SARGYLE/20140423/us-east-1/rds/aws4_request &X-Amz-Date=20140423T203337Z &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date &X-Amz-Signature=619f04acffeb4b80d2f442526b1c9da79d0b3097151c24f28e83e851d6541414

Sample Response

Copy to clipboard
<DeleteDBSnapshotResponse xmlns="http://rds.amazonaws.com/doc/2014-09-01/"> <DeleteDBSnapshotResult> <DBSnapshot> <Port>3306</Port> <OptionGroupName>default:mysql-5-6</OptionGroupName> <Status>deleted</Status> <Engine>mysql</Engine> <SnapshotType>manual</SnapshotType> <LicenseModel>general-public-license</LicenseModel> <DBInstanceIdentifier>mysqldb</DBInstanceIdentifier> <EngineVersion>5.6.13</EngineVersion> <DBSnapshotIdentifier>mysqldb-snap-02</DBSnapshotIdentifier> <SnapshotCreateTime>2014-04-23T16:11:25.371Z</SnapshotCreateTime> <AvailabilityZone>us-east-1a</AvailabilityZone> <InstanceCreateTime>2014-04-21T22:24:26.573Z</InstanceCreateTime> <PercentProgress>100</PercentProgress> <AllocatedStorage>100</AllocatedStorage> <MasterUsername>myawsuser</MasterUsername> </DBSnapshot> </DeleteDBSnapshotResult> <ResponseMetadata> <RequestId>7b17b2b1-ba25-11d3-a537-cef97546330c</RequestId> </ResponseMetadata> </DeleteDBSnapshotResponse>

See Also

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