name

是

String

智能购买组名称。

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

dry_run

否

Boolean

创建智能购买组参数核查。

• true：发送检查请求，不会创建智能购买组。检查项包括是否填写了必需参数、请求格式等。
  • 如果检查不通过，则返回对应错误。
  • 如果检查通过，则返回202状态码。
• false：发送正常请求，通过检查后并且执行创建智能购买组请求。

type

否

String

请求类型。

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

默认值：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

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

取值范围：大于0

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

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