2.event.acknowledge

描述

对象 event.acknowledge(object/array **parameters**)

此方法用于更新事件，可以执行以下更新操作:

  • 关闭事件. 如果事件已经解决，此操作将会被跳过。

  • 确认事件. 如果事件已经被确认，此操作将会被跳过。

  • 新增信息。

  • 更改事件严重等级. 如果事件已经拥有相同的严重等级，此操作将会被跳过。

只有触发器事件可以被更新。
只有问题事件可以被更新。
关闭事件或者更改事件的严重等级需要具有对触发器的读写权限。
为了可以关闭事件，你应该在触发器中配置’允许手动关闭’。

参数

(对象/数组) 包含事件ID和应执行的更新操作的参数。

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

可能值:
1 - 关闭问题;
2 - 确认事件;
4 - 新增消息;
8 - 更改严重等级。
messagestring消息文本。
如果操作包含’新增消息’标志，此选项必选。
severityinteger事件的新的严重等级。
如果操作包含’更改严重等级’标志，此选项必选。

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

返回值

(对象) 在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. }

来源

CEvent::acknowledge() in frontends/php/include/classes/api/services/CEvent.php.