全部产品
Search
文档中心

云数据库 RDS:DeleteBackup - 删除实例数据备份文件

更新时间:Sep 20, 2023

该接口用于删除RDS实例的数据备份文件。

接口说明

适用引擎

  • RDS MySQL
  • RDS PostgreSQL
说明 仅支持高可用版本实例。

功能说明

调用该接口删除数据备份文件只删除实例自身的备份集,不会删除所关联实例(只读、灾备、克隆等)的备份集。

注意事项

调用该接口时,实例必须满足以下条件,否则将操作失败:

  • 实例状态为运行中;
  • 如果日志备份已关闭,RDS实例不支持按时间点恢复功能。此时您可以删除已生成超过7天的任意数据备份文件;
  • 如果日志备份已开启,且日志备份保留时间小于数据备份保留时间,则超过日志备份保留时间的数据备份文件可以删除。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
rds:DeleteBackupWRITE
  • DBInstance
    acs:rds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}

请求参数

名称类型必填描述示例值
DBInstanceIdstring

实例ID。可调用DescribeDBInstances获取。

rm-uf6wjk5****
BackupIdstring

备份集ID。可通过接口DescribeBackups查询。多组值以英文逗号(,)隔开,单次最多传入100个。

说明 只支持删除DescribeBackupsStoreStatusEnabled的备份集。
324909958

返回参数

名称类型描述示例值
object

返回参数详情。

RequestIdstring

请求ID。

37441409-FFD1-40AA-8EC5-9ECF5E2F7C29

示例

正常返回示例

JSON格式

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

错误码

HTTP status code错误码错误信息描述
400ReadDBInstanceNotSupportThe operation is not permitted due to type of the instance.只读实例不允许执行该操作。
400ParameterLeastAssociateMust input at least one optional parameter必须输入至少一个可选参数。
400DeleteBackupSetNumExceedDelete backup set number is more than 100.删除备份集的数目大于100。
403IncorrectDBInstanceStateCurrent DB instance state does not support this operation.当前实例状态不支持此操作。
403IncorrectDBInstanceTypeCurrent DB instance engine and type does not support operations.操作失败,当前数据库实例引擎和类型不支持。
403IncorrectDBInstanceCharacterTypeCurrent DB Instance character_type does not support this operation.当前DB实例字符类型不支持此操作。
403OperationDenied.BackupSetDeleteNotSupportThe Specified backup does not support this operation.当前备份集不支持删除
404InvalidDBInstanceName.NotFoundInvalid DBInstanceId NotFound.数据库实例ID不存在,请检查。
404IncorrectDBInstanceLockModeCurrent DB instance lock mode does not support this operation.操作失败,实例处于锁定状态。
404InvalidBackupSetID.NotFoundSpecified backup set ID does not exist.备份集不存在。请查看已存在的备份集。

访问错误中心查看更多错误码。