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