创建智能购买组 - CreateAutoLaunchGroup

name

是

String

参数解释：

智能购买组名称。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

dry_run

否

Boolean

参数解释：

是否预检此次请求。配置为预检时，此次请求不会创建智能购买组。

约束限制：

不涉及

取值范围：

• true：预检此次请求，检查项包括是否填写了必需参数、请求格式等。
  • 如果检查不通过，则返回对应错误。
  • 如果检查通过，则返回202状态码。
• false：发送正常请求，不对请求体做预检。

默认取值：

不涉及

type

否

String

参数解释：

请求类型。

约束限制：

不涉及

取值范围：

• request：一次性。仅在启动时交付实例集群，调度失败后不再重试。
• maintain：持续供应。在启动时尝试交付实例集群，并监控容量，未达到目标容量则尝试继续创建ECS实例。

默认取值：

maintain

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

valid_since

否

String

参数解释：

请求开始时间，和valid_until共同确定有效时段。

约束限制：

不涉及

取值范围：

按照ISO8601标准表示，并使用UTC +0时间，格式为yyyy-MM-ddTHH:mm:ssZ。

立即生效。

默认取值：

不涉及

valid_until

否

String

参数解释：

请求结束时间，和valid_since共同确定有效时段。

约束限制：

不涉及

取值范围：

按照ISO8601标准表示，并使用UTC +0时间，格式为yyyy-MM-ddTHH:mm:ssZ。

无限期。

默认取值：

不涉及

allocation_strategy

否

String

参数解释：

实例分配策略。

约束限制：

不涉及

取值范围：

• lowest_price：价格最低策略，智能购买组购买的所有实例的价格总和最低。
• prioritized：优先级策略，按照规格设定的优先级创建实例。
• capacity_optimized：容量最优化策略，智能购买组购买的实例按照大规格优先进行购买。

默认取值：

lowest_price

region_specs

是

Array of objects

参数解释：

智能购买组内各区域的资源描述，详情请参见表3。

supply_option

否

String

参数解释：

资源供给中规格选择策略。

约束限制：

不涉及

取值范围：

• singlation：选择一种规格供给。
• multiple：组合多种规格供给。

默认取值：

不涉及

spot_price

否

Double

参数解释：

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

约束限制：

如果overrides中没有提供价格，可以使用该价格。

取值范围：

不涉及

默认取值：

不涉及

region_id

是

String

参数解释：

区域ID。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

expect_target_capacity

是

Integer

参数解释：

区域内期望的总算力容量。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

expect_stable_capacity

是

Integer

参数解释：

区域内期望的稳定算力容量。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

launch_template_config

是

Object

参数解释：

启动模板配置，详情请参见表4。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

launch_template

是

Object

参数解释：

实例的启动模板，详情请参见表5。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

overrides

是

Array of objects

参数解释：

实例的详细信息，详情请参见表6。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

launch_template_id

是

String

参数解释：

实例的启动模板ID，唯一标识一个启动模板。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

version

是

String

参数解释：

启动模板版本号。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

availability_zone_id

是

String

参数解释：

可用区ID。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

flavor_id

是

String

参数解释：

实例规格ID。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

spot_price

否

Double

参数解释：

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

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

priority

否

Integer

参数解释：

优先级。数值越小，优先级越高，优先购买。

约束限制：

不涉及

取值范围：

0到Integer.MAX_VALUE

默认取值：

Integer.MAX_VALUE

weighted_capacity

否

Double

参数解释：

实例规格的权重。取值越高，单台实例满足计算力需求的能力越大，所需的实例数量越小。

可以根据指定实例规格的计算力和集群单节点最低计算力得出权重值。

假设单节点最低计算力为8vCPU、60GiB，则8vCPU、60GiB实例规格的权重可设置为1，16vCPU、120GiB实例规格的权重可设置为2。

约束限制：

不涉及

取值范围：

大于0

默认取值：

不涉及

auto_launch_group_id

String

参数解释：

创建的智能购买组。

取值范围：

不涉及

error_code

Integer

参数解释：

错误码。

error_msg

String

参数解释：

错误描述。