保留云硬盘（废弃）

功能介绍

保留云硬盘。

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

URI

• URI格式

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

• 参数说明

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

请求消息

• 请求参数

  参数	参数类型	是否必选	描述
  os-reserve	Object	是	标记保留云硬盘操作，本字段值不需填写，建议为空。

• 请求样例

  POST https://{endpoint}/v2/{project_id}/volumes/b104b8db-170d-441b-897a-3c8ba9c5a214/action
  {
      "os-reserve": {}
  }

响应消息

• 响应参数

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

• error参数说明

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

• 响应样例

  无

  或

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

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

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

状态码

• 正常

  202

错误码

请参考错误码。