Deletes the backups of a specified PolarDB cluster.

Before you call this operation, make sure that the cluster meets the following requirements:

  • The cluster is in the Running state.
  • The data is backed up for the cluster.
Note
  • You can call the DescribeBackups operation to query the status of backups.
  • After you delete the backup file, the storage space that is consumed by the backup file is released. The released storage space is smaller than the size of the backup file, because your snapshots share some data blocks.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String No DeleteBackup

The operation that you want to perform. Set the value to DeleteBackup.

BackupId String Yes 11111111

The IDs of the backups. If you need to specify multiple backup IDs, separate the backup IDs with commas (,).

Note You can call the DescribeBackups operation to query the backup IDs.
DBClusterId String Yes pc-**************

The ID of the PolarDB cluster.

Response parameters

Parameter Type Example Description
RequestId String 3CF4F9FE-BF77-4739-8D68-B8DF5D******

The ID of the request.

Examples

Sample requests

http(s)://polardb.aliyuncs.com/? Action=DeleteBackup
&BackupId=11111111
&DBClusterId=pc-**************
&<Common request parameters>

Sample success responses

XML format

<DeleteBackupResponse>
  <RequestId>3CF4F9FE-BF77-4739-8D68-B8DF5D******</RequestId>
</DeleteBackupResponse>

JSON format

{
    "RequestId":"3CF4F9FE-BF77-4739-8D68-B8DF5D******"
}

Error codes

For a list of error codes, visit the API Error Center.