调用DeleteBackup接口删除数据备份文件。
调用该接口删除数据备份文件只删除实例自身的备份集,不会删除所关联实例(只读、灾备、克隆等)的备份集。
调用该接口时,实例必须满足以下条件,否则将操作失败:
- 实例状态为运行中;
- 实例为MySQL或PostgreSQL的高可用版本;
- 如果日志备份已关闭,RDS实例不支持按时间点恢复功能。此时您可以删除已生成超过7天的任意数据备份文件;
- 如果日志备份已开启,且日志备份保留时间小于数据备份保留时间,则超过日志备份保留时间的数据备份文件可以删除。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DeleteBackup |
系统规定参数。取值:DeleteBackup。 |
DBInstanceId | String | 是 | rm-uf6wjk5xxxxxxx |
实例ID。 |
BackupId | String | 是 | 324909958 |
备份集ID。可通过接口DescribeBackups查询。多组值以英文逗号(,)隔开,单次最多传入100个。 说明 只支持删除DescribeBackups中StoreStatus为Enabled的备份集。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 37441409-FFD1-40AA-8EC5-9ECF5E2F7C29 |
请求ID。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=DeleteBackup
&DBInstanceId=rm-uf6wjk5xxxxxxx
&BackupId=324909958
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<?xml version="1.0" encoding="UTF-8" ?>
<DeleteBackupResponse>
<RequestId>37441409-FFD1-40AA-8EC5-9ECF5E2F7C29</RequestId>
</DeleteBackupResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "37441409-FFD1-40AA-8EC5-9ECF5E2F7C29"
}
错误码
访问错误中心查看更多错误码。