Получение списка тревог

GET http://IP-адрес:порт/префикс/archive/events/alerts/{ENDTIME}/{BEGINTIME} - получение тревог со всех Серверов Axxon-домена.

Примечание

Синтаксис ENDTIME и BEGINTIME описан в разделе Получение содержания архивов

Внимание!

Если в запросе ENDTIME < BEGINTIME, то события в ответе будут отсортированы по возрастанию времени.

Если ENDTIME > BEGINTIME, то сортировка будет по убыванию.

GET http://IP-адрес:порт/префикс/archive/events/alerts/{HOSTNAME}/{ENDTIME}/{BEGINTIME} - получение тревог с конкретного Сервера.

{HOSTNAME} - имя Сервера (см. Получение списка серверов).

GET http://IP-адрес:порт/префикс/archive/events/alerts/{VIDEOSOURCEID}/{ENDTIME}/{BEGINTIME} - получение тревог с конкретной видеокамеры.

{VIDEOSOURCEID} - трехкомпонентный идентификатор endpoint-а источника (см. Получение списка источников видео (камер)). Например, "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".

Параметр	Обязательный	Описание
limit	Нет	Лимит тревог в ответе. Если не задан, по умолчанию 100.
offset	Нет	Смещение результатов выдачи на заданное число. Например, если запрос с offset=0 вернул 100 результатов, то для получения следующих необходимо выполнить запрос с offset=100. Если на второй запрос было возвращено 250 результатов, то для получения следующих требуется задать в запросе offset=350 и т.д.
limit_to_archive	Нет	Доступен, начиная с Axxon Next 4.4.1.9150. Если limit_to_archive=1, то ответ вернет события только из доступной части архива (см. Настройка ограничения доступности архива).
archive	Нет	Доступен, начиная с Axxon Next 4.4.1.9150. Имя архива из запроса получения списка архивов (см. Получение содержания архивов).

Пример запроса:

GET http://127.0.0.1:80/archive/events/alerts/Server1/past/future?limit=50&offset=0

Пример ответа:

{
    "events": [
        {
            "type": "alert",
            "id": "2bb7f765-eb57-604d-a38c-d1d26d22e4d9",
            "raisedAt": "20181219T151437.312808",
            "zone": "hosts/DESKTOP-O0P0IBQ/DeviceIpint.1/SourceEndpoint.video:0:0",
            "reasons": [
                "ruleAlert",
                "videoDetector"
            ],
            "initiator": "faceAppeared",
            "reaction": {
                "user": "",
                "reactedAt": "20181219T151937.342036",
                "severity": "unclassified"
            },
            "detectorName": "1.Детектор лиц",
            "rectangles": [
                {
                    "index": "47",
                    "left": "0,85343749999999996",
                    "top": "0,37958333333333333",
                    "right": "1",
                    "bottom": "0,58083333333333331"
                }
            ]
        },
        {
            "type": "alert",
            "id": "03c0d49f-5475-684e-a622-2aaeac303508",
            "raisedAt": "20181219T151005.933417",
            "zone": "hosts/DESKTOP-O0P0IBQ/DeviceIpint.1/SourceEndpoint.video:0:0",
            "reasons": [
                "ruleAlert",
                "videoDetector"
            ],
            "initiator": "faceAppeared",
            "reaction": {
                "user": "root",
                "reactedAt": "20181219T151013.109256",
                "severity": "alarm"
            },
            "detectorName": "1.Детектор лиц",
            "rectangles": [
                {
                    "index": "9",
                    "left": "0,83406249999999993",
                    "top": "0,36416666666666664",
                    "right": "1",
                    "bottom": "0,58583333333333332"
                }
            ]
        },
        {
            "type": "alert",
            "id": "6d396f93-4acf-c54b-a26e-c1ab178bdb06",
            "raisedAt": "20181219T150911.101417",
            "zone": "hosts/DESKTOP-O0P0IBQ/DeviceIpint.1/SourceEndpoint.video:0:0",
            "reasons": [
                "userAlert"
            ],
            "initiator": "root",
            "reaction": {
                "user": "root",
                "reactedAt": "20181219T150916.264631",
                "severity": "alarm"
            },
            "detectorName": "",
            "rectangles": []
        }
    ],
    "more": false
}

Параметр	Описание
raisedAt	Поле raisedAt не уникальное, поэтому может понадобиться пропуск уже полученных ранее тревог от начала интервала поиска.
reasons	Возможные значения в массиве reasons: armed, disarmed, userAlert, ruleAlert, videoDetector, audioDetector, ray.
severity	Возможные значения поля severity: unclassified, false, notice, warning, alarm.
initiator:	Возможные значения поля initiator: Имя пользователя, инициировавшего тревогу. Id макрокоманды (см. Макрокоманды), если тревога инициирована макрокомандой, которая была запущена НЕ детектором. При этом следует иметь в виду, что данная макрокоманда может быть уже удалена из конфигурации. Тип детектора, который вызвал сработку макрокоманды, которая инициировала тревогу (см. Получение списка срабатываний детекторов).

Page tree

Документация для версии Axxon Next 4.6.0. Документация на другие версии также доступна.