Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

GET http://IPaddress:port/prefix/archive/events/alerts/{ENDTIME}/{BEGINTIME} − get alarms from all Axxon domain Servers모든 Axxon 도메인 서버에서 알람을 가져옵니다.

Info
titleNote

The ENDTIME and BEGINTIME syntax is described inENDTIME과 BEGINTIME 구문은 아카이브 내용 가져오기 section 섹션에 설명되어 있습니다.


Note
titleAttention!

요청에서 ENDTIME이 BEGINTIME보다 작으면, 응답의 이벤트는 시간 순으로 오름차순 정렬됩니다.

ENDTIME이 BEGINTIME보다 크면, 이벤트는 내림차순으로 정렬됩니다

If ENDTIME < BEGINTIME in the request, then the events in the response will be sorted by time in ascending order.

If ENDTIME > BEGINTIME, then the events will be sorted in descending order.

GET http://IPaddress:port/prefix/archive/events/alerts/{HOSTNAME}/{ENDTIME}/{BEGINTIME} − get alarms from a certain Server.특정 서버에서 알람을 가져오기

Tip

{HOSTNAME} Server name 서버 이름 (see 서버 목록 가져오기 참조).

GET http://IPaddress:port/prefix/archive/events/alerts/{VIDEOSOURCEID}/{ENDTIME}/{BEGINTIME} − get alarms from a certain camera.특정 카메라에서 알람을 가져오기

Tip

{VIDEOSOURCEID} three-component source endpoint 세 구성 요소 소스 엔드포인트 ID (see 비디오 카메라 목록 및 정보 가져오기 참조). For instance, 예: "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".


Parameter
파라미터
Required
필수
Description
설명
limitNo
The limit of alarms in the response. If not specified, it is equal to 100 by default, etc

응답에서 알람의 제한. 지정하지 않으면 기본값은 100입니다.

offsetNo
The results offset by the specified number. For example, if a query with offset=0 returned 100 results, then in order to get the next results, it is necessary to run a query with offset=100. If the second query returned 250 results, then in order to get the next results, it is necessary to run a query with offset=350

지정된 숫자만큼 결과가 오프셋됩니다. 예를 들어, offset=0인 쿼리가 100개의 결과를 반환했다면, 다음 결과를 얻으려면 offset=100으로 쿼리를 실행해야 합니다. 만약 두 번째 쿼리가 250개의 결과를 반환했다면, 다음 결과를 얻으려면 offset=350으로 쿼리를 실행해야 합니다. 계속해서 같은 방식으로 진행됩니다.

limit_to_archiveNo
If 

limit_to_archive=1

, then the response will return the events only from the accessible part of the archive (see Configuring access restrictions to archive

경우, 응답은 접근 가능한 아카이브 부분에서만 이벤트를 반환합니다 (아카이브 접근 제한 구성 참조).

archiveNo
The name of the archive from the request to receive the list of archives (see 

아카이브 목록을 받기 위한 요청에서 아카이브의 이름을 지정합니다 (아카이브 내용 가져오기 참조).

Sample request샘플 요청:

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

Sample response샘플 응답:

Code Block
{
    "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.Face detection",
            "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.Face detection",
            "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
}


Parameter파라미터Description설명
raisedAt

Field raisedAt is not unique so it might be necessary to skip the previously received alarms starting from the search intervalraisedAt필드는 고유하지 않으므로 검색 간격부터 이전에 수신한 알람을 건너뛰어야 할 수 있습니다.

reasons

Possible values of the reasons arrayreasons 배열의 가능한 값은 다음과 같습니다: armed, disarmed, userAlert, ruleAlert, videoDetector, audioDetector, ray.

severity

Possible values of the severity fieldseverity 필드의 가능한 값은 다음과 같습니다: unclassified, false, notice, warning, alarm.

initiator

initiator 필드의 가능한 값은 다음과 같습니다:

  1. 알람을 시작한 사용자의 이름
  2. 알람이 매크로에 의해 시작된 경우, 매크로의 Id (Using macros 참조) (매크로가 탐지기에 의해 시작되지 않았더라도, 해당 매크로가 이미 구성에서 삭제된 경우에도 적용됨)
  3. 알람을 시작한 매크로를 트리거한 검출기의 종류 (

Possible values of the initiator field:

  1. Name of the user initiated the alarm.
  2. Id of the macro (see Using macros) if the alarm is initiated by macro that was started NOT by the detector (even if this macro has already been removed from the configuration).
  3. Type of detector that triggered macro that initiated the alarm (see 검출 도구 이벤트 목록 가져오기 참조).