object event.acknowledge(object/array parameters)
此方法允许更新事件。可以执行以下更新操作:
只能更新触发器事件。
只能更新问题事件。
需要触发器的读/写权限才能关闭事件或更改事件的严重性。
要关闭事件,触发器中应允许手动关闭。
此方法适用于任何类型的用户。可以在用户角色设置中撤销调用该方法的权限。参见用户角色 了解更多信息。
(object/array)
包含事件ID和应执行的更新操作的参数。
参数 | 类型 | 描述 |
---|---|---|
eventids | ID/数组 | 要确认的 事件 的ID。 参数行为: - 必填 |
action | 整数 | 事件更新操作。 可能的位图值: 1 - 关闭问题; 2 - 确认事件; 4 - 添加消息; 8 - 更改严重性; 16 - 取消确认事件; 32 - 抑制事件; 64 - 解除抑制事件; 128 - 将事件等级更改为原因; 256 - 将事件等级更改为症状。 这是一个位字段;任何可能的位图值之和都是可接受的(例如,34表示确认和抑制事件)。 参数行为: - 必填 |
cause_eventid | ID | 原因事件ID。 参数行为: - 必填 如果 action 包含 "将事件等级更改为症状" 位 |
message | 字符串 | 消息的文本。 参数行为: - 必填 如果 action 包含 "添加消息" 位 |
severity | 整数 | 事件的新严重性。 可能的值: 0 - 未分类; 1 - 信息; 2 - 警告; 3 - 平均; 4 - 高; 5 - 灾难。 参数行为: - 必填 如果 action 包含 "更改严重性" 位 |
suppress_until | 整数 | Unix时间戳,直到该时间戳事件必须被抑制。 如果设置为 "0",抑制将是无限期的。 参数行为: - 必填 如果 action 包含 "抑制事件" 位 |
(object)
返回一个对象, 该对象包含 eventids
属性下更新的事件 ID。
确认单个事件并留言。
请求:
{
"jsonrpc": "2.0",
"method": "event.acknowledge",
"params": {
"eventids": "20427",
"action": 6,
"message": "Problem resolved."
},
"id": 1
}
响应:
更改多个事件的严重性并留言。
请求:
{
"jsonrpc": "2.0",
"method": "event.acknowledge",
"params": {
"eventids": ["20427", "20428"],
"action": 12,
"message": "Maintenance required to fix it.",
"severity": 4
},
"id": 1
}
响应:
ui/include/classes/api/services/CEvent.php 中的 CEvent::acknowledge() 。