更新时间：2025-11-17 GMT+08:00
批量扩容云硬盘 - BatchExtendVolume
功能介绍
对按需或者包周期云硬盘进行批量扩容。- - -
接口约束
扩容状态为available的云硬盘时，没有约束限制。
扩容状态为in-use的云硬盘时，有以下约束：
不支持共享云硬盘，即multiattach参数值必须为false。
云硬盘所挂载的云服务器状态必须为ACTIVE、PAUSED、SUSPENDED、SHUTOFF才支持扩容。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前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 |
错误码
请参见错误码。
