扩容云硬盘(废弃)
功能介绍
扩容一个云硬盘
扩容状态为available的云硬盘时,没有约束限制。
扩容接口采用异步的方式,实际扩容结果请在虚拟机中确认。
由于兼容性原因导致存在该接口,目前已经废弃。
接口约束
扩容状态为in-use的云硬盘时,有以下约束:
不支持共享云硬盘,即multiattach参数值必须为false。
云硬盘所挂载的云服务器状态必须为ACTIVE、PAUSED、SUSPENDED、SHUTOFF才支持扩容。
调用方法
请参见如何调用API。
URI
POST /v2/{project_id}/cloudvolumes/{volume_id}/action
| 
         参数  | 
       
         是否必选  | 
       
         参数类型  | 
       
         描述  | 
      
|---|---|---|---|
| 
         project_id  | 
       
         是  | 
       
         String  | 
       
         项目ID  | 
      
| 
         volume_id  | 
       
         是  | 
       
         String  | 
       
         云硬盘ID  | 
      
请求参数
| 
         参数  | 
       
         是否必选  | 
       
         参数类型  | 
       
         描述  | 
      
|---|---|---|---|
| 
         X-Auth-Token  | 
       
         是  | 
       
         String  | 
       
         Token的有效期为24小时,需要使用一个Token鉴权时,可以先缓存起来,避免频繁调用。  | 
      
| 
         参数  | 
       
         是否必选  | 
       
         参数类型  | 
       
         描述  | 
      
|---|---|---|---|
| 
         os-extend  | 
       
         是  | 
       
         ResizeDiskOption object  | 
       
         标记扩容云硬盘操作  | 
      
响应参数
状态码:200
| 
         参数  | 
       
         参数类型  | 
       
         描述  | 
      
|---|---|---|
| 
         job_id  | 
       
         String  | 
       
         参数解释 正常返回时返回的任务ID。 如果需要查询job的状态,请参考查询job的状态。 取值范围 不涉及。  | 
      
状态码:400
| 
         参数  | 
       
         参数类型  | 
       
         描述  | 
      
|---|---|---|
| 
         code  | 
       
         String  | 
       
         参数解释 出现错误时,返回的错误码。 取值范围 错误码和其对应的含义请参考错误码说明。  | 
      
| 
         message  | 
       
         String  | 
       
         参数解释 出现错误时,返回的错误消息。 取值范围 不涉及。  | 
      
请求示例
{
  "os-extend" : {
    "new_size" : 200
  }
}
  响应示例
状态码:200
OK
{
  "job_id" : "70a599e0-31e7-49b7-b260-868f441e862b"
}
   状态码:400
Bad Request
{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}
  状态码
| 
         状态码  | 
       
         描述  | 
      
|---|---|
| 
         200  | 
       
         OK  | 
      
| 
         400  | 
       
         Bad Request  | 
      
错误码
请参见错误码。