華為云計(jì)算 云知識(shí) 創(chuàng)建智能購(gòu)買組CreateAutoLaunchGroup
創(chuàng)建智能購(gòu)買組CreateAutoLaunchGroup

 

接口說(shuō)明

創(chuàng)建智能購(gòu)買組

約束說(shuō)明

1、不支持細(xì)粒度授權(quán)。 2、不支持包年/包月計(jì)費(fèi)模式。 3、不支持對(duì)接QuotaManager,使用默認(rèn)配置,單個(gè)租戶最大支持創(chuàng)建30個(gè)智能購(gòu)買組。 4、不支持創(chuàng)建IPv6實(shí)例。 5、不支持創(chuàng)建100ums云盤。 6、不支持網(wǎng)絡(luò)driver_mode配置。 7、不支持創(chuàng)建時(shí)指定 云服務(wù)器 密碼(可通過(guò)啟動(dòng)模板指定)。 8、租戶創(chuàng)建的實(shí)例個(gè)數(shù)、CPU以及網(wǎng)絡(luò)配額同租戶自身配額保持一致。 9、不支持創(chuàng)建BMS實(shí)例。

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

用戶Token。

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

domain_id
 
string path

租戶域ID

Body參數(shù)
名稱 類型 必選 描述
name
 
string

智能購(gòu)買組名稱。 取值范圍:1-64個(gè)字符,只能包含中文、字母、數(shù)字、下劃線和中劃線。

dry_run
 
boolean

創(chuàng)建智能購(gòu)買組參數(shù)核查 true:發(fā)送檢查請(qǐng)求,不會(huì)創(chuàng)建智能購(gòu)買組。檢查項(xiàng)包括是否填寫了必需參數(shù)、請(qǐng)求格式等。 如果檢查不通過(guò),則返回對(duì)應(yīng)錯(cuò)誤。 如果檢查通過(guò),則返回202狀態(tài)碼。 false:發(fā)送正常請(qǐng)求,通過(guò)檢查后并且執(zhí)行創(chuàng)建智能購(gòu)買組請(qǐng)求。

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í)例。 默認(rèn)值:maintain

guarantee_plan_id
 
string

算力保障計(jì)劃ID

target_capacity
 
integer

智能購(gòu)買組目標(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)買組中可以沒有按需實(shí)例。

excess_fulfilled_capacity_behavior
 
string

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

instances_behavior_with_expiration
 
string

請(qǐng)求到期正在的實(shí)例中斷行為,枚舉值 terminate:釋放 noTermination:不釋放 默認(rèn)值:terminate

valid_since
 
string

請(qǐng)求開始時(shí)間,和valid_until共同確定有效時(shí)段。 按照ISO8601標(biāo)準(zhǔn)表示,并使用UTC +0時(shí)間,格式為yyyy-MM-ddTHH:mm:ssZ。 默認(rèn)值:立即生效

valid_until
 
string

請(qǐng)求結(jié)束時(shí)間,和valid_since共同確定有效時(shí)段。 按照ISO8601標(biāo)準(zhǔn)表示,并使用UTC +0時(shí)間,格式為yyyy-MM-ddTHH:mm:ssZ。 默認(rèn)值:無(wú)限期

allocation_strategy
 
string

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

region_specs
 
Array of RegionSpec objects

智能購(gòu)買組內(nèi)各區(qū)域的資源描述

supply_option
 
string

資源供給中規(guī)格選擇策略:枚舉值 singlation:選擇一種規(guī)格供給 multiple:組合多種規(guī)格供給 默認(rèn)值:multiple

spot_price
 
double

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

參數(shù):
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)模板配置

參數(shù):
region_specs.launch_template_config
名稱 類型 必選 描述
launch_template
 
LaunchTemplateInfo object

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

overrides
 
Array of OverrideInfo objects

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

參數(shù):
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)

參數(shù):
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)買。 取值范圍: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

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

OK

名稱 類型 必選 描述
auto_launch_group_id
 
string

創(chuàng)建好的智能購(gòu)買組

error_code
 
integer

錯(cuò)誤碼。 請(qǐng)求失敗時(shí),響應(yīng)體中包含錯(cuò)誤。 請(qǐng)求成功時(shí),不在響應(yīng)消息體中包含錯(cuò)誤碼。

error_msg
 
string

錯(cuò)誤描述 請(qǐng)求失敗時(shí),響應(yīng)體中包含錯(cuò)誤 請(qǐng)求成功時(shí),不在響應(yīng)消息體中包含錯(cuò)誤描述

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

創(chuàng)建智能購(gòu)買組請(qǐng)求

 
"POST https://{endpoint}/v2/{domain_id}/auto-launch-groups"
 
{ "name": "test", "guarantee_plan_id": "plan_id", "type": "maintain", "target_capacity": 10, "stable_capacity": 5, "excess_fulfilled_capacity_behavior": "terminate", "instances_behavior_with_expiration": "terminate", "valid_since": "2020-04-04T15:58:13Z", "valid_until": "2021-04-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 }, { "availability_zone_id": "az3", "flavor_id": "s3.large.2", "spot_price": 2, "priority": 4, "weighted_capacity": 2 } ] } } ], "allocation_strategy": "lowest_price", "spot_price": 0.5, "supply_option": "multiple", "dry_run": false }
返回示例
返回碼:200

OK

示例 1
 
{
"auto_launch_group_id": "c516c350-7091-4490-9338-47ddb90360f2"
}
SDK
點(diǎn)擊 容量管理服務(wù) (CMS) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認(rèn)證方式等在SDK文檔中對(duì)應(yīng)語(yǔ)言類型的【使用】目錄下。
錯(cuò)誤碼
請(qǐng)參考 錯(cuò)誤碼說(shuō)明。