# 删除备份
#### 功能介绍
删除备份。
![](https://support.huaweicloud.com/api-csbs/public_sys-resources/note_3.0-zh-cn.png)
删除操作为异步操作，删除操作会根据后台执行任务的情况进行排队，所以不会立即完成删除，需要通过不断查询删除任务信息获取删除结果，时间最长耗费30分钟。
例如：每个用户最多同时执行5个备份删除任务，如果超过5个删除任务时，则第6个及以后的任务将需要排队等待执行。
#### URI
- URI DELETE https://{endpoint}/v1/{project_id}/providers/{provider_id}/checkpoints/{checkpoint_id}
  
- 参数说明
  表1参数说明 
  | 参数            | 是否必选 | 参数类型   | 描述                                                                                                                               |
  |:---|:---|:---|:---|
  | project_id    | 是    | String | 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-csbs/zh-cn_topic_0136033750.html)。 |
  | 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 | 服务不可用   |
     
  
 
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-csbs/zh-cn_topic_0071888297.html)。