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

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

[comment]: # ({07725e16-eed7fdda})
### 描述

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

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

-   关闭事件。如果事件已被解决，则将跳过此操作。
-   确认事件。如果事件已被确认，则将跳过此操作。
-   取消确认事件。如果事件未被确认，则将跳过此操作。
-   添加消息。
-   更改事件严重性。如果事件已具有相同的严重性，则将跳过此操作。
-   抑制事件。如果事件已被抑制，则将跳过此操作。
-   取消抑制事件。如果事件未被抑制，则将跳过此操作。
-   将事件等级更改为原因。如果事件已被标记为原因，则将跳过此操作。
-   将事件等级更改为症状。如果事件已被标记为症状，则将跳过此操作。

::: noteimportant
仅可更新触发器事件。<br>
仅可更新问题事件。<br>
关闭事件或更改事件严重性需要具有触发器的读/写权限。<br>
要关闭事件，必须在触发器中允许手动关闭。
:::

::: noteclassic
此方法适用于任何类型的用户。可在用户角色设置中撤销调用此方法的权限。更多信息请参见[用户角色](/manual/web_interface/frontend_sections/users/user_roles)。
:::

[comment]: # ({/07725e16-eed7fdda})

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

`(object/array)` 包含事件 ID 以及应执行的更新操作的参数。

|参数|[类型](/manual/api/reference_commentary#data-types)|描述|
|--|--|------|
|eventids|ID/array|要确认的 [事件](/manual/api/reference/event/object#event) 的 ID。<br><br>[参数行为](/manual/api/reference_commentary#parameter-behavior)：<br>- *必填*|
|action|integer|事件更新操作。<br><br>可能的位图值：<br>1 - 关闭问题；<br>2 - 确认事件；<br>4 - 添加消息；<br>8 - 更改严重性；<br>16 - 取消确认事件；<br>32 - 抑制事件；<br>64 - 取消抑制事件；<br>128 - 将事件等级更改为原因；<br>256 - 将事件等级更改为症状。<br><br>这是一个位掩码字段；可以接受任意可能位图值之和（例如，34 表示确认并抑制事件）。<br><br>[参数行为](/manual/api/reference_commentary#parameter-behavior)：<br>- *必填*|
|cause_eventid|ID|原因事件 ID。<br><br>[参数行为](/manual/api/reference_commentary#parameter-behavior)：<br>- 如果 `action` 包含“将事件等级更改为症状”位，则为 *必填*|
|message|string|消息文本。<br><br>[参数行为](/manual/api/reference_commentary#parameter-behavior)：<br>- 如果 `action` 包含“添加消息”位，则为 *必填*|
|severity|integer|事件的新严重性。<br><br>可能的值：<br>0 - 未分类；<br>1 - 信息；<br>2 - 警告；<br>3 - 一般严重；<br>4 - 高；<br>5 - 灾难。<br><br>[参数行为](/manual/api/reference_commentary#parameter-behavior)：<br>- 如果 `action` 包含“更改严重性”位，则为 *必填*|
|suppress_until|integer|事件必须被抑制到该时间点为止的 Unix 时间戳。<br><br>如果设置为“0”，抑制将无限期持续。<br><br>[参数行为](/manual/api/reference_commentary#parameter-behavior)：<br>- 如果 `action` 包含“抑制事件”位，则为 *必填*|

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

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

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

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

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

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

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

确认单个事件并留言。

[请求](/manual/api#执行请求)：	
```json
{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": "20427",
        "action": 6,
        "message": "Problem resolved."
    },
    "id": 1
}
```

响应：

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

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

[comment]: # ({63d8190d-94e25d7e})
#### 更改事件的严重性

更改多个事件的严重性并留言。

[请求](/manual/api#执行请求)：	
```json
{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": ["20427", "20428"],
        "action": 12,
        "message": "Maintenance required to fix it.",
        "severity": 4
    },
    "id": 1
}
```

响应:

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

[comment]: # ({/63d8190d-94e25d7e})

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

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

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