調用DescribeAvailableResource查詢指定地域和可用區下可售ECS實例規格族。
接口說明
調用 CreateContainerGroup 創建 ECI 實例時支持通過 InstanceType 參數來指定 ECS 規格,以滿足特定的規格需求。為保證 ECI 實例能夠創建成功,在創建 ECI 實例前,您可以先調用本接口查詢指定地域和可用區下支持哪些 ECS 實例規格或實例規格族。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
當前API暫無授權信息透出。
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 地域 ID。 您可以調用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
ZoneId | string | 否 | 可用區 ID。 默認值為空,此時查詢指定地域下的所有可用區。 | cn-hangzhou-e |
DestinationResource | object | 是 | 要查詢的資源信息。 | |
Category | string | 是 | 資源類型。取值范圍:
| InstanceTypeFamily |
Value | string | 否 | 實例規格族或者具體實例規格。
| ecs.c6 |
Cores | float | 否 | vCPU 核數。當 Category 取值為 InstanceType 時,可以設置。 | 2 |
Memory | float | 否 | 內存大小。單位為 GiB。當 Category 取值為 InstanceType 時,可以設置。 | 4 |
SpotResource | object | 否 | 要查詢的搶占式實例的資源信息。 | |
SpotStrategy | string | 否 | 實例的搶占策略。取值范圍:
默認為:NoSpot。 說明
查詢搶占式實例資源信息時,即取值為 SpotWithPriceLimit 或 SpotAsPriceGo 時,Category 取值必須為 InstanceType,同時需指定具體實例規格(Value),或者指定 vCPU 和內存(Cores 和 Memory)。
| SpotAsPriceGo |
SpotPriceLimit | double | 否 | 搶占式實例的每小時最高價格,最多精確到小數點后 3 位。當 SpotStrategy 取值為 SpotWithPriceLimit 時,必須設置 SpotPriceLimit。 | 0.2 |
SpotDuration | integer | 否 | 搶占式實例的保護期。單位為小時。默認為 1。可設置為 0,表示無保護期。 | 1 |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "6829735A-FF76-58C6-AECB-27CBF135A7AA",
"AvailableZones": {
"AvailableZone": [
{
"RegionId": "cn-hangzhou",
"ZoneId": "cn-hangzhou-e",
"AvailableResources": {
"AvailableResource": [
{
"Type": "InstanceTypeFamily",
"SupportedResources": {
"SupportedResource": [
{
"Value": "ecs.c6",
"StatusCategory": "WithStock"
}
]
}
}
]
}
}
]
}
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | MissingParameter | %s | 必填參數缺失 |
400 | InvalidParameter | %s | 不合法的參數 |
403 | Spot.NotMatched | %s. We recommend that you use the create multi-zone function to avoid insufficient inventory. | 推薦使用多可用區多規格配置來避免庫存不足 |
404 | InvalidParameter.NotFound | %s | 參數未找到 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-06-21 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |