Menu
Amazon Redshift
API Reference (API Version 2012-12-01)

DeleteClusterSnapshot

Deletes the specified manual snapshot. The snapshot must be in the available state, with no other users authorized to access the snapshot.

Unlike automated snapshots, manual snapshots are retained even after you delete your cluster. Amazon Redshift does not delete your manual snapshots. You must delete manual snapshot explicitly to avoid getting charged. If other accounts are authorized to access the snapshot, you must revoke all of the authorizations before you can delete the snapshot.

Request Parameters

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

SnapshotIdentifier

The unique identifier of the manual snapshot to be deleted.

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

Type: String

Required: Yes

SnapshotClusterIdentifier

The unique identifier of the cluster the snapshot was created from. This parameter is required if your IAM user has a policy containing a snapshot resource element that specifies anything other than * for the cluster name.

Constraints: Must be the name of valid cluster.

Type: String

Required: No

Response Elements

The following element is returned by the service.

Snapshot

Describes a snapshot.

Type: Snapshot object

Errors

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

ClusterSnapshotNotFound

The snapshot identifier does not refer to an existing cluster snapshot.

HTTP Status Code: 404

InvalidClusterSnapshotState

The specified cluster snapshot is not in the available state, or other accounts are authorized to access the snapshot.

HTTP Status Code: 400

Example

Sample Request

https://redshift.us-east-1.amazonaws.com/
    ?Action=DeleteClusterSnapshot
    &SnapshotIdentifier=snapshot-1234
    &Version=2012-12-01
    &x-amz-algorithm=AWS4-HMAC-SHA256
    &x-amz-credential=AKIAIOSFODNN7EXAMPLE/20121208/us-east-1/redshift/aws4_request
    &x-amz-date=20121208T005225Z
    &x-amz-signedheaders=content-type;host;x-amz-date

Sample Response

<DeleteClusterSnapshotResponse xmlns="http://redshift.amazonaws.com/doc/2012-12-01/">
  <DeleteClusterSnapshotResult>
    <Snapshot>
      <SnapshotCreateTime>2012-12-07T23:31:02.372Z</SnapshotCreateTime>
      <Port>5439</Port>
      <SnapshotIdentifier>snapshot-1234</SnapshotIdentifier>
      <Status>deleted</Status>
      <ClusterCreateTime>2012-12-06T23:09:01.475Z</ClusterCreateTime>
      <SnapshotType>manual</SnapshotType>
      <ClusterVersion>1.0</ClusterVersion>
      <AvailabilityZone>us-east-1a</AvailabilityZone>
      <ClusterIdentifier>examplecluster</ClusterIdentifier>
      <MasterUsername>masteruser</MasterUsername>
      <NodeType>ds2.xlarge</NodeType>
      <DBName>mydb</DBName>
      <NumberOfNodes>3</NumberOfNodes>
    </Snapshot>
  </DeleteClusterSnapshotResult>
  <ResponseMetadata>
    <RequestId>88a31de4-40d1-11e2-8a25-eb010998df4e</RequestId>
  </ResponseMetadata>
</DeleteClusterSnapshotResponse>

See Also

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