批量变更弹性云服务器规格
功能介绍
批量变更弹性云服务器规格。
本接口为异步接口,当前批量变更弹性云服务器规格请求下发成功后会返回job_id,此时批量变更弹性云服务器规格并没有立即完成,需要通过调用查询任务的执行状态查询job状态,当Job状态为 SUCCESS 时代表弹性云服务器规格批量变更成功。
接口约束
- 最大支持批量变更50个弹性云服务器。
- 批量变更规格的弹性云服务器计费模式必须相同。
- 包年/包月弹性云服务器不仅支持批量升配,还支持批量降配。
- 批量变更规格的弹性云服务器仅支持可用区相同。
- 批量变更规格的弹性云服务器原规格相同,目的规格相同。
- 批量变更规格的弹性云服务器不支持专属主机下虚拟机变更规格。
- 批量变更规格不支持竞价实例
- 批量升配包年/包月云服务器规格时,暂不支持自动支付,系统会自动生成一个待支付订单,您可以手动在控制台上选择支付方式进行支付或参考"支付包年/包月产品订单"进行支付。
- 收费公共镜像创建的包年/包月云服务器不支持批量变更规格,具体收费公共镜像类型请参考镜像的计费标准。
调试
您可以在API Explorer中调试该接口。
URI
POST /v1/{project_id}/cloudservers/batch-resize
请求消息
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
flavorRef |
是 |
String |
变更后的云服务器规格ID。 |
servers |
是 |
Array of objects |
云服务器ID列表,详情请参见表 servers字段数据结构说明。 |
mode |
否 |
String |
支持先关机后变更规格:
|
cpu_options |
否 |
Object |
自定义CPU选项。 详情请参见表5。 |
promotion |
是 |
Object |
折扣,详情请参见表6。 |
响应消息
请参考响应(任务类)。
请求示例
批量变更2台云服务器的规格为“s3.small.1”。
POST https://{endpoint}/v1/{project_id}/cloudservers/batch-resize { "resize": { "flavorRef": "s3.small.1", "servers": [ { "id": "98ce4563-3e06-414f-899b-6ba6eaa41c1d" }, { "id": "aacc5bf0-49c4-4720-a406-1751d8010e7f" } ] } }
响应示例
{ "order_id": "CS1711152257C60TL", "job_id": "ff80808288d415d80189901d8eb81cbb" }
返回值
请参考通用请求返回值。
错误码
请参考错误码。