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

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

Примечание

Синтаксис 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	Нет	Если limit_to_archive=1, то ответ вернет события только из доступной части архива (см. Настройка ограничения доступности архива).
archive	Нет	Имя архива из запроса получения списка архивов (см. Получение содержания архивов).

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

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

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