# 查询智能购买组详情 - ShowAutoLaunchGroup #### 功能介绍 查询指定智能购买组的详细信息。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=CMS&api=ShowAutoLaunchGroup)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ecs/ecs_06_0000.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | ecs:launchTemplates:list | list | - | - | - | - | #### URI GET /v2/{domain_id}/auto-launch-groups/{auto_launch_group_id} 参数说明请参见[表1]。 表1参数说明 | 参数 | 是否必选 | 描述 | |:---|:---|:---| | domain_id | 是 | **参数解释** **：** 租户域ID。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | auto_launch_group_id | 是 | **参数解释** **：** 智能购买组ID。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 请求消息 无 #### 响应消息 响应参数如[表2]所示。 表2响应参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | auto_launch_group | Object | **参数解释** **：** 智能购买组详细信息，详情请参见[表3]。 **取值范围：** 不涉及 | 表3auto_launch_group参数信息 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释** **：** 智能购买组名称。 **取值范围：** 不涉及 | | type | String | **参数解释** **：** 请求类型。 **取值范围：** - request：一次性。仅在启动时交付实例集群，调度失败后不再重试。 - maintain：持续供应。在启动时尝试交付实例集群，并监控容量，未达到目标容量则尝试继续创建ECS实例。 | | status | string | **参数解释** **：** 智能购买组的运行状态。 **取值范围：** - SUBMITTED：已提交 - ACTIVE：运行中 - DELETING：删除中 - DELETED：已删除 | | task_state | string | **参数解释** **：** 智能购买组的任务状态。 **取值范围：** - HANDLING：购买中 - 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 | Array of objects | **参数解释** **：** 智能购买组在各个区域的配置，详情请参见[表4]。 **取值范围：** 不涉及 | | allocation_strategy | String | **参数解释** **：** 实例分配策略。 **取值范围：** - lowest_price：价格最低策略，智能购买组购买的所有实例的价格总和最低。 - prioritized：优先级策略，按照规格设定的优先级创建实例。 - capacity_optimized：容量最优化策略，智能购买组购买的实例按照大规格优先进行购买。 | | spot_price | Double | **参数解释** **：** 用户愿意为竞价实例每小时支付的最高价格。 **取值范围：** 不涉及 | | created_at | String | **参数解释** **：** 智能购买组创建时间。 **取值范围：** 不涉及 | 表4region_specs参数信息 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | region_id | String | **参数解释** **：** 区域ID。 **取值范围：** 不涉及 | | expect_target_capacity | Integer | **参数解释** **：** 区域内期望的总算力容量。 **取值范围：** 不涉及 | | expect_stable_capacity | Integer | **参数解释** **：** 区域内期望的稳定算力容量。 **取值范围：** 不涉及 | | launch_template_config | Object | **参数解释** **：** 启动模板配置，详情请参见[表5]。 **取值范围：** 不涉及 | 表5launch_template_config参数信息 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | launch_template | Object | **参数解释** **：** 实例的启动模板，详情请参见[表6]。 **取值范围：** 不涉及 | | overrides | Array of objects | **参数解释** **：** 实例的详细信息，详情请参见[表7]。 **取值范围：** 不涉及 | 表6launch_template参数信息 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | launch_template_id | String | **参数解释** **：** 实例的启动模板ID，唯一标识一个启动模板。 **取值范围：** 不涉及 | | version | String | **参数解释** **：** 启动模板版本号。 **取值范围：** 不涉及 | 表7override参数信息 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | availability_zone_id | String | **参数解释** **：** 可用区ID。 **取值范围：** 不涉及 | | flavor_id | String | **参数解释** **：** 实例规格ID。 **取值范围：** 不涉及 | | spot_price | Double | **参数解释** **：** 用户愿意为竞价实例每小时支付的最高价格。 **取值范围：** 不涉及 | | priority | Integer | **参数解释** **：** 优先级。数值越小，优先级越高，优先购买。 **取值范围：** 不涉及 | | weighted_capacity | Double | **参数解释** **：** 实例规格的权重。 **取值范围：** 不涉及 | #### 请求示例 查询指定的智能购买组详情信息。 ``` GET https://{endpoint}/v2/{domain_id}/auto-launch-groups/{auto_launch_group_id} ``` #### 响应示例 ``` { "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" } } ``` #### 返回值 请参考[通用请求返回值](https://support.huaweicloud.com/api-ecs/ecs_07_0001.html)。 #### 错误码 请参考[错误码](https://support.huaweicloud.com/api-ecs/ecs_07_0002.html)。