導出監控數據:裸金屬
更新(xin)時(shi)間 2023-07-19 11:41:05
最近更新(xin)時間: 2023-07-19 11:41:05
分享(xiang)文章
接口功能介紹
導出(chu)指定時間段內的(de)裸(luo)金屬時序指標(biao)監控數據(ju),導出(chu)格式為csv文件(jian)。
接口約束
regionID(資源池)、deviceUUIDList(裸(luo)金屬資源)、itemNameList(待(dai)查(cha)監(jian)控項名稱)存(cun)在。
URI
POST /v4/monitor/export-baremetal-historymetricdata
請求參數
請求體body參數
| 參數 | 參數類型 | 是否必填 | 示例 | 說明 | 下級對象 |
|---|---|---|---|---|---|
| regionID | String | 是 | 81f7728662dd11ec810800155d307d5b | 資源池ID | |
| itemNameList | Array of String | 是 | ["cpu_util"] | 待查的監控項名稱 | |
| startTime | String | 是 | 1667815639 | 查詢起始時間戳 | |
| endTime | String | 是 | 1667817639 | 查詢結束時間戳 | |
| deviceUUIDList | Array of String | 是 | ["4905345a-9894-b41e-ec11-6515763d99cc"] | 查詢設備ID列表 | |
| period | Integer | 否 | 300 | 聚合周期,單位:秒,默認300 |
響應參數
根據請求參數導(dao)出監(jian)控數據為csv文件(jian)。
文件內容按照設備deviceUUID分隔(ge),不同設備的數據以(yi)欄(多個(ge)行)為單(dan)位豎向(xiang)排列(lie)。
同(tong)一設備的不同(tong)指標,按照時間戳橫(heng)向排列(lie),無數據(ju)則為(wei)空。
請(qing)求失敗,返(fan)回參數(shu)參考歷(li)史監控數(shu)據(ju)查(cha)詢系列接(jie)口。
請求示例
POST /v4/monitor/export-baremetal-historymetricdata
請求體body
{
"regionID": "81f7728662dd11ec810800155d307d5b",
"startTime": "1667815639",
"endTime": "1667817639",
"itemNameList": [
"cpu_util",
"disk_write_bytes_rate"
],
"deviceUUIDList": [
"4905345a-9894-b41e-ec11-6515763d99cc",
"d55d05b4-7ee9-03e7-11ec-457d9b58f27b"
]
}
響應示例
csv文件內容:
deviceUUID,cpu_util,disk_write_bytes_rate,samplingTime
4905345a-9894-b41e-ec11-6515763d99cc,-1,-1,-1
d55d05b4-7ee9-03e7-11ec-457d9b58f27b,-1,-1,-1
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 200 | 請求成功 |
錯誤碼
| errorCode | 描述 |
|---|---|
| Monitor.DataQuery.RegionNotFound | 找不到資源池 |
| Monitor.DataQuery.ItemNameUndefined | 監控項未定義 |
| Monitor.DataQuery.QueryError | 查詢數據失敗 |
| Monitor.DataQuery.AccessFailed | 訪問內部系統失敗 |
| Monitor.DataQuery.ResponseError | 訪問內部系統返回錯誤 |
| 其他 | 參見公共錯誤碼說明 |