event.acknowledge

描述

object event.acknowledge(object/array parameters)

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

关闭事件。若事件已解决，此操作将被跳过。
确认事件。若事件已确认，此操作将被跳过。
取消确认事件。若事件未确认，此操作将被跳过。
添加消息。
更改事件严重性。若事件当前严重性相同，此操作将被跳过。

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

此方法适用于所有用户类型。调用权限可通过用户角色设置撤销。详见User roles获取更多信息。

参数

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

参数	数据类型	说明
eventids (required)	string/object	待确认的事件ID
action (required)	integer	事件更新操作可选的位图值： 1 - 关闭问题； 2 - 确认事件； 4 - 添加消息； 8 - 变更严重等级； 16 - 取消确认事件此为位掩码字段，允许使用任意有效组合值（例如6表示同时确认事件和添加消息）
message	string	消息文本必填（当操作包含'添加消息'flag时）
severity	integer	事件新严重等级必填（当操作包含'变更严重等级'flag时）可选值： 0 - 未分类； 1 - 信息； 2 - 警告； 3 - 一般严重； 4 - 严重； 5 - 灾难

返回值

(object) 返回一个包含更新事件ID的object，存储在eventids属性下。

仅返回OutputFormat格式要求结果

确认事件

确认单个事件并留下消息。

请求：

{
           "jsonrpc": "2.0",
           "method": "event.acknowledge",
           "params": {
               "eventids": "20427",
               "action": 6,
               "message": "Problem resolved."
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "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
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应：

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

来源

CEvent::acknowledge() 位于 ui/include/classes/api/services/CEvent.php 文件中。

Documentation

event.acknowledge

描述

参数

返回值

确认事件

更改事件严重性

来源