Sidebar
ru:manual:api:reference:event:acknowledge
Table of Contents
event.acknowledge
Описание
объект event.acknowledge(объект/массив параметры)
Этот метод позволяет подтверждать события и добавлять к этим подтверждениям сообщения. Тем не менее если событие уже подтверждено, всё же будет добавлено новое сообщение.
Этот метод позволять обновлять события. Можно выполнять следующие действия обновления:
- Закрыть событие. Если событие уже решено, это действие будет пропущено.
- Подтвердить событие. Если событие уже подтверждено, это действие будет пропущено.
- Добавление комментария
- Изменение важности события. Если событие уже с такой же важностью, это действие будет пропущено.
Можно подтверждать события только на триггеры.
Можно обновлять события только на триггеры.
Можно обновлять события только о проблемах.
Требуются права чтения/записи к триггеру, чтобы закрыть событие или изменить важность события.
Чтобы закрыть событие, эта функция должна быть разрешена в триггере.
Можно обновлять события только о проблемах.
Требуются права чтения/записи к триггеру, чтобы закрыть событие или изменить важность события.
Чтобы закрыть событие, эта функция должна быть разрешена в триггере.
Параметры
(объект/массив) Параметры, которые содержат ID событий и операции обновления, которые необходимо выполнить.
| Параметр | Тип | Описание |
|---|---|---|
| eventids (требуется) | строка/объект | ID подтверждаемых событий. |
| action (требуется) | целое число | Действие(я) по обновлению событий. Это поле побитовой маски, принимается любая комбинация значений. Возможные значения: 1 - закрыть проблемы; 2 - подтвердить событие; 4 - добавить сообщение; 8 - изменить важность. |
| message | строка | Текст сообщения. Требуется, если действие имеет 'добавление сообщения' флаг. |
| severity | целое число | Новая важность событиям. Требуется, если действие содержит 'изменить важность' флаг. Возможные значения: 0 - не классифицировано; 1 - информационный; 2 - предупреждение; 3 - средняя; 4 - высокая; 5 - чрезвычайная. |
Возвращаемые значения
(object) Возвращает объект, который содержит ID обновленных проблем под свойством eventids.
Примеры
Подтверждение события
Подтверждение с сообщением одного события.
Запрос:
{ "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() в frontends/php/include/classes/api/services/CEvent.php.