释放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