根據指定時間段查詢事件
更新時間 2023-07-19 11:41:07
最(zui)近更(geng)新時間: 2023-07-19 11:41:07
分享(xiang)文章
接口功能介紹
根(gen)據事件類型，查詢最新(xin)7天的事件。
接口約束
eventType目前只能是virtual_machine_events。
events目前只能是migration。
events內(nei)容如(ru)下：
| 事件名 | 事件類型 | 狀態說明 |
|---|---|---|
| migration | virtual_machine_events | 0表示事件發生，1表示事件恢復 |
URI
POST /v4/monitor/events/latest
請求參數
請求體body參數
| 參數 | 參數類型 | 是否必填 | 示例 | 說明 | 下級對象 |
|---|---|---|---|---|---|
| regionID | String | 是 | 81f7728662dd11ec810800155d307d5b | 資源池 ID | |
| events | Array of String | 否 | ["migration"] | 本參數表示事件類型列表。默認是所有事件。取值范圍：migration：事件狀態。根據以上范圍取值。 | |
| eventType | String | 是 | virtual_machine_events | 本參數表示事件類型。取值范圍：virtual_machine_events：云主機事件。根據以上范圍取值。 | |
| pageNo | Integer | 否 | 1 | 頁碼，默認為1 | |
| page | Integer | 否 | 1 | 頁碼，默認為1，建議使用pageNo，該參數后續會下線 | |
| pageSize | Integer | 否 | 2 | 頁大小，默認為10 |
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | Integer | 返回狀態碼（800為成功，900為失敗），默認值：800 | 800 | |
| errorCode | String | 失敗時的錯誤代碼，參見公共錯誤碼說明 | ||
| message | String | 失敗時的錯誤描述，一般為英文描述 | Success | |
| msgDesc | String | 失敗時的錯誤描述，一般為中文描述 | 成功 | |
| returnObj | Object | 返回對象 | returnObj |
表returnObj
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| totalCount | Integer | 獲取對象數據條數 | 14 | |
| totalPage | Integer | 總頁數 | 1 | |
| currentCount | Integer | 當前頁記錄數 | 14 | |
| page | Integer | 頁碼，建議參考請求參數pageNo，該參數后續會下線 | 1 | |
| pageSize | Integer | 頁大小，建議參考請求參數pageSize，該參數后續會下線 | 10 | |
| data | Array of Objects | 具體設備的事件 | data |
表data
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| deviceType | String | 本參數表示事件類型。取值范圍：virtual_machine_events：云主機事件。根據以上范圍取值。 | virtual_machine_events | |
| fuserLastUpdated | String | 最后發生事件時間 | 2022-11-09 11:34:42 | |
| regionID | String | 資源池ID | 73f321ea-62ff-11ec-a8bc-005056898fe0 | |
| regionName | String | 資源池名稱 | nm8 | |
| fuid | String | 設備唯一id | c7aa07b4-5567-462d-9146-12b29fdc02ec | |
| deviceID | String | fuid別名 | c7aa07b4-5567-462d-9146-12b29fdc02ec | |
| events | Object | 具體事件發生列表 | events |
表events
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| {event} | Array of Objects | 事件發生情況 | eventObject |
表eventObject
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| samptime | Integer | 事件發生時間 | 1667878501 | |
| value | String | 本參數表示事件發生狀態。取值范圍：0：事件發生。1：事件恢復。根據以上范圍取值。 | 1 |
請求示例
POST /v4/monitor/events
請求體body
{
"regionID":"81f7728662dd11ec810800155d307d5b",
"eventType":"virtual_machine_events",
"events":[
"migration"
]
}
響應示例
{
"statusCode":800,
"returnObj":{
"totalCount":1,
"totalPage":1,
"currentCount":1,
"page":1,
"pageSize":10,
"data":[
{
"deviceType":"virtual_machine_events",
"fuserLastUpdated":"2022-11-09 11:34:42",
"regionID":"73f321ea-62ff-11ec-a8bc-005056898fe0",
"regionName":"nm8",
"fuid":"c7aa07b4-5567-462d-9146-12b29fdc02ec",
"deviceID":"c7aa07b4-5567-462d-9146-12b29fdc02ec",
"events":{
"migration":[
{
"samptime":1667878501,
"value":"0"
},
{
"samptime":1667878621,
"value":"1"
}
]
}
}
]
},
"errorCode":"",
"message":"Success",
"msgDesc":"成功"
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 200 | 請求成功 |
錯誤碼
| errorCode | 描述 |
|---|---|
| Monitor.Events.QueryError | 查詢數據失敗 |
| 其他 | 參見公共錯誤碼說明 |
