功能介绍
对按需或者包周期 云硬盘 进行扩容。 在扩容包周期云硬盘的场景下：
-
如果您需要查看订单可用的优惠券，请参考"查询订单可用优惠券"。
-
如果您需要查询订单的资源开通详情，请参考"查询订单的资源开通详情"。
-
如果您需要退订该包周期资源，请参考“退订包周期资源”。
-
扩容接口采用异步通知的方式实现。扩容完成时，不会修改云盘分区和文件系统，您需要在扩容后自行分配存储空间。
接口约束
-
扩容状态为available的云硬盘时，没有约束限制。
-
扩容状态为in-use的云硬盘时，有以下约束：
-
不支持共享云硬盘，即multiattach参数值必须为false。
-
云硬盘所挂载的 云服务器 状态必须为ACTIVE、PAUSED、SUSPENDED、SHUTOFF才支持扩容。
-
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v2.1/{project_id}/cloudvolumes/{volume_id}/action
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。获取方法请参见"获取项目ID"。 |
|
volume_id |
是 |
String |
云硬盘ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
bssParam |
否 |
按需和包周期的扩展参数。 |
|
|
os-extend |
是 |
标记扩容云硬盘操作。 |
响应参数
状态码： 202
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
job_id |
String |
任务ID，云硬盘为按需计费时返回该参数。> > > 如果需要查询job的状态，请参考："查询job的状态"。 |
|
order_id |
String |
订单ID，云硬盘为包周期计费时返回该参数。> > > - 如果您需要支付订单，请参考：。 |
状态码： 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error |
出现错误时，返回的错误信息，具体请参见 error参数说明。 |
请求示例
扩容云硬盘，扩容后的云硬盘大小为100GiB，立即支付扩容费用，且从帐户余额中自动扣费。
POST https://{endpoint}/v2.1/{project_id}/cloudvolumes/{volume_id}/action
{
"os-extend" : {
"new_size" : 100
},
"bssParam" : {
"isAutoPay" : "true"
}
}
响应示例
状态码： 202
Accepted
-
示例 1
{ "job_id" : "70a599e0-31e7-49b7-b260-868f441e862b" } -
示例 2
{ "order_id" : "CS1711152257C60TL" }
状态码： 400
Bad Request
{
"error" : {
"message" : "XXXX",
"code" : "XXX"
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
202 |
Accepted |
|
400 |
Bad Request |
错误码
请参见错误码。
