[comment]: # translation:outdated

[comment]: # ({579decb3-2ccfd922})
# 2.event.acknowledge

[comment]: # ({/579decb3-2ccfd922})

[comment]: # ({fbd3d385-238717fa})
### 描述

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

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

-   关闭事件. 如果事件已经解决，此操作将会被跳过。
-   确认事件. 如果事件已经被确认，此操作将会被跳过。
-   新增信息。
-   更改事件严重等级. 如果事件已经拥有相同的严重等级，此操作将会被跳过。

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

[comment]: # ({/fbd3d385-238717fa})

[comment]: # ({b2d62cfd-32560b88})
### 参数

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

|参数            类|描述|<|
|---------------------|------|-|
|**eventids**<br>(必选)|string/object|确认事件的ID。|
|**action**<br>(必选)|integer<br>|更新事件的操作。这是位掩码字段，可接受以下任何值的组合。<br>可能值:<br>1 - 关闭问题;<br>2 - 确认事件;<br>4 - 新增消息;<br>8 - 更改严重等级。|
|message|string|消息文本。<br>如果操作包含'新增消息'标志，此选项**必选**。|
|severity|integer|事件的新的严重等级。<br>如果操作包含'更改严重等级'标志，此选项**必选**。<br><br>可能值:<br>0 - 未分类;<br>1 - 信息;<br>2 - 警告;<br>3 - 一般严重;<br>4 - 严重;<br>5 - 灾难。|

[comment]: # ({/b2d62cfd-32560b88})

[comment]: # ({8335f23d-94f3ab84})
### 返回值

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

[comment]: # ({/8335f23d-94f3ab84})

[comment]: # ({4811a99c-b41637d2})
### 示例

[comment]: # ({/4811a99c-b41637d2})

[comment]: # ({cba7c05d-9e923e4c})
#### 确认一个事件

确认一个事件并留下一个信息。

请求:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": "20427",
        "action": 6,
        "message": "Problem resolved."
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

响应:

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

[comment]: # ({/cba7c05d-9e923e4c})

[comment]: # ({35b77cb6-94e25d7e})
#### 更改事件的严重等级

更改多个事件的严重等级并留下一个信息。

请求:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": ["20427", "20428"],
        "action": 12,
        "message": "Maintenance required to fix it.",
        "severity": 4
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

响应:

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

[comment]: # ({/35b77cb6-94e25d7e})

[comment]: # ({cb00dd1f-aadd99f7})
### 来源

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

[comment]: # ({/cb00dd1f-aadd99f7})