云服务器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磁盘
    下一篇
    磁盘扩容及类型变更