确认

描述

object event.acknowledge(object/array parameters)

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

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

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

此方法对任何类型的用户都可用。 可在用户角色设置中撤销调用此方法的权限。 有关更多信息，请参见 User roles。

参数

(object/array) 包含需要执行的事件 ID 和更新操作的参数。

Parameter Type Description
eventids ID/array 要确认的 事件 的 ID。

参数行为:
- required
action integer 事件更新操作。

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

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

参数行为:
- required
cause_eventid ID 原因事件 ID。

参数行为:
- required if action contains the "change event rank to symptom" bit
message string 消息文本。

参数行为:
- required if action contains the "add message" bit
severity integer 事件的新严重性。

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

参数行为:
- required if action contains the "change severity" bit
suppress_until integer 事件必须被抑制到的 Unix 时间戳。

如果设置为 "0"，则抑制将无限期持续。

参数行为:
- required if action contains the "suppress event" bit

返回值

(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
}

无限期抑制事件

在没有过期时间的情况下抑制单个事件。

请求:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": "20427",
        "action": 32,
        "suppress_until": 0
    },
    "id": 1
}

响应：

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

取消抑制事件

取消对单个先前已抑制事件的抑制。

请求:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": "20427",
        "action": 64
    },
    "id": 1
}

响应：

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

确认并抑制事件

确认一个或多个事件，添加消息，并在同一请求中将其抑制。

请求:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": [
            "20427",
            "20428"
        ],
        "action": 38,
        "message": "Suppressing during planned maintenance.",
        "suppress_until": 0
    },
    "id": 1
}

响应：

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

来源

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