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",
"method": "event.acknowledge",
"params": {
"eventids": ["20427", "20428"],
"action": 12,
"message": "Maintenance required to fix it.",
"severity": 4
},
"id": 1
}
Ответ:
CEvent::acknowledge() в ui/include/classes/api/services/CEvent.php.