文档首页/ 云硬盘 EVS/ API参考/ API/ 云硬盘管理/ 扩容云硬盘(废弃)
更新时间：2024-12-11 GMT+08:00
在线调试
CLI示例
查看PDF
分享

扩容云硬盘(废弃)

功能介绍

扩容一个云硬盘

扩容状态为available的云硬盘时，没有约束限制。

扩容接口采用异步的方式，实际扩容结果请在虚拟机中确认。

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

接口约束

扩容状态为in-use的云硬盘时，有以下约束：

不支持共享云硬盘，即multiattach参数值必须为false。

云硬盘所挂载的云服务器状态必须为ACTIVE、PAUSED、SUSPENDED、SHUTOFF才支持扩容。

调用方法

请参见如何调用API。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

volume_id

是

String

云硬盘ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。
表3 请求Body参数

参数

是否必选

参数类型

描述

os-extend

是

ResizeDiskOption object

标记扩容云硬盘操作
表4 ResizeDiskOption

参数

是否必选

参数类型

描述

new_size

是

Integer

扩容后的云硬盘容量，单位为GiB。扩容后的容量不能小于原有云硬盘容量，且不能大于云硬盘最大容量。

云硬盘最大容量：

  • 数据盘：32768GiB

  • 系统盘：1024GiB

响应参数

状态码： 200

表5 响应Body参数

参数

参数类型

描述

job_id

String

正常返回时返回的任务ID。

说明：

如果需要查询job的状态，请参考查询job的状态。

状态码： 400

表6 响应Body参数

参数

参数类型

描述

error

Error object

出现错误时，返回的错误码。错误码和其对应的含义请参考错误码说明。
表7 Error

参数

参数类型

描述

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

错误码

请参见错误码。

父主题： 云硬盘管理

相关文档