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