创建智能购买组
1、不支持细粒度授权。 2、不支持包年/包月计费模式。 3、不支持对接QuotaManager,使用默认配置,单个租户最大支持创建30个智能购买组。 4、不支持创建IPv6实例。 5、不支持创建100ums云盘。 6、不支持网络driver_mode配置。 7、不支持创建时指定 云服务器 密码(可通过启动模板指定)。 8、租户创建的实例个数、CPU以及网络配额同租户自身配额保持一致。 9、不支持创建BMS实例。
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
|
X-Auth-Token
|
string | header | 是 |
用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) |
|
domain_id
|
string | path | 是 |
租户域ID |
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
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 RegionSpec objects | 是 |
智能购买组内各区域的资源描述 |
|
supply_option
|
string | 否 |
资源供给中规格选择策略:枚举值 singlation:选择一种规格供给 multiple:组合多种规格供给 默认值:multiple |
|
spot_price
|
double | 否 |
用户愿意为竞价实例每小时支付的最高价格。如果overrides中没有提供价格,可以使用该价格 |
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
region_id
|
string | 是 |
区域ID |
|
expect_target_capacity
|
integer | 是 |
区域内期望的总算力容量 |
|
expect_stable_capacity
|
integer | 是 |
区域内期望的稳定算力容量 |
|
launch_template_config
|
LaunchTemplateConfig object | 是 |
启动模板配置 |
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
launch_template
|
LaunchTemplateInfo object | 是 |
实例的启动模板 |
|
overrides
|
Array of OverrideInfo objects | 是 |
实例的详细信息 |
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
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 |
OK
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
auto_launch_group_id
|
string | 否 |
创建好的智能购买组 |
|
error_code
|
integer | 否 |
错误码。 请求失败时,响应体中包含错误。 请求成功时,不在响应消息体中包含错误码。 |
|
error_msg
|
string | 否 |
错误描述 请求失败时,响应体中包含错误 请求成功时,不在响应消息体中包含错误描述 |
创建智能购买组请求
OK
"auto_launch_group_id": "c516c350-7091-4490-9338-47ddb90360f2"
}
