确认

描述

object event.acknowledge(object/array parameters)

此方法允许您更新事件。可执行以下更新操作：

  • 关闭事件。如果事件已被解决，则将跳过此操作。
  • 确认事件。如果事件已被确认，则将跳过此操作。
  • 取消确认事件。如果事件未被确认，则将跳过此操作。
  • 添加消息。
  • 更改事件严重性。如果事件已经具有相同的严重性，则将跳过此操作。
  • 抑制事件。如果事件已被抑制，则将跳过此操作。
  • 取消抑制事件。如果事件未被抑制，则将跳过此操作。
  • 将事件等级更改为原因。如果事件已被标记为原因，则将跳过此操作。
  • 将事件等级更改为症状。如果事件已被标记为症状，则将跳过此操作。

仅可更新触发器事件。
仅可更新问题事件。
关闭事件或更改事件严重性需要具有触发器的读/写权限。
要关闭事件，必须在触发器中允许手动关闭。

任何类型的用户都可以使用此方法。调用该方法的权限可在用户角色设置中撤销。更多信息请参见用户角色。

参数

(object/array) 包含事件 ID 以及应执行的更新操作的参数。

参数 类型 描述
eventids ID/array 要确认的 事件 的 ID。

参数行为：
- 必填
action integer 事件更新操作。

可能的位图值：
1 - 关闭问题；
2 - 确认事件；
4 - 添加消息；
8 - 更改严重性；
16 - 取消确认事件；
32 - 抑制事件；
64 - 取消抑制事件；
128 - 将事件等级更改为原因；
256 - 将事件等级更改为症状。

这是一个位掩码字段；可以接受任意可能位图值之和（例如，34 表示确认并抑制事件）。

参数行为：
- 必填
cause_eventid ID 原因事件 ID。

参数行为：
- 如果 action 包含“将事件等级更改为症状”位，则为 必填
message string 消息文本。

参数行为：
- 如果 action 包含“添加消息”位，则为 必填
severity integer 事件的新严重性。

可能的值：
0 - 未分类；
1 - 信息；
2 - 警告；
3 - 一般严重；
4 - 高；
5 - 灾难。

参数行为：
- 如果 action 包含“更改严重性”位，则为 必填
suppress_until integer 事件必须被抑制到该时间点为止的 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",
    "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
}

来源

ui/include/classes/api/services/CEvent.php 中的 CEvent::acknowledge() 。