Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.

event.acknowledge

Описание

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

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

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

Обновляться могут только события триггера.
Обновляться могут только события проблем.
Права на чтение/запись для триггера необходимы для закрытия события или изменения серьезности события.
Чтобы закрыть событие, в триггере должно быть разрешено закрытие вручную.

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

Параметры

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

Параметр Тип Описание
eventids string/object ID событий для подтверждения.

Поведение параметра:
- обязательно
action integer Действие(я) по обновлению события.
Это поле битовой маски, допускается любая комбинация возможных значений битовой карты.

Возможные значения битовой карты:
1 - закрыть проблему;
2 - подтвердить событие;
4 - добавить сообщение;
8 - изменить серьезность;
16 - отменить подтверждение события;
32 - подавить событие;
64 - отменить подавление события;
128 - изменить ранг события на причину;
256 - изменить ранг события на симптом.

Поведение параметра:
- обязательно
cause_eventid string ID события-причины.

Поведение параметра:
- обязательно, если action содержит бит "изменить ранг события на симптом"
message string Текст сообщения.

Поведение параметра:
- обязательно, если action содержит бит "добавить сообщение"
severity integer Новая серьезность для событий.

Возможные значения:
0 - не классифицировано;
1 - информация;
2 - предупреждение;
3 - средняя;
4 - высокая;
5 - чрезвычайная.

Поведение параметра:
- обязательно, если action содержит бит "изменить серьезность"
suppress_until integer Unix временная метка, до которой событие должно быть подавлено.

Если установлено значение "0", подавление будет бессрочным.

Поведение параметра:
- обязательно, если action содержит бит "подавить событие"

Возвращаемые значения

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

Примеры

Подтверждение события

Подтвердите одно событие и оставьте сообщение.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "event.acknowledge",
           "params": {
               "eventids": "20427",
               "action": 6,
               "message": "Problem resolved."
           },
           "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
           },
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "eventids": [
                   "20427",
                   "20428"
               ]
           },
           "id": 1
       }

Источник

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