查詢專屬宿主機規格
更新時間 2025-04-02 10:02:46
最近更新時間: 2025-04-02 10:02:46
分享文章
接口功能介紹
該接口提供用戶查詢專屬宿主機規格詳細參數的功能，返回符合查詢條件的專屬宿主機的核數、內存和cpu超配比
準備工作：
??構造請求：在調用前需要了解如何構造請求，詳情查看
??認證鑒權：openapi請求需要進行加密調用，詳細查看
接口約束
??確保當前宿主機存在于當前資源池（即參數decHostID與regionID對應）
URI
GET /v4/dec/host/type-show
路徑參數
無
Query參數
無
請求參數
請求頭header參數
無
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 資源池ID，您可以查看地域和可用區來了解資源池 獲取： 查 |
bb9fdb42056f11eda1610242ac110002 | |
| azName | 否 | String | 可用區名稱，您可以查看地域和可用區來了解可用區 獲取： 查 注：查詢結果中zoneList內返回存在可用區名稱(即多可用區，本字段填寫實際可用區名稱)，若查詢結果中zoneList為空（即為單可用區，本字段填寫default） |
cn-huadong1-jsnj3A-public-ctcloud | |
| hostID | 是 | String | 專屬宿主機ID，獲取： 查 |
417cdb4b-de54-e5e5-62da-b78533a45b38 |
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | Integer | 返回狀態碼（800為成功，900為失敗） | 800 | |
| errorCode | String | 錯誤碼，為product.module.code三段式碼 | Openapi.PatternCheck.NotValid | |
| error | String | 錯誤碼，為product.module.code三段式碼 | Openapi.PatternCheck.NotValid | |
| message | String | 英文描述信息 | SUCCESS | |
| description | String | 中文描述信息 | 成功 | |
| returnObj | Object | 成功時返回的數據 | returnObj |
表 returnObj
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| currentCount | Integer | 當前頁記錄數目 | 1 | |
| totalCount | Integer | 總記錄數 | 1 | |
| totalPage | Integer | 總頁數 | 1 | |
| results | Array of Objects | 分頁明細 | results |
表 results
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| vcpu | Integer | vCPU的數量 | 64 | |
| cpuRatio | Integer | CPU的倍頻 | 1 | |
| memory | Integer | 總內存大小，單位MB | 512 |
枚舉參數
無
請求示例
請求url
無
請求頭header
無
請求體body
示例：查詢專屬宿主機的規格信息
{
"regionID":"a39b0db2989140c79e6de8c21d50f132",
"azName": "cn-huadong1-jsnj1A-public-ctcloud",
"hostID":"417cdb4b-de54-e5e5-62da-b78533a45b38"
}
響應示例
{
"returnObj": {
"currentCount": 1,
"totalCount": 1,
"totalPage": 1,
"results": [
{
"vcpu": 64,
"cpuRatio": 1,
"memory": 514204
}
]
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}0}
狀態碼
請參考
錯誤碼
請參考
