查询智能购买组详情 - ShowAutoLaunchGroup
功能介绍
查询指定智能购买组的详细信息。
调试
您可以在API Explorer中调试该接口。
授权信息
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| ecs:launchTemplates:list | list | - | - | - | - |
请求消息
无
响应消息
响应参数如表2所示。
| 参数 | 参数类型 | 描述 |
|---|---|---|
| name | String | 参数解释: 智能购买组名称。 取值范围: 不涉及 |
| type | String | 参数解释: 请求类型。 取值范围:
|
| status | string | 参数解释: 智能购买组的运行状态。 取值范围:
|
| task_state | string | 参数解释: 智能购买组的任务状态。 取值范围:
|
| 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 | 参数解释: 超过目标容量或目标容量减少时的实例中断行为。 取值范围:
|
| instances_behavior_with_expiration | String | 参数解释: 请求到期时正在运行实例的中断行为。 取值范围:
|
| valid_since | String | 参数解释: 请求开始时间,格式为yyyy-MM-ddTHH:mm:ssZ。 取值范围: 不涉及 |
| valid_until | String | 参数解释: 请求结束时间,格式为yyyy-MM-ddTHH:mm:ssZ。 取值范围: 不涉及 |
| region_specs | Object | 参数解释: 智能购买组在各个区域的配置,详情请参见表4。 取值范围: 不涉及 |
| allocation_strategy | String | 参数解释: 实例分配策略。 取值范围:
|
| spot_price | Double | 参数解释: 用户愿意为竞价实例每小时支付的最高价格。 取值范围: 不涉及 |
| created_at | String | 参数解释: 智能购买组创建时间。 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| region_id | String | 参数解释: 区域ID。 取值范围: 不涉及 |
| expect_target_capacity | Integer | 参数解释: 区域内期望的总算力容量。 取值范围: 不涉及 |
| expect_stable_capacity | Integer | 参数解释: 区域内期望的稳定算力容量。 取值范围: 不涉及 |
| launch_template_config | Object | 参数解释: 启动模板配置,详情请参见表5。 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| launch_template | Object | 参数解释: 实例的启动模板,详情请参见表6。 取值范围: 不涉及 |
| overrides | Array of objects | 参数解释: 实例的详细信息,详情请参见表7。 取值范围: 不涉及 |
请求示例
查询指定的智能购买组详情信息。
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"
}
} 返回值
请参考通用请求返回值。
错误码
请参考错误码。