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",
           "result": {
               "eventids": [
                   "20427"
               ]
           },
           "id": 1
       }

更改事件严重性

批量修改事件严重性并添加备注

执行请求:

{
           "jsonrpc": "2.0",
           "method": "event.acknowledge",
           "params": {
               "eventids": ["20427", "20428"],
               "action": 12,
               "message": "Maintenance required to fix it.",
               "severity": 4
           },
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "eventids": [
                   "20427",
                   "20428"
               ]
           },
           "id": 1
       }

来源

CEvent::acknowledge() 位于 ui/include/classes/api/services/CEvent.php 文件中。