[comment]: # translation:outdated

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

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

[comment]: # ({3cf9db19-eed7fdda})
### 描述

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

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

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

    action will be skipped.

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

:::

::: noteclassic
此方法适用于所有用户类型。\
调用该方法的权限可通过用户角色设置撤销。详见[User
roles](/manual/web_interface/frontend_sections/administration/user_roles)获取更多信息。

:::

[comment]: # ({/3cf9db19-eed7fdda})

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

`(object/array)` 包含事件ID和update操作的参数.

| 参数 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 |
|--|--|------|
| **eventids**<br>(required) | string/object | 需要acknowledge的事件ID. |
| **action**<br>(required) | integer | 事件update操作.<br><br>可能的位图值:<br>1 - 关闭问题;<br>2 - acknowledge事件;<br>4 - 添加消息;<br>8 - 变更严重等级;<br>16 - 取消事件确认.<br><br>这是一个位掩码字段; 可以接受任何可能位图值的组合(例如6表示acknowledge事件和添加消息). |
| message | string | 消息文本.<br>**必填**, 如果操作包含'添加消息'flag. |
| severity | integer | 事件的新严重等级.<br>**必填**, 如果操作包含'变更严重等级'flag.<br><br>可能的值:<br>0 - 未分类;<br>1 - 信息;<br>2 - 警告;<br>3 - 一般严重;<br>4 - 严重;<br>5 - 灾难. |

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

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

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

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

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

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

[comment]: # ({2a20eeea-9e923e4c})
#### 确认事件

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

请求:

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

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

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

[comment]: # ({7d16988e-94e25d7e})
#### 更改事件严重性

批量修改事件严重性并留下备注信息

请求:

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

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

[comment]: # ({/7d16988e-94e25d7e})

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

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

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