更新时间:2025-09-18 GMT+08:00
        
          
          
        
      
      
      
      
      
      
      
      
  
      
      
      
        
批量变更弹性云服务器规格
功能介绍
批量变更弹性云服务器规格。
本接口为异步接口,当前批量变更弹性云服务器规格请求下发成功后会返回job_id,此时批量变更弹性云服务器规格并没有立即完成,需要通过调用查询任务的执行状态查询job状态,当Job状态为 SUCCESS 时代表弹性云服务器规格批量变更成功。
 
   华为云不再提供Windows操作系统类型的镜像,该接口不支持对Windows操作系统的弹性云服务器执行规格变更操作。
接口约束
- 最大支持批量变更50个弹性云服务器。
 
- 批量变更规格的弹性云服务器计费模式必须相同。
 
- 包年/包月弹性云服务器不仅支持批量升配,还支持批量降配。
 
- 批量变更规格的弹性云服务器仅支持可用区相同。
 
- 批量变更规格的弹性云服务器原规格相同,目的规格相同。
 
- 批量变更规格的弹性云服务器不支持专属主机下虚拟机变更规格。
 - 批量变更规格不支持竞价实例
 - 批量升配包年/包月云服务器规格时,暂不支持自动支付,系统会自动生成一个待支付订单,您可以手动在控制台上选择支付方式进行支付或参考"支付包年/包月产品订单"进行支付。
 - 收费公共镜像创建的包年/包月云服务器不支持批量变更规格,具体收费公共镜像类型请参考镜像的计费标准。
 
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"
			}
		]
	}
}
 响应示例
{
    "job_id": "ff80808288d415d80189901d8eb81cbb",
    "order_id": "CS18020810083A4GP"
}
 返回值
请参考通用请求返回值。
错误码
请参考错误码。
   父主题: 批量操作