释放CDS磁盘(新)
所有文档
menu

云服务器 BCC

释放CDS磁盘(新)

该接口用于释放未挂载的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
上一篇
卸载CDS磁盘
下一篇
磁盘扩容及类型变更