華為云計算 云知識 地域推薦ListSupplyRecommendation
地域推薦ListSupplyRecommendation

 

接口說明

對ECS的資源供給的地域和規(guī)格進行推薦,推薦結(jié)果以打分的形式呈現(xiàn),分數(shù)越高推薦程度越高

URL
POST  https://cms.myhuaweicloud.com/v1/{domain_id}/recommendations/ecs-supply 
請求參數(shù)
名稱 類型 IN 必選 描述
X-Auth-Token
 
string header

用戶Token。

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

domain_id
 
string path

租戶域ID

Body參數(shù)
名稱 類型 必選 描述
flavor_constraint
 
FlavorConstraint object

資源供給規(guī)格的約束,給出規(guī)格列表時優(yōu)先使用規(guī)格列表

flavor_ids
 
Array of strings

接受推薦的規(guī)格列表

locations
 
Array of DistinctLocation objects

接受推薦的地域列表,默認接受所有區(qū)域

option
 
SupplyOption object

供給推薦的選項

strategy
 
string

推薦的策略。 CAPACITY:容量策略 COST:成本策略

limit
 
integer

查詢返回的數(shù)量限制

marker
 
string

取值為上一頁數(shù)據(jù)的最后一條記錄的唯一標記

參數(shù):
flavor_constraint
名稱 類型 必選 描述
architecture_type
 
Array of strings

接受的體系結(jié)構(gòu)描述

flavor_requirements
 
Array of FlavorRequirement objects

資源的需求約束

參數(shù):
flavor_constraint.flavor_requirements
名稱 類型 必選 描述
vcpu_count
 
IntegerRange object

規(guī)格的vcpu數(shù)量范圍,不填表示接受所有

memory_mb
 
IntegerRange object

規(guī)格的內(nèi)存大小范圍,單位是MiB,不填表示接受所有

cpu_manufacturers
 
Array of strings

可選CPU制造商,不填表示接受所有

memory_gb_per_vcpu
 
DoubleRange object

Flavor的單vcpu對應(yīng)內(nèi)存容量范圍,內(nèi)存單位GiB,不填表示接受所有

instance_generations
 
Array of strings

接受的資源代系,不填表示接受所有

參數(shù):
flavor_constraint.flavor_requirements.vcpu_count
名稱 類型 必選 描述
max
 
integer

最大值,-1表示無限制

min
 
integer

最小值,-1表示無限制

參數(shù):
flavor_constraint.flavor_requirements.memory_mb
名稱 類型 必選 描述
max
 
integer

最大值,-1表示無限制

min
 
integer

最小值,-1表示無限制

參數(shù):
flavor_constraint.flavor_requirements.memory_gb_per_vcpu
名稱 類型 必選 描述
max
 
double

最大值,-1表示無限制

min
 
double

最小值,-1表示無限制

參數(shù):
locations
名稱 類型 必選 描述
region_id
 
string

區(qū)域ID

availability_zone_id
 
string

可用區(qū)ID

參數(shù):
option
名稱 類型 必選 描述
result_granularity
 
string

推薦結(jié)果的粒度 BY_REGION:對每個區(qū)域打分,可使用多種規(guī)格滿足需求 BY_AZ:對每個可用區(qū)打分 BY_FLAVOR:對每個規(guī)格打分,可使用多地域滿足需求 BY_FLAVOR_AND_REGION:對每個區(qū)域下的每個規(guī)格打分 BY_FLAVOR_AND_AZ:對每個可用區(qū)下的每個規(guī)格打分

enable_spot
 
boolean

是否推薦競價實例

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

OK

名稱 類型 必選 描述
supply_recommendations
 
Array of SupplyRecommendation objects

資源供給推薦結(jié)果

200 supply_recommendations
名稱 類型 必選 描述
flavor_id
 
string

實例規(guī)格ID

region_id
 
string

區(qū)域ID

availability_zone_id
 
string

可用區(qū)ID

score
 
integer

推薦分數(shù)

返回碼: 400

Bad Request

返回碼: 401

Unauthorized

返回碼: 403

Forbidden

返回碼: 500

Internal Server Error

返回碼: 502

Bad Gateway

請求示例
示例 1

地域推薦請求示例

 
"POST https://{endpoint}/v1/{domain_id}/recommendations/ecs-supply"
 
{ "flavor_constraint": { "flavor_requirements": [ { "vcpu_count": { "max": 8, "min": 2 }, "memory_mb": { "max": 8192, "min": 4096 } } ], "option": { "result_granularity": "BY_FLAVOR_AND_AZ" }, "strategy": "COST", "locations": [ { "region_id": "region1" } ] } }
返回示例
返回碼:200

OK

示例 1
 
{
"supply_recommendations": [
{
"flavor_id": "c6.large.2",
"region_id": "region1",
"availability_zone_id": "az1",
"score": 8
}
]
}
SDK
點擊 容量管理服務(wù) (CMS) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認證方式等在SDK文檔中對應(yīng)語言類型的【使用】目錄下。
錯誤碼
請參考 錯誤碼說明。