alert.get

Описание

integer/array alert.get(объект parameters)

Метод позволяет получать оповещения по заданным параметрам.

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

Параметры

(object) Параметры, определяющие желаемый вывод.

Метод поддерживает следующие параметры.

Параметр Тип Описание
alertids ID/array Возвращать только оповещения с указанными ID.
actionids ID/array Возвращать только оповещения, созданные указанными действиями.
eventids ID/array Возвращать только оповещения, созданные указанными событиями.
groupids ID/array Возвращать только оповещения, созданные объектами из указанных групп узлов сети.
hostids ID/array Возвращать только оповещения, созданные объектами из указанных узлов сети.
mediatypeids ID/array Возвращать только оповещения сообщений, в которых использовались указанные типы медиа.
objectids ID/array Возвращать только оповещения, созданные указанными объектами
userids ID/array Возвращать только оповещения сообщений, которые были отправлены указанным пользователям.
eventobject integer Возвращать только оповещения, созданные событиями, связанными с объектами указанного типа.

Список поддерживаемых типов объектов см. в object события.

По умолчанию: 0 - триггер.
eventsource integer Возвращать только оповещения, созданные событиями указанного типа.

Список поддерживаемых типов событий см. в source события.

По умолчанию: 0 - события триггера.
time_from timestamp Возвращать только оповещения, которые были созданы после указанного времени.
time_till timestamp Возвращать только оповещения, которые были созданы до указанного времени.
selectHosts query Возвращать свойство hosts с данными узлов сети, которые запустили операцию действия.
selectMediatypes query Возвращать свойство mediatypes с массивом типов медиа, которые использовались для оповещения сообщения.

Ограничения в зависимости от типа пользователя см. в mediatype.get.
selectUsers query Возвращать свойство users с массивом пользователей, которым было адресовано сообщение.

Ограничения в зависимости от типа пользователя см. в user.get.
sortfield string/array Сортировать результат по указанным свойствам.

Возможные значения: alertid, clock, eventid, mediatypeid, sendto, status.
countOutput boolean Эти параметры описаны в комментарии к справочнику.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

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

(integer/array) Возвращает:

  • · массив объектов;
  • · количество извлеченных объектов, если использовался параметр countOutput.

Примеры

Получение оповещений по ID действия

Получить все оповещения, сгенерированные действием "3".

Запрос:

{
    "jsonrpc": "2.0",
    "method": "alert.get",
    "params": {
        "output": "extend",
        "actionids": "3"
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "alertid": "1",
            "actionid": "3",
            "eventid": "21243",
            "userid": "1",
            "clock": "1362128008",
            "mediatypeid": "1",
            "sendto": "[email protected]",
            "subject": "PROBLEM: Агент Zabbix на Linux-сервере недоступен в течение 5 минут: ",
            "message": "Триггер: Агент Zabbix на Linux-сервере недоступен в течение 5 минут: \nСостояние триггера: PROBLEM\nВажность триггера: Не классифицировано",
            "status": "0",
            "retries": "3",
            "error": "",
            "esc_step": "1",
            "alerttype": "0",
            "p_eventid": "0",
            "acknowledgeid": "0"
        }
    ],
    "id": 1
}

См. также

Источник

CAlert::get() в ui/include/classes/api/services/CAlert.php.