導出監控數據：共享帶寬
更新時間 2023-07-19 11:41:05
最近更新時間: 2023-07-19 11:41:05
分享文章(zhang)
接口功能介紹
導出指定時(shi)間段內的共(gong)享帶寬(kuan)時(shi)序指標(biao)監控數(shu)據，導出格式為csv文件。
接口約束
regionID（資源(yuan)池）、deviceUUIDList（共享帶寬資源(yuan)）、itemNameList（待查監控項名稱(cheng)）存在。
URI
POST /v4/monitor/export-traffic-historymetricdata
請求參數
請求體body參數
| 參數 | 參數類型 | 是否必填 | 示例 | 說明 | 下級對象 |
|---|---|---|---|---|---|
| regionID | String | 是 | 81f7728662dd11ec810800155d307d5b | 資源池ID | |
| itemNameList | Array of String | 是 | ["ingress_throughput"] | 待查的監控項名稱 | |
| startTime | String | 是 | 1667815639 | 查詢起始時間戳 | |
| endTime | String | 是 | 1667817639 | 查詢結束時間戳 | |
| deviceUUIDList | Array of String | 是 | ["bandwidth-003y4yvzwy"] | 查詢設備ID列表 | |
| period | Integer | 否 | 300 | 聚合周期，單位：秒，默認300 |
響應參數
根據請求參(can)數導出監控數據為csv文件。
文件內(nei)容按(an)照設(she)備deviceUUID分(fen)隔，不同設(she)備的數(shu)據以欄（多個行(xing)）為(wei)單位(wei)豎向排列。
同(tong)一(yi)設備的不(bu)同(tong)指(zhi)標，按照(zhao)時間(jian)戳橫向排列，無數(shu)據則為(wei)空(kong)。
請求失(shi)敗，返回參(can)數參(can)考歷史(shi)監控數據(ju)查詢系列(lie)接(jie)口(kou)。
請求示例
POST /v4/monitor/export-traffic-historymetricdata
請求體body
{
"regionID": "81f7728662dd11ec810800155d307d5b",
"startTime": "1667815639",
"endTime": "1667817639",
"itemNameList": [
"ingress_throughput"
],
"deviceUUIDList": [
"bandwidth-003y4yvzwy"
]
}
響應示例
csv文件內容：
deviceUUID,ingress_throughput,samplingTime
bandwidth-003y4yvzwy,92,1667815639
bandwidth-003y4yvzwy,92,1667815939
bandwidth-003y4yvzwy,46,1667816239
bandwidth-003y4yvzwy,46,1667816539
bandwidth-003y4yvzwy,0,1667816839
bandwidth-003y4yvzwy,46,1667817139
bandwidth-003y4yvzwy,46,1667817439
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 200 | 請求成功 |
錯誤碼
| errorCode | 描述 |
|---|---|
| Monitor.DataQuery.RegionNotFound | 找不到資源池 |
| Monitor.DataQuery.ItemNameUndefined | 監控項未定義 |
| Monitor.DataQuery.QueryError | 查詢數據失敗 |
| Monitor.DataQuery.AccessFailed | 訪問內部系統失敗 |
| Monitor.DataQuery.ResponseError | 訪問內部系統返回錯誤 |
| 其他 | 參見公共錯誤碼說明 |
