event.acknowledge

描述

object event.acknowledge(object/array parameters)

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

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

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

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

参数

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

参数	数据类型	描述
eventids	ID/array	需要确认的事件的ID。参数行为: - 必填
action	integer	事件update操作。可能的位图值： 1 - 关闭问题； 2 - acknowledge事件； 4 - 添加消息； 8 - 更改严重性； 16 - 取消acknowledge事件； 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) 返回一个 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
       }

来源

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

Documentation

event.acknowledge

描述

参数

返回值

示例

确认事件

更改事件严重性

来源