获取事件 (GetEventData)
用户可以用
GetEventData
获取系统已发生的事件:GetEventData
参数(Parameters)
名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
---|---|---|---|---|
startTime | 起始时间 | 是 | 2.3 | |
endTime | 结束时间 | 是 | 2.3 | |
limit | 最大返回条数 | 是 | 2.3 | |
labels | 过滤标签列表 | 是 | 2.3 | |
latest | 是否只返回最近一条记录 | 是 | 2.3 | |
userTags | 用户标签,请参见 创建用户标签(CreateUserTag) | 是 | 2.3 | |
systemTags | 系统标签,请参见 创建系统标签(CreateSystemTag) | 是 | 2.3 | |
timeout | 是 |
返回包含一组事件:
{
"events": [
{
"emergencyLevel": "Normal",
"labels": {
"NewStatus": "Connecting",
"OldStatus": "Connected"
},
"name": "HostStatusChanged",
"namespace": "ZStack/Host",
"resourceId": "184eae9058f9477a91975f549b54f59f",
"resourceName": "Host-1",
"time": 1510984704006
},
{
"emergencyLevel": "Normal",
"labels": {
"NewStatus": "Disconnected",
"OldStatus": "Connecting"
},
"name": "HostStatusChanged",
"namespace": "ZStack/Host",
"resourceId": "184eae9058f9477a91975f549b54f59f",
"resourceName": "Host-1",
"time": 1510984704633
}
],
"success": true
}
其中:
- emergencyLevel:紧急程度,包含
Normal
和Emergent
两种 - name:事件名称
- namespace:事件所在namespace
- resourceId:事件所发生资源的ID,如果为ZStack资源该ID为资源的UUID
- resourceName:事件所发生资源的名称
- time:事件发生的时间
GetEventData
支持以下字段:
- startTime: 起始时间
- endTime:结束时间。用户可以通过设置
startTime
和endTime
来获得指定事件段内发生的事件 - limit:返回事件的数量。若不指定,默认返回最多100个事件
- conditions:过滤条件。用户可以
emergencyLevel
,name
,namespace
,resourceName
作为过滤条件,例如获得所有跟物理机有关的紧急事件可以用:GetEventData conditions=namespace=ZStack/Host,emergencyLevel=Emergent
过滤条件支持
=
(等于)和=~
(正则)两种操作符。