event.acknowledge

Описание

object 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
       }

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

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