查詢專屬云的統計信息
更新時間 2025-04-02 09:55:32
最近更新時間: 2025-04-02 09:55:32
分享文章
接口功能介紹
該接口供用戶查詢其所屬專屬云的統計信息的功能
準備工作：
??構造請求：在調用前需要了解如何構造請求，詳情查看
??認證鑒權：openapi請求需要進行加密調用，詳細查看
接口約束
無
URI
GET /v4/dec/statistics-dec
路徑參數
無
Query參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 資源池ID，您可以調用查看最新的天翼云資源池列表 | ef901a5734964ce29eedac918c4716a3 | |
| azName | 否 | String | 可用區名稱，您可以調用獲取，查詢結果中zoneList內返回存在可用區名稱(即多可用區，本字段填寫實際可用區名稱)，若查詢結果中zoneList為空(即為單可用區，本字段填寫default) | az2 |
請求參數
請求頭header參數
無
請求體body參數
無
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | Integer | 返回狀態碼(800為成功，900為失敗) | 800 | |
| errorCode | String | 業務細分碼，為product.module.code三段式碼，詳見錯誤碼說明 | Openapi.PatternCheck.NotValid | |
| message | String | 英文描述信息 | SUCCESS | |
| description | String | 中文描述信息 | 成功 | |
| returnObj | Object | 成功時返回的數據 | returnObj |
表 returnObj
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| total_memory_mb | Float | 總內存大小 | 1542613.9296875 | |
| vcpus_used | Integer | 已用vcpu數量 | 203 | |
| total_vms | Integer | 總云主機數量 | 25 | |
| host | Integer | 宿主機數量 | 3 | |
| memory_mb_free | Float | 可用內存 | 1035733.9296875 | |
| memory_mb_used | Float | 已用內存 | 506880.0 | |
| vcpus_free | Integer | 可用vcpu數量 | 53 | |
| total_vcpus | Integer | 總vcpu數量 | 256 |
枚舉參數
無
請求示例
請求url
示例：查詢專屬云的統計信息
GET '.../v4/dec/statistics-dec?regionID=bb9fdb42056f11eda1610242ac110002'
請求頭header
無
請求體body
無
響應示例
{
"returnObj": {
"totalVMs": 2,
"totalHostCount": 1,
"freeMemSize": 512156.640625,
"usedVCPUs": 2,
"freeVCPUs": 62,
"totalVCPUs": 64,
"usedMemSize": 2048,
"totalMemSize": 514204.640625
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
狀態碼
請參考
錯誤碼
請參考
