批量扩容云硬盘
功能介绍
对按需或者包周期云硬盘进行批量扩容。在批量扩容存在包周期云硬盘的场景下：- 如果您需要查看订单可用的优惠券，请参考"查询订单可用优惠券"。- 如果您需要支付订单，请参考"支付包周期产品订单"。- 如果您需要退订该包周期资源，请参考“退订包周期资源”。
接口约束
-
扩容状态为available的云硬盘时，没有约束限制。
-
扩容状态为in-use的云硬盘时，有以下约束：
-
不支持共享云硬盘，即multiattach参数值必须为false。
-
云硬盘所挂载的云服务器状态必须为ACTIVE、PAUSED、SUSPENDED、SHUTOFF才支持扩容。
-
调用方法
请参见如何调用API。
URI
POST /v5/{project_id}/volumes/batch-extend
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。获取方法请参见"获取项目ID"。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
volumes |
是 |
Array of VolumesForBatchResizeVolume objects |
扩容云硬盘列表。 |
|
bss_param |
否 |
包周期的扩展参数。 |
响应参数
状态码：202
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
job_id |
String |
参数解释 任务ID，云硬盘为按需计费时返回该参数。 如果需要查询job的状态，请参考查询job的状态。 取值范围 不涉及。 |
|
order_id |
String |
参数解释 订单ID，云硬盘为包周期计费时返回该参数。 如果您需要支付订单，请参考："支付包周期产品订单"。 取值范围 不涉及。 |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释 出现错误时，返回的错误码。 取值范围 错误码和其对应的含义请参考错误码说明。 |
|
message |
String |
参数解释 出现错误时，返回的错误消息。 取值范围 不涉及。 |
请求示例
/v5/{project_id}/volumes/batch-extend
{
"volumes" : [ {
"id" : "756889eb-85ca-4ea5-9f07-df6b99ba1b0f",
"new_size" : 100
}, {
"id" : "36d9bbf7-8a93-4e47-8ff0-37b614aa28d6",
"new_size" : 200
} ],
"bss_param" : {
"is_auto_pay" : true
}
}
响应示例
状态码：202
Accepted
{
"job_id" : "c6bdaf8975f9478e87365b1474e8774b"
}
状态码：400
Bad Request
{
"error" : {
"message" : "XXXX",
"code" : "XXX"
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
202 |
Accepted |
|
400 |
Bad Request |
错误码
请参见错误码。
