object event.acknowledge(object/array parameters)
此方法允许update事件。可以执行以下update操作:
仅可更新触发器事件。
仅可更新问题事件。
关闭事件或更改事件严重性需要触发器的读写权限。
要关闭事件,必须在触发器中允许手动关闭。
此方法适用于任何类型的用户。
可以在用户角色设置中撤销调用此方法的权限。
有关更多信息,请参阅User roles。
(object/array)
包含事件ID和应执行update操作的参数.
参数 | 数据类型 | 描述 |
---|---|---|
eventids | ID/array | 需要acknowledge的事件ID. 参数行为: - 必填 |
action | integer | 事件update操作. 可能的位图值: 1 - 关闭问题; 2 - acknowledge事件; 4 - 添加消息; 8 - 更改严重性; 16 - 取消确认事件; 32 - 抑制事件; 64 - 取消抑制事件; 128 - 将事件等级改为原因; 256 - 将事件等级改为症状. 这是一个位掩码字段; 可以接受任何可能的位图值之和(例如34表示acknowledge和抑制事件). 参数行为: - 必填 |
cause_eventid | ID | 原因事件ID. 参数行为: - 当 action 包含"将事件等级改为症状"位时必填 |
message | string | 消息文本. 参数行为: - 当 action 包含"添加消息"位时必填 |
severity | integer | 事件的新严重性等级. 可能值: 0 - 未分类; 1 - 信息; 2 - 警告; 3 - 一般严重; 4 - 严重; 5 - 灾难. 参数行为: - 当 action 包含"更改严重性"位时必填 |
suppress_until | integer | 事件必须被抑制的Unix时间戳. 如果设置为"0", 抑制将无限期持续. 参数行为: - 当 action 包含"抑制事件"位时必填 |
(object)
返回一个包含更新事件ID的object 这些ID位于eventids
属性下
确认单个事件并留下消息。
执行请求:
{
"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
}
响应:
CEvent::acknowledge() 位于 ui/include/classes/api/services/CEvent.php 文件中。