文档首页/ 弹性云服务器 ECS/ API参考/ API/ 批量操作/ 批量变更弹性云服务器规格
更新时间:2025-09-09 GMT+08:00
分享

批量变更弹性云服务器规格

功能介绍

批量变更弹性云服务器规格。

本接口为异步接口,当前批量变更弹性云服务器规格请求下发成功后会返回job_id,此时批量变更弹性云服务器规格并没有立即完成,需要通过调用查询任务的执行状态查询job状态,当Job状态为 SUCCESS 时代表弹性云服务器规格批量变更成功。

接口约束

  • 最大支持批量变更50个弹性云服务器
  • 批量变更规格的弹性云服务器计费模式必须相同。
  • 包年/包月弹性云服务器不仅支持批量升配,还支持批量降配。
  • 批量变更规格的弹性云服务器仅支持可用区相同。
  • 批量变更规格的弹性云服务器原规格相同,目的规格相同。
  • 批量变更规格的弹性云服务器不支持专属主机下虚拟机变更规格。
  • 批量变更规格不支持竞价实例
  • 批量升配包年/包月云服务器规格时,暂不支持自动支付,系统会自动生成一个待支付订单,您可以手动在控制台上选择支付方式进行支付或参考"支付包年/包月产品订单"进行支付。
  • 收费公共镜像创建的包年/包月云服务器不支持批量变更规格,具体收费公共镜像类型请参考镜像的计费标准

调试

您可以在API Explorer中调试该接口。

URI

POST /v1/{project_id}/cloudservers/batch-resize

参数说明请参见表 参数说明
表1 参数说明

参数

是否必选

描述

project_id

项目ID。

获取方法请参见获取项目ID

请求消息

请求参数如表 请求参数所示。
表2 请求参数

参数

是否必选

参数类型

描述

resize

Array of objects

云服务器变更规格操作。详细请参见表 resize列表数据结构说明

表3 resize列表数据结构说明

参数

是否必选

参数类型

描述

flavorRef

String

变更后的云服务器规格ID。

servers

Array of objects

云服务器ID列表,详情请参见表 servers字段数据结构说明

mode

String

支持先关机后变更规格:

  • withStopServer表示先关机后变更规格。

cpu_options

Object

自定义CPU选项。

详情请参见表5

promotion

Object

折扣,详情请参见表6

表4 servers字段数据结构说明

参数

是否必选

参数类型

描述

id

String

云服务器ID。

表5 cpu_options数据结构说明

参数

是否必选

参数类型

描述

hw:cpu_threads

integer

参数解释:

用于控制CPU是否开启超线程。

约束限制:

需要同时满足如下条件,才能设置为“关闭超线程”:

  • 只能在实例创建或者resize时指定。
  • 只有目标flavor的extra_specs参数:
    • 存在“hw:cpu_policy”并取值为“dedicated”。
    • 存在“hw:cpu_threads”并取值为“2”。

取值范围:

  • 1: 关闭超线程。
  • 2: 打开超线程。

默认取值:

不涉及

表6 promotion字段数据结构说明

参数

是否必选

参数类型

描述

hw:cpu_threads

Integer

CPU超线程数,决定CPU是否开启超线程。

响应消息

请参考响应(任务类)

请求示例

批量变更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"
}

返回值

请参考通用请求返回值

错误码

请参考错误码

相关文档