所有文档

          云服务器 BCC

          释放CDS磁盘(新)

          描述

          • 该接口用于释放未挂载的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"
          }

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          volumeId String URL参数 待释放的磁盘ID
          autoSnapshot String Request body参数 取值为"on"时,会删除磁盘关联的自动快照
          manualSnapshot String Request body参数 取值为"on"时,会删除磁盘关联的手动快照

          返回头域

          除公共头域,无其它特殊头域。

          返回参数

          无特殊返回参数

          错误码

          错误码 错误描述 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"
          }

          返回示例

          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
          上一篇
          释放CDS磁盘
          下一篇
          磁盘扩容及类型变更