确认

描述

object event.acknowledge(object/array parameters)

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

  • 关闭事件。如果事件已解决，则将跳过此操作。
  • 确认事件。如果事件已被确认，则将跳过此操作。
  • 添加消息。
  • 更改事件严重性。如果事件已经具有相同的严重性，则将跳过此操作。

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

此方法适用于任何类型的用户。可以在用户角色设置中撤销调用该方法的权限。参阅 用户角色。

参数

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

参数类型描述
eventids
(必填)		string/object要确认的事件的 ID。
action
(必填)		integer事件更新操作。这是位掩码字段，可以接受任何值组合。

可用值：
1 - 关闭问题；
2 - 确认事件；
4 - 添加消息；
8 - 更改严重性；
16 - 取消确认事件。
messagestring消息的文本。
如果操作包含“添加消息”标志，则该字段必填。
severityinteger事件的新严重性。
如果操作包含“更改严重性”标志，则该字段 必填。

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

返回值

(object) 返回一个对象， 该对象包含 eventids 属性下更新的事件 ID。

示例

确认事件

确认单个事件并留言。

请求：

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "event.acknowledge",
  4.            "params": {
  5.            "eventids": "20427",
  6.            "action": 6,
  7.            "message": "Problem resolved."
  8.            },
  9.            "auth": "038e1d7b1735c6a5436ee9eae095879e",
  10.            "id": 1
  11.        }

响应：

  1. {
  2.            "jsonrpc": "2.0",
  3.            "result": {
  4.            "eventids": [
  5.            "20427"
  6.            ]
  7.            },
  8.            "id": 1
  9.        }

更改事件的严重性

更改多个事件的严重性并留言。

请求:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "event.acknowledge",
  4.            "params": {
  5.            "eventids": ["20427", "20428"],
  6.            "action": 12,
  7.            "message": "Maintenance required to fix it.",
  8.            "severity": 4
  9.            },
  10.            "auth": "038e1d7b1735c6a5436ee9eae095879e",
  11.            "id": 1
  12.        }

响应:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "result": {
  4.            "eventids": [
  5.            "20427",
  6.            "20428"
  7.            ]
  8.            },
  9.            "id": 1
  10.        }

来源

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