卸载云硬盘（废弃）

功能介绍

该接口只会改变云硬盘的状态（“in-use”变为“available”）

由于兼容性原因导致存在该接口，目前已经废弃。

接口约束

卸载云硬盘的操作不能调用该接口，只能调用ECS的Detach Volume接口。

URI

• URI格式

  POST /v2/{project_id}/volumes/{volume_id}/action

• 参数说明

  参数	是否必选	描述
  project_id	是	项目ID。 获取方法请参见获取项目ID。
  volume_id	是	云硬盘ID。

请求消息

• 请求参数

  参数	参数类型	是否必选	描述
  os-detach	Object	是	标记卸载云硬盘操作。

• os-detach参数说明

  参数	参数类型	是否必选	描述
  attachment_id	String	否	挂载ID。如果卷只有一个挂载点，那该参数是可选的，如果卷有多个挂载点，那么该参数是必选的。

• 请求样例

  POST https://{endpoint}/v2/{project_id}/volumes/b104b8db-170d-441b-897a-3c8ba9c5a214/action
  {
      "os-detach": {
          "attachment_id": "d8777f54-84cf-4809-a679-468ffed56cf1"
      }
  }

响应消息

• 响应参数

  参数	参数类型	描述
  error	Object	出现错误时，返回的错误信息，具体请参见 error参数说明。

• error参数说明

  参数	参数类型	描述
  message	String	出现错误时，返回的错误消息。
  code	String	出现错误时，返回的错误码。 错误码和其对应的含义请参考错误码。

• 响应样例

  无

  或

  {
      "error": {
          "message": "XXXX", 
          "code": "XXX"
      }
  }

  其中error是泛指的错误，有badRequest、itemNotFound等，如报错：

  {
      "itemNotFound": {
          "message": "XXXX", 
          "code": "XXX"
      }
  }

状态码

• 正常

  202

错误码

请参考错误码。