查詢輕量型云主機的規格套餐資源
更新時間 2024-12-13 18:36:40
最近更新時間: 2024-12-13 18:36:40
分享文章
查詢輕量型云主機的規格套餐資源
接口功能介紹
該接口提供用戶可用規格列表查詢功能,可返回輕量型云主機規格的詳細信息,用戶可以根據此接口的返回值了解自己可使用的云主機規格有哪些。
URI
GET /v4/ecs/lite/flavor/list
路徑參數
無
Query參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 資源池ID,您可以調用查看最新的天翼云資源池列表 | 88f8888888dd88ec888888888d888d8b | |
| flavorSetType | 否 | String | 規格套餐類型,取值范圍:fix:固定套餐band:帶寬套餐 | fix |
請求參數
請求頭header參數
無
請求體body參數
無
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | Integer | 返回狀態碼(800為成功,900為失敗) | 800 | |
| errorCode | String | 業務細分碼,為product.module.code三段式碼,詳見錯誤碼說明 | Openapi.PatternCheck.NotValid | |
| message | String | 失敗時的錯誤描述,一般為英文描述 | SUCCESS | |
| description | String | 失敗時的錯誤描述,一般為中文描述 | 成功 | |
| returnObj | Object | 成功時返回的數據 | returnObj |
表 returnObj
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| currentCount | Integer | 當前頁記錄數目 | 1 | |
| totalCount | Integer | 總記錄數 | 10 | |
| totalPage | Integer | 總頁數 | 1 | |
| results | Array of Objects | 規格列表 | flavors |
表 flavors
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| flavorSetType | String | 規格套餐類型,取值范圍:fix:固定套餐band:帶寬套餐 | fix | |
| flavorName | String | 規格套餐名稱 | lite1.fix.small.1 | |
| flavorSeries | String | 規格系列 | lite | |
| flavorType | String | 規格類型 | CPU_LITE1 | |
| flavorRAM | Integer | 內存大小,單位為G | 1 | |
| flavorCPU | Integer | VCPU個數 | 1 | |
| flavorBandwidth | Integer | 固定套餐帶寬大小,當flavorSetType為fix時展示 | 1 | |
| flavorBootDiskSize | Integer | 固定套餐系統盤大小,當flavorSetType為fix時展示 | 40 | |
| flavorBandwidthList | Array of Integers | 帶寬套餐帶寬大小取值列表,當flavorSetType為band時展示 | [1, 2, 5, 10, 15] | |
| flavorBootDiskSizeList | Array of Integers | 帶寬套餐系統盤大小取值列表,當flavorSetType為band時展示 | [40, 60, 80] |
請求示例
GET .../v4/ecs/lite/flavor/list?regionID=81f7728662dd11ec810800155d307d5b
請求頭header
無
請求體body
無
響應示例
{
"returnObj": {
"currentCount": 2,
"totalCount": 2,
"totalPage": 1,
"results": [{
"flavorRAM": 1,
"flavorCPU": 1,
"flavorSetType": "fix",
"flavorBootDiskSize": 40,
"flavorSeries": "lite",
"flavorName": "lite1.fix.small.1",
"flavorBandwidth": 1,
"flavorType": "CPU_LITE1"
}, {
"flavorRAM": 16,
"flavorCPU": 8,
"flavorSetType": "band",
"flavorBandwidthList": [1, 2, 5, 10, 15],
"flavorSeries": "lite",
"flavorName": "lite1.band.2xlarge.2",
"flavorBootDiskSizeList": [40, 60, 80],
"flavorType": "CPU_LITE1"
}]
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 200 | 表示請求成功。 |
錯誤碼
| errorCode | 描述 |
|---|---|
| Openapi.PatternCheck.NotValid | 請求參數無效 |
| LiteEcs.RegionInfo.Empty | 查詢資源池信息為空或資源池不存在,請確認資源池ID是否有效 |
| LiteEcs.RegionInfo.AccessFailed | 查詢資源池失敗,請重試。如果多次嘗試失敗,請提交工單 |
| LiteEcs.RegionInfo.DataDamaged | 查詢資源池信息不符預期,請重試。如果多次嘗試失敗,請提交工單 |
| LiteEcs.RegionVersion.NotSupport | 當前API不支持該資源池,請切換資源池重試 |
| Openapi.FlavorAdmin.AccessFailed | 查詢云主機規格失敗,請重試。如果多次嘗試失敗,請提交工單 |
| Openapi.FlavorAdmin.FormatError | 查詢云主機規格信息格式錯誤,請重試。如果多次嘗試失敗,請提交工單 |