event.acknowledge

Описание

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

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

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

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

Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(объект/массив) Параметры, которые содержат 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
       }

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

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