You can call this operation to delete backup data files.

Only the backup sets of the instances themselves are deleted. The backup sets of the associated instances such as read-only, disaster recovery, and clone instances are not deleted.

This operation must meet the following requirements:

  • The instances are in the running state.
  • The instances are the high availability versions of MySQL, PostgreSQL and PPAS.
  • If log backups are disabled, the RDS instances do not allow you to restore data by time. You can delete any data backup files which are retained for more than seven days.
  • If log backups are enabled, and the retention period of log backups is less than the retention period of data backups, the data backup files which exceed the retention period of log backups can be deleted.

Debugging

You can use API Explorer to perform debugging. API Explorer allows you to perform various operations to simplify API usage. For example, you can retrieve APIs, call APIs, and dynamically generate SDK example code.

Request parameters

Parameter Type Required? Example Description
Action String Yes DeleteBackup

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

DBInstanceId String Yes rm-uf6wjk5xxxxxxx

The ID of the instance.

BackupId String Yes 324909958

The ID of the backup set. You can call the DescribeBackups operation to query the IDs of backup sets. Separate multiple values with commas (,). Up to 100 values can be entered in a single request.

Note Only the backup sets whose StoreStatus is Enabled when you call the DescribeBackups operation can be deleted.
AccessKeyId String No LTAIfCxxxxxxx

The AccessKey ID issued by Alibaba Cloud for users to access services.

Response parameters

Parameter Type Example Description
RequestId String 37441409-FFD1-40AA-8EC5-9ECF5E2F7C29

The ID of the request.

Examples

Sample requests


http(s)://rds.aliyuncs.com/? Action=DeleteBackup
&DBInstanceId=rm-uf6wjk5xxxxxxx
&BackupId=324909958
&<Common request parameters>

Successful response examples

XML format

<DeleteBackupResponse>
  <RequestId>37441409-FFD1-40AA-8EC5-9ECF5E2F7C29</RequestId>
</DeleteBackupResponse>

JSON format

{
	"RequestId":"37441409-FFD1-40AA-8EC5-9ECF5E2F7C29"
}

Error codes

View error codes