删除备份

功能介绍

删除备份。

删除操作为异步操作，删除操作会根据后台执行任务的情况进行排队，所以不会立即完成删除，需要通过不断查询删除任务信息获取删除结果，时间最长耗费30分钟。

例如：每个用户最多同时执行5个备份删除任务，如果超过5个删除任务时，则第6个及以后的任务将需要排队等待执行。

URI

• URI

  DELETE https://{endpoint}/v1/{project_id}/providers/{provider_id}/checkpoints/{checkpoint_id}

• 参数说明

  表1 参数说明

  参数	是否必选	参数类型	描述
  project_id	是	String	项目ID。 获取方法请参见获取项目ID。
  provider_id	是	String	备份提供商ID，当前取值固定值：fc4d5750-22e7-4798-8a46-f48f62c4c1da。用于区分备份对象是服务器或磁盘。
  checkpoint_id	是	String	备份记录ID

请求

• 查询参数说明

  表2 查询参数说明

  参数	是否必选	参数类型	描述
  checkpoint_items	否	String	待删除的checkpoint_item id列表。未设置则删除checkpoint下所有checkpoint_item。

• 要素说明

  无

• 请求样例

  删除指定备份记录下的所有的备份
  DELETE https://{endpoint}/v1/{project_id}/providers/{provider_id}/checkpoints/{checkpoint_id}
  删除指定备份记录下某条的备份
  DELETE https://{endpoint}/v1/{project_id}/providers/{provider_id}/checkpoints/{checkpoint_id}?checkpoint_items={checkpoint_items_id}

响应

• 要素说明

  无

• 响应样例

  { 
  }

状态码

• 正常

  状态码	说明
  200	OK

• 异常

  状态码	说明
  400	请求参数不合法
  401	鉴权失败
  403	没有操作权限
  404	请求对象不存在
  500	服务内部错误
  503	服务不可用

错误码

请参考错误码。