释放CDS磁盘（新）
更新时间：2023-08-09
描述
- 该接口用于释放未挂载的CDS磁盘，系统盘不能释放。
- 磁盘释放后不可恢复。用户可指定是否删除磁盘关联的快照，缺省情况下，该磁盘的所有快照将保留，但会删除与磁盘的关联关系。
- 只有磁盘状态为 Available 或 Expired 或 Error 时才可以执行此操作，否则将提示 409 错误。
- 如果 volumeId 的磁盘不存在，将提示 404 错误。
- 与老接口功能上的区别在于，可以控制是否删除与磁盘关联的快照。
请求结构
POST /v{version}/volume/{volumeId} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
{
"autoSnapshot": "on",
"manualSnapshot": "on"
"recycle": "on"
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| volumeId | String | 是 | URL参数 | 待释放的磁盘ID |
| autoSnapshot | String | 否 | Request body参数 | 取值为"on"时，会删除磁盘关联的自动快照 |
| manualSnapshot | String | 否 | Request body参数 | 取值为"on"时，会删除磁盘关联的手动快照 |
| recycle | String | 否 | Request body参数 | 取值为"on"时，数据盘进入回收站。为空直接释放。默认为"off" |
返回头域
除公共头域，无其它特殊头域。
返回参数
无特殊返回参数
错误码
| 错误码 | 错误描述 | HTTP状态码 | 中文解释 |
|---|---|---|---|
| Volume.DiskStatusCannotBeDeleted | Volume in current status can not be deleted. | 409 | 磁盘当前状态不能被删除 |
| Volume.SystemDiskCannotBeDeleted | System disk can not be deleted. | 403 | 系统盘不能被删除 |
请求示例
POST /v2/volume/v-3zmCcxbR HTTP/1.1
Host: bcc.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"autoSnapshot": "on",
"manualSnapshot": "on"
"recycle": "on"
}返回示例
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS