请求消息 请求参数如表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 用户愿意为竞价实例每小时支付的最高价格。如果overrides中没有提供价格，可以使用该价格。

请求示例 修改指定智能购买组信息，包括名称、算力保障计划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 }

响应示例 { "instances": [ { "id": "5bbcc3c4-1da2-4437-a48a-66f15b1b13f9", "name": "server1", "availability_zone_id": "az1", "flavor_id": "s3.large.2", "status": "ACTIVE", "sell_mode": "onDemand" } ], "page_info": { "next_marker": "616fb98f-46ca-475e-917e-2563e5a8cd19" } }

响应消息 响应参数如表3所示。 表3 响应参数 参数 参数类型 描述 instances Array of objects 实例列表，详情请参见表4。 page_info Object 页标记。 表4 instances参数信息 参数 参数类型 描述 name String 实例名称。 id String 实例ID。 availability_zone_id String 可用区ID。 flavor_id String 实例规格。 status String 实例状态。 sell_mode String 销售模型。 spot：竞价实例 onDemand：按需实例 表5 page_info参数信息 参数 参数类型 描述 next_marker String 返回下一页查询地址。

URI GET /v2/{domain_id}/auto-launch-groups/{auto_launch_group_id}/instances 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 domain_id 是 租户域ID。 auto_launch_group_id 是 智能购买组ID。 表2 查询参数 参数 是否必选 参数类型 描述 limit 否 Integer 查询返回实例的数量限制。 取值范围：1-1000。 marker 否 String 取值为上一页数据的最后一条记录的唯一标识。

响应示例 { "auto_launch_group": { "name": "test", "type": "maintain", "status": "ACTIVE", "task_state": "FULFILLED", "target_capacity": 10, "stable_capacity": 5, "current_capacity": 10, "current_stable_capacity": 5, "excess_fulfilled_capacity_behavior": "terminate", "instances_behavior_with_expiration": "terminate", "valid_since": "2022-11-04T15:58:13Z", "valid_until": "2022-11-06T15:58:13Z", "region_specs": [ { "region_id": "region1", "expect_target_capacity": 10, "expect_stable_capacity": 5, "launch_template_config": { "launch_template": { "launch_template_id": "c516c350-7091-4490-9338-47ddb90360f2", "version": "1.0" }, "overrides": [ { "availability_zone_id": "az1", "flavor_id": "s3.large.2", "spot_price": 2.0, "priority": 4, "weighted_capacity": 6 }, { "availability_zone_id": "az2", "flavor_id": "s3.large.2", "spot_price": 2.0, "priority": 4, "weighted_capacity": 12 } ] } } ], "allocation_strategy": "lowest_price", "spot_price": 0.5, "created_at": "2022-11-03T15:58:13Z" }}

响应消息 响应参数如表2所示。 表2 响应参数 参数 参数类型 描述 auto_launch_group Object 智能购买组详细信息，详情请参见表3。 表3 auto_launch_group参数信息 参数 参数类型 描述 name String 智能购买组名称。 type String 请求类型。 request：一次性。仅在启动时交付实例集群，调度失败后不再重试。 maintain：持续供应。在启动时尝试交付实例集群，并监控容量，未达到目标容量则尝试继续创建E CS 实例。 status string 智能购买组的运行状态。 SUBMITTED：已提交 ACTIVE：运行中 DELETING：删除中 DELETED：已删除 task_state string 智能购买组的任务状态。 HAN DLI NG：购买中 FULFILLED：智能购买组已满配 ERROR：智能购买组异常 target_capacity Integer 智能购买组目标容量。 实例数量或者CPU个数目标容量大于等于stable_capacity。竞价实例的容量为满配容量减去stable_capacity。 stable_capacity Integer 按需实例目标容量。 目标容量指实例数量或CPU个数，必须小于等于target_capacity，智能购买组中可以没有按需实例。 current_capacity Integer 当前已经购买成功的总算力。 current_stable_capacity Integer 当前已经购买成功的按需算力。 excess_fulfilled_capacity_behavior String 超过目标容量或目标容量减少时的实例中断行为。 terminate：释放 noTermination：不释放 instances_behavior_with_expiration String 请求到期时正在运行实例的中断行为。 terminate：释放 noTermination：不释放 valid_since String 请求开始时间，格式为yyyy-MM-ddTHH:mm:ssZ。 valid_until String 请求结束时间，格式为yyyy-MM-ddTHH:mm:ssZ。 region_specs Object 智能购买组在各个区域的配置，详情请参见表4。 allocation_strategy String 实例分配策略。 lowest_price：价格最低策略，智能购买组购买的所有实例的价格总和最低。 prioritized：优先级策略，按照规格设定的优先级创建实例。 capacity_optimized：容量最优化策略，智能购买组购买的实例按照大规格优先进行购买。 spot_price Double 用户愿意为竞价实例每小时支付的最高价格。如果overrides中没有提供价格，可以使用该价格。 created_at String 智能购买组创建时间。 表4 region_specs参数信息 参数 参数类型 描述 region_id String 区域ID。 expect_target_capacity Integer 区域内期望的总算力容量。 expect_stable_capacity Integer 区域内期望的稳定算力容量。 launch_template_config Object 启动模板配置，详情请参见表5。 表5 launch_template_config参数信息 参数 参数类型 描述 launch_template Object 实例的启动模板，详情请参见表6。 overrides Array of objects 实例的详细信息，详情请参见表7。 表6 launch_template参数信息 参数 参数类型 描述 launch_template_id String 实例的启动模板ID，唯一标识一个启动模板。 version String 启动模板版本号。 表7 override参数信息 参数 参数类型 描述 availability_zone_id String 可用区ID flavor_id String 实例规格ID spot_price Double 用户愿意为竞价实例每小时支付的最高价格。 priority Integer 优先级。数值越小，优先级越高，优先购买。 weighted_capacity Double 实例规格的权重。