批量删除手动备份（SQL Server）

功能介绍

批量删除手动备份。

• 调用接口前，您需要了解API认证鉴权。
• 调用接口前，您需要了解请求Header参数说明。

调试

您可以在API Explorer中调试该接口。

接口约束

该接口仅支持RDS for SQL Server引擎。

URI

• URI格式

  POST /v3/{project_id}/backups/batch-delete

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	参数解释： 租户在某一region下的project ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

请求消息

请求示例

批量删除手动备份。

POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/backups/batch-delete

{ 
  "backup_ids" : [ "53ad33abe43976054br04", "63ad3439af9776054br04" ] 
}

响应消息

• 响应要素说明

  表3 响应Body参数

  参数	参数类型	描述
  delete_results	Array of objects	参数解释： 备份删除结果，详情请参见表4。

  表4 delete_results字段数据结构说明

  参数	参数类型	描述
  backup_id	String	参数解释： 备份ID。 取值范围： 不涉及。
  error_code	String	参数解释： 提交任务后返回的编码。 取值范围： 任务执行成功，返回0。 任务执行失败，返回具体的错误码。
  error_msg	String	参数解释： 提交任务后返回的描述信息。 取值范围： 任务执行成功，返回Success。 任务执行失败，返回具体的错误信息。

• 响应样例

  { 
    "delete_results" : [ { 
      "backup_id" : "dsfae23fsfdsae3435br04", 
      "error_code" : "DBS.200054", 
      "error_msg" : "the backup is in use" 
    } , 
  { 
      "backup_id" : "ed23545223fsfdsae3435br04", 
      "error_code" : "0", 
      "error_msg" : "Success" 
    } 
  ] }

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。