華為云計(jì)算 云知識(shí) 查詢智能購(gòu)買(mǎi)組詳情ShowAutoLaunchGroup
查詢智能購(gòu)買(mǎi)組詳情ShowAutoLaunchGroup

 

接口說(shuō)明

查詢指定智能購(gòu)買(mǎi)組的詳細(xì)信息

URL
GET  https://cms.myhuaweicloud.com/v2/{domain_id}/auto-launch-groups/{auto_launch_group_id} 
請(qǐng)求參數(shù)
名稱 類型 IN 必選 描述
X-Auth-Token
 
string header

用戶Token。

通過(guò)調(diào)用 IAM 服務(wù)獲取用戶Token接口獲取(響應(yīng)消息頭中X-Subject-Token的值)

auto_launch_group_id
 
string path

智能購(gòu)買(mǎi)組ID

domain_id
 
string path

租戶域ID

返回參數(shù)
返回碼: 200

OK

名稱 類型 必選 描述
auto_launch_group
 
ShowAutoLaunchGroupResp object

智能購(gòu)買(mǎi)組詳細(xì)信息

200 auto_launch_group
名稱 類型 必選 描述
name
 
string

智能購(gòu)買(mǎi)組名稱

type
 
string

請(qǐng)求類型。枚舉值 request:一次性。僅在啟動(dòng)時(shí)交付實(shí)例集群,調(diào)度失敗后不再重試。 maintain:持續(xù)供應(yīng)。在啟動(dòng)時(shí)嘗試交付實(shí)例集群,并監(jiān)控實(shí)時(shí)容量,未達(dá)到目標(biāo)容量則嘗試?yán)^續(xù)創(chuàng)建ECS實(shí)例

status
 
string

智能購(gòu)買(mǎi)組的運(yùn)行狀態(tài),枚舉值 SUBMITTED:已提交 ACTIVE:運(yùn)行中 DELETING:刪除中 DELETED:已刪除

task_state
 
string

智能購(gòu)買(mǎi)組的任務(wù)狀態(tài),枚舉值 HANDLING:購(gòu)買(mǎi)中 FULFILLED:智能購(gòu)買(mǎi)組已滿配 ERROR:智能購(gòu)買(mǎi)組異常

target_capacity
 
integer

智能購(gòu)買(mǎi)組目標(biāo)容量. 實(shí)例數(shù)量或者CPU個(gè)數(shù),目標(biāo)容量大于等于stable_capacity。競(jìng)價(jià)實(shí)例的容量為滿配容量減去stable_capacity

stable_capacity
 
integer

按需實(shí)例目標(biāo)容量 目標(biāo)容量指實(shí)例數(shù)量或CPU個(gè)數(shù),必須小于等于target_capacity,智能購(gòu)買(mǎi)組中可以沒(méi)有按需實(shí)例

current_capacity
 
integer

當(dāng)前已經(jīng)購(gòu)買(mǎi)成功的總算力

current_stable_capacity
 
integer

當(dāng)前已經(jīng)購(gòu)買(mǎi)成功的按需算力

excess_fulfilled_capacity_behavior
 
string

超過(guò)目標(biāo)容量或目標(biāo)容量減少時(shí)的實(shí)例中斷行為,枚舉值 terminate:釋放 noTermination:不釋放

instances_behavior_with_expiration
 
string

請(qǐng)求到期時(shí)的實(shí)例中斷行為,枚舉值 terminate:釋放 noTermination:不釋放

valid_since
 
string

請(qǐng)求開(kāi)始時(shí)間,格式為yyyy-MM-ddTHH:mm:ssZ

valid_until
 
string

請(qǐng)求結(jié)束時(shí)間,格式為yyyy-MM-ddTHH:mm:ssZ

region_specs
 
Array of RegionSpec objects

智能購(gòu)買(mǎi)組在各個(gè)區(qū)域的配置

allocation_strategy
 
string

實(shí)例分配策略,枚舉值 lowest_price:價(jià)格最低策略,智能購(gòu)買(mǎi)組購(gòu)買(mǎi)的所有實(shí)例的價(jià)格總和最低。 prioritized:優(yōu)先級(jí)策略,按照規(guī)格設(shè)定的優(yōu)先級(jí)創(chuàng)建實(shí)例。 capacity_optimized:容量最優(yōu)化策略,智能購(gòu)買(mǎi)組購(gòu)買(mǎi)的實(shí)例按照大規(guī)格優(yōu)先進(jìn)行購(gòu)買(mǎi)。

spot_price
 
double

用戶愿意為競(jìng)價(jià)實(shí)例每小時(shí)支付的最高價(jià)格。如果overrides中沒(méi)有提供價(jià)格,可以使用該價(jià)格。

created_at
 
string

智能購(gòu)買(mǎi)組創(chuàng)建時(shí)間

200 auto_launch_group.region_specs
名稱 類型 必選 描述
region_id
 
string

區(qū)域ID

expect_target_capacity
 
integer

區(qū)域內(nèi)期望的總算力容量

expect_stable_capacity
 
integer

區(qū)域內(nèi)期望的穩(wěn)定算力容量

launch_template_config
 
LaunchTemplateConfig object

啟動(dòng)模板配置

200 auto_launch_group.region_specs.launch_template_config
名稱 類型 必選 描述
launch_template
 
LaunchTemplateInfo object

實(shí)例的啟動(dòng)模板

overrides
 
Array of OverrideInfo objects

實(shí)例的詳細(xì)信息

200 auto_launch_group.region_specs.launch_template_config.launch_template
名稱 類型 必選 描述
launch_template_id
 
string

實(shí)例的啟動(dòng)模板ID,唯一標(biāo)識(shí)一個(gè)啟動(dòng)模板

version
 
string

啟動(dòng)模板版本號(hào)

200 auto_launch_group.region_specs.launch_template_config.overrides
名稱 類型 必選 描述
availability_zone_id
 
string

可用區(qū)ID

flavor_id
 
string

實(shí)例規(guī)格ID

spot_price
 
double

用戶愿意為競(jìng)價(jià)實(shí)例每小時(shí)支付的最高價(jià)格

priority
 
integer

優(yōu)先級(jí)。數(shù)值越小,優(yōu)先級(jí)越高,優(yōu)先購(gòu)買(mǎi)。 取值范圍:0到Integer.MAX_VALUE 默認(rèn)值是Integer.MAX_VALUE

weighted_capacity
 
double

實(shí)例規(guī)格的權(quán)重。取值越高,單臺(tái)實(shí)例滿足計(jì)算力需求的能力越大,所需的實(shí)例數(shù)量越小。 取值范圍:大于0 可以根據(jù)指定實(shí)例規(guī)格的計(jì)算力和集群?jiǎn)喂?jié)點(diǎn)最低計(jì)算力得出權(quán)重值。 假設(shè)單節(jié)點(diǎn)最低計(jì)算力為8vcpu、60GB,則8vcpu、60GB的實(shí)例規(guī)格權(quán)重可設(shè)置為1,16vcpu、120GB的實(shí)例規(guī)格權(quán)重可設(shè)置為2

請(qǐng)求示例
示例 1

查詢智能購(gòu)買(mǎi)組詳情請(qǐng)求

 
"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
點(diǎn)擊 容量管理服務(wù) (CMS) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認(rèn)證方式等在SDK文檔中對(duì)應(yīng)語(yǔ)言類型的【使用】目錄下。
錯(cuò)誤碼
請(qǐng)參考 錯(cuò)誤碼說(shuō)明。