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
       }

Изменение важности события

Изменение важности нескольких событий и добавление сообщения.