华为云计算 云知识 查询智能购买组详情ShowAutoLaunchGroup
查询智能购买组详情ShowAutoLaunchGroup

 

接口说明

查询指定智能购买组的详细信息

URL
GET  https://cms.myhuaweicloud.com/v2/{domain_id}/auto-launch-groups/{auto_launch_group_id} 
请求参数
名称 类型 IN 必选 描述
X-Auth-Token
 
string header

用户Token。

通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)

auto_launch_group_id
 
string path

智能购买组ID

domain_id
 
string path

租户域ID

返回参数
返回码: 200

OK

名称 类型 必选 描述
auto_launch_group
 
ShowAutoLaunchGroupResp object

智能购买组详细信息

200 auto_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 RegionSpec objects

智能购买组在各个区域的配置

allocation_strategy
 
string

实例分配策略,枚举值 lowest_price:价格最低策略,智能购买组购买的所有实例的价格总和最低。 prioritized:优先级策略,按照规格设定的优先级创建实例。 capacity_optimized:容量最优化策略,智能购买组购买的实例按照大规格优先进行购买。

spot_price
 
double

用户愿意为竞价实例每小时支付的最高价格。如果overrides中没有提供价格,可以使用该价格。

created_at
 
string

智能购买组创建时间

200 auto_launch_group.region_specs
名称 类型 必选 描述
region_id
 
string

区域ID

expect_target_capacity
 
integer

区域内期望的总算力容量

expect_stable_capacity
 
integer

区域内期望的稳定算力容量

launch_template_config
 
LaunchTemplateConfig object

启动模板配置

200 auto_launch_group.region_specs.launch_template_config
名称 类型 必选 描述
launch_template
 
LaunchTemplateInfo object

实例的启动模板

overrides
 
Array of OverrideInfo objects

实例的详细信息

200 auto_launch_group.region_specs.launch_template_config.launch_template
名称 类型 必选 描述
launch_template_id
 
string

实例的启动模板ID,唯一标识一个启动模板

version
 
string

启动模板版本号

200 auto_launch_group.region_specs.launch_template_config.overrides
名称 类型 必选 描述
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

请求示例
示例 1

查询智能购买组详情请求

 
"GET https://{endpoint}/v2/{domain_id}/auto-launch-groups/{auto_launch_group_id}"
返回示例
返回码:200

OK

示例 1
 
{
"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,
"priority": 4,
"weighted_capacity": 6
},
{
"availability_zone_id": "az2",
"flavor_id": "s3.large.2",
"spot_price": 2,
"priority": 4,
"weighted_capacity": 12
}
]
}
}
],
"allocation_strategy": "lowest_price",
"spot_price": 0.5,
"created_at": "2022-11-03T15:58:13Z"
}
}
SDK
点击 容量管理服务 (CMS) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明

 

上一篇:视频直播的应用场景 下一篇:停止弹性伸缩策略PauseScalingPolicy

华为云11.11

注册领万元上云礼券;2核云服务器21元起;限时储值返万元券;抽奖赢11111元免单礼券