[comment]: # translation:outdated

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

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

[comment]: # ({96ece3aa-eed7fdda})
### Описание

`object event.acknowledge(объект/массив parameters)`

Этот метод позволяет обновлять события. Можно выполнить следующие действия обновления:

- Закрыть событие. Если событие уже решено, это действие будет пропущено.
- Подтвердить событие. Если событие уже подтверждено, это действие будет пропущено.
- Отменить подтверждение события. Если событие не подтверждено, это действие будет пропущено.
- Добавить сообщение.
- Изменить серьезность события. Если событие уже имеет ту же серьезность, это действие будет пропущено.
- Подавить событие. Если событие уже подавлено, это действие будет пропущено.
- Восстановить событие. Если событие не подавлено, это действие будет пропущено.

::: noteimportant
Можно обновлять только события триггера.\
Можно обновлять только проблемные события.\
Для закрытия события или изменения его серьезности требуются права на чтение/запись для триггера.\
Для закрытия события должна быть разрешена ручная закрытие в триггере.
:::

::: noteclassic
Этот метод доступен пользователям любого типа.
Разрешения на вызов метода можно отозвать в настройках ролей пользователя.
Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/96ece3aa-eed7fdda})

[comment]: # ({new-32560b88})
### Параметры

`(объект/массив)` Параметры, которые содержат ID событий и операции
обновления, которые необходимо выполнить.

|Параметр|Тип|Описание|
|----------------|------|----------------|
|**eventids**<br>(требуется)|строка/объект|ID подтверждаемых событий.|
|**action**<br>(требуется)|целое число|Действие(я) по обновлению событий. Это поле побитовой маски, принимается любая комбинация значений.<br><br>Возможные значения:<br>1 - закрыть проблемы;<br>2 - подтвердить событие;<br>4 - добавить сообщение;<br>8 - изменить важность.|
|message|строка|Текст сообщения.<br>**Требуется**, если действие имеет 'добавление сообщения' флаг.|
|severity|целое число|Новая важность событиям.<br>**Требуется**, если действие содержит 'изменить важность' флаг.<br><br>Возможные значения:<br>0 - не классифицировано;<br>1 - информационный;<br>2 - предупреждение;<br>3 - средняя;<br>4 - высокая;<br>5 - чрезвычайная.|

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

[comment]: # ({94f3ab84-94f3ab84})
### Возвращаемые значения

`(object)` Возвращает объект, который содержит ID обновленных событий, указанных в свойстве `eventids`.

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

[comment]: # ({b41637d2-b41637d2})
### Примеры

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

[comment]: # ({4089603e-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]: # ({/4089603e-9e923e4c})

[comment]: # ({8059d865-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]: # ({/8059d865-94e25d7e})

[comment]: # ({aadd99f7-aadd99f7})
### Источник

CEvent::acknowledge() в *ui/include/classes/api/services/CEvent.php*.

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