GET

/#Action=DeleteDBCluster

http://rds.{region}.amazonaws.com/#Action=DeleteDBCluster

Deletes a previously provisioned cluster. When you delete a cluster, all automated backups for that cluster are deleted and can't be recovered. Manual DB cluster snapshots of the specified cluster are not deleted.

Access Token Required: API Key

Query Params

DBClusterIdentifierstringrequired

The cluster identifier for the cluster to be deleted. This parameter isn't case sensitive. Constraints: <ul> <li> Must match an existing <code>DBClusterIdentifier</code>. </li> </ul>

SkipFinalSnapshotboolean

Determines whether a final cluster snapshot is created before the cluster is deleted. If <code>true</code> is specified, no cluster snapshot is created. If <code>false</code> is specified, a cluster snapshot is created before the DB cluster is deleted. <note> If <code>SkipFinalSnapshot</code> is <code>false</code>, you must specify a <code>FinalDBSnapshotIdentifier</code> parameter. </note> Default: <code>false</code>

FinalDBSnapshotIdentifierstring

The cluster snapshot identifier of the new cluster snapshot created when <code>SkipFinalSnapshot</code> is set to <code>false</code>. <note> Specifying this parameter and also setting the <code>SkipFinalShapshot</code> parameter to <code>true</code> results in an error. </note> Constraints: <ul> <li> Must be from 1 to 255 letters, numbers, or hyphens. </li> <li> The first character must be a letter. </li> <li> Cannot end with a hyphen or contain two consecutive hyphens. </li> </ul>

Actionstringrequired

Allowed:

Versionstringrequired

Allowed:

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'http://rds.{region}.amazonaws.com/#Action=DeleteDBCluster' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}