文档首页/弹性云服务器 ECS/API参考/API/智能购买组管理/修改智能购买组 - UpdateAutoLaunchGroup
更新时间:2026-03-19 GMT+08:00
分享

修改智能购买组 - UpdateAutoLaunchGroup

功能介绍

更新指定智能购买组信息。

调试

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

URI

PUT /v2/{domain_id}/auto-launch-groups/{auto_launch_group_id}

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

参数

是否必选

描述

domain_id

参数解释:

租户域ID。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

auto_launch_group_id

参数解释:

智能购买组ID。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求消息

请求参数如表2所示。

表2 请求参数

参数

是否必选

参数类型

描述

name

String

参数解释:

智能购买组名称。

约束限制:

不涉及

取值范围:

1-64个字符,只能包含中文、字母、数字、下划线和中划线。

默认取值:

不涉及

guarantee_plan_id

String

参数解释:

算力保障计划ID。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

target_capacity

Integer

参数解释:

智能购买组目标容量。

约束限制:

不涉及

取值范围:

实例数量或者CPU个数目标容量大于等于stable_capacity。竞价实例的容量为满配容量减去stable_capacity。

默认取值:

不涉及

stable_capacity

Integer

参数解释:

按需实例目标容量。

约束限制:

目标容量指实例数量或CPU个数,必须小于等于target_capacity,智能购买组中可以没有按需实例。

取值范围:

不涉及

默认取值:

不涉及

excess_fulfilled_capacity_behavior

String

参数解释:

超过目标容量或目标容量减少时的实例中断行为。

约束限制:

不涉及

取值范围:

  • terminate:释放
  • noTermination:不释放

默认取值:

terminate

instances_behavior_with_expiration

String

参数解释:

请求到期时正在运行实例的中断行为。

约束限制:

不涉及

取值范围:

  • terminate:释放
  • noTermination:不释放

默认取值:

terminate

spot_price

Double

参数解释:

用户愿意为竞价实例每小时支付的最高价格。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应消息

表3 响应参数

参数

参数类型

描述

error_code

Integer

参数解释:

错误码。

取值范围:

不涉及

error_msg

String

参数解释:

错误描述。

取值范围:

不涉及

请求示例

修改指定智能购买组信息,包括名称、算力保障计划ID、目标容量、按需实例目标容量等。

PUT https://{endpoint}/v2/{domain_id}/auto_launch_groups/{auto_launch_group_id}

{
    "name": "autoLaunchGroup1",
    "guarantee_plan_id": "plan_id",
    "target_capacity": 10,
    "stable_capacity": 5,
    "excess_fulfilled_capacity_behavior": "terminate",
    "instances_behavior_with_expiration": "terminate",
    "spot_price": 0.5
}

响应示例

返回值

请参考通用请求返回值

错误码

请参考错误码

相关文档