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/Server1/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/Server1/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/Server1/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:

  1. Имя пользователя, инициировавшего тревогу.
  2. Id макрокоманды (см. Макрокоманды), если тревога инициирована макрокомандой, которая была запущена не детектором. При этом следует иметь в виду, что данная макрокоманда может быть уже удалена из конфигурации.
  3. Тип детектора, который вызвал сработку макрокоманды, которая инициировала тревогу (см. Получение списка событий детекторов).
  • No labels

Предыдущая страница Получение списка событий детекторов  Получение событий аудита из системного журнала Следующая страница