event.acknowledge
描述
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 文件中。