DeleteDBSnapshot - Amazon Relational Database Service

Description

Deletes a DBSnapshot.

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

Request Parameters

For information about the common parameters that all actions use, see Common Query Parameters.

Name Description Required

Name	Description	Required
`DBSnapshotIdentifier`	The DBSnapshot identifier. Constraints: Must be the name of an existing DB Snapshot in the `available` state. Type: String	Yes

DBSnapshotIdentifier

The DBSnapshot identifier.

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

Type: String

Yes

Response Elements

The following elements come wrapped in a DBSnapshot structure.

Name	Description
`AllocatedStorage`	Specifies the allocated storage size in gigabytes (GB). Type: Integer
`AvailabilityZone`	Specifies the name of the Availability Zone the DB Instance was located in at the time of the DB Snapshot. Type: String
`DBInstanceIdentifier`	Specifies the the DBInstanceIdentifier of the DB Instance this DB Snapshot was created from. Type: String
`DBSnapshotIdentifier`	Specifies the identifier for the DB Snapshot. Type: String
`Engine`	Specifies the name of the database engine. Type: String
`EngineVersion`	Specifies the version of the database engine. Type: String
`InstanceCreateTime`	Specifies the time (UTC) when the snapshot was taken. Type: DateTime
`LicenseModel`	License model information for the restored DB Instance. Type: String
`MasterUsername`	Provides the master username for the DB Instance. Type: String
`Port`	Specifies the port that the database engine was listening on at the time of the snapshot. Type: Integer
`SnapshotCreateTime`	Provides the time (UTC) when the snapshot was taken. Type: DateTime
`SnapshotType`	Provides the type of the DB Snapshot. Type: String
`Status`	Specifies the status of this DB Snapshot. Type: String
`VpcId`	Provides the Vpc Id associated with the DB Snapshot. Type: String

Errors

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

Error	Description	HTTP Status Code
`DBSnapshotNotFound`	DBSnapshotIdentifier does not refer to an existing DB Snapshot.	404
`InvalidDBSnapshotState`	The state of the DB Security Snapshot does not allow deletion.	400

Examples

Sample Request

https://rds.amazon.com/
   &DBSnapshotIdentifier=mydbsnapshot
   &Version=2012-04-23
   &SignatureVersion=2
   &SignatureMethod=HmacSHA256
   &Timestamp=2011-05-23T06%3A27%3A42.551Z
   &AWSAccessKeyId=<AWS Access Key ID>
   &Signature=<Signature>

Sample Response

<DeleteDBSnapshotResponse xmlns="http://rds.amazonaws.com/doc/2012-04-23/">
  <DeleteDBSnapshotResult>
    <DBSnapshot>
      <Port>3306</Port>
      <SnapshotCreateTime>2011-03-11T07:20:24.082Z</SnapshotCreateTime>
      <Engine>mysql</Engine>
      <Status>deleted</Status>
      <AvailabilityZone>us-east-1d</AvailabilityZone>
      <LicenseModel>general-public-license</LicenseModel>
      <InstanceCreateTime>2010-07-16T00:06:59.107Z</InstanceCreateTime>
      <AllocatedStorage>60</AllocatedStorage>
      <DBInstanceIdentifier>simcoprod01</DBInstanceIdentifier>
      <EngineVersion>5.1.47</EngineVersion>
      <DBSnapshotIdentifier>mysnapshot2</DBSnapshotIdentifier>
      <SnapshotType>manual</SnapshotType>
      <MasterUsername>master</MasterUsername>
    </DBSnapshot>
  </DeleteDBSnapshotResult>
  <ResponseMetadata>
    <RequestId>627a43a1-8507-11e0-bd9b-a7b1ece36d51</RequestId>
  </ResponseMetadata>
</DeleteDBSnapshotResponse>