Documentation for Axxon One 2.0. Documentation for other versions of Axxon One is [available too].

Previous page 캘린더 검색 API  검출 도구의 트리거 Next page

검출 도구의 트리거링

검출 도구 목록 가져오기

GET http://IP Address:port/prefix/detectors/{VIDEOSOURCEID}

{VIDEOSOURCEID} − 3부 구성 소스 엔드포인트 ID의 첫 번째 두 부분 (비디오 카메라 목록 및 정보 가져오기 참조). 예: "SERVER1/DeviceIpint.1".

샘플 요청:

GET http://127.0.0.1:80/detectors/SERVER1/DeviceIpint.1

샘플 응답:

{
    "detectors": [
        {
            "name": "hosts/SERVER1/AVDetector.1/EventSupplier",
            "type": "SceneDescription"
        },
        {
            "name": "hosts/SERVER1/AVDetector.12/EventSupplier",
            "type": "NullAudioDetection"
        }
    ]
}

Attention!

type 필드는 더 이상 사용되지 않습니다. 감지 도구에 대한 최신 정보를 얻으려면 /camera/list 요청을 사용하는 것이 좋습니다 (비디오 카메라 목록 및 정보 가져오기 참고).

type 매개변수의 사용 가능한 값:

type검출 도구
SceneDescription
장면 분석 검출 도구 
CrossOneLine라인 크로싱
moveInZone영역 내 움직임
StopInZone영역 내 정지
ComeInZone영역 내 등장
OutOfZone영역 내 사라짐
LongInZone배회
lostObject다중 객체
LprDetector번호판 인식
TvaFaceDetector얼굴 인식
PeopleCounter방문자 카운터
QueueDetector대기열 감지
FireDetector
화재 감지
SmokeDetector
연기 감지
NeuroCounter신경망 카운팅
SceneChange
위치 변화
QualityDegradation_v2
이미지 노이즈 감지
QualityDegradation
품질 저하
BlurredDegradation
흐린 이미지 감지
CompressedDegradation
압축 아티팩트 감지
MotionDetection
움직임 감지
NullAudioDetection
신호 없음
SignalAudioDetection
신호
NoiseAudioDetection
노이즈
PoseDetector자세 감지
RecumbentDetector넘어짐 감지
SitDownDetector앉은 사람 감지
HandsUpDetector손 든 사람 감지
WaterLevelDetector수위 감지
HandRailDetector난간 잡기 감지
PeopleCountDetectorBySkeleton사람 카운터
PeopleDistanceDetector가까이 서 있는 사람 감지
PoseMaskingDetector사람 마스킹

변조 검출 기능

서비스 오디오 검출 도구의 기능

장면 분석 검출 도구 구성

검출 도구 이벤트 목록 가져오기

GET http://IP Address:port/prefix/archive/events/detectors/{ENDTIME}/{BEGINTIME}—모든 Axxon 도메인 서버에서 감지 이벤트를 가져옵니다.

Attention!

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

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

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

GET http://IP Address:port/prefix/archive/events/detectors/{HOSTNAME}/{ENDTIME}/{BEGINTIME}—특정 서버에서 검출 이벤트 가져오기

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

GET http://IP Address:port/prefix/archive/events/detectors/{VIDEOSOURCEID}/{ENDTIME}/{BEGINTIME}—특정 카메라에서 검출 이벤트 가져오기

{VIDEOSOURCEID}—3부 구성 소스 엔드포인트 ID (비디오 카메라 목록 및 정보 가져오기 참조). 예: "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".

파라미터터필수설명
limitNo

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

offsetNo지정된 수만큼 결과가 오프셋됩니다. 예를 들어, offset=0으로 쿼리하여 100개의 결과를 반환했다면 다음 결과를 얻기 위해서는 offset=100으로 쿼리를 실행해야 합니다. 두 번째 쿼리가 250개의 결과를 반환했다면 다음 결과를 얻기 위해서는 offset=350으로 쿼리를 실행해야 합니다. 이와 같은 방식입니다.
typeNo

특정 감지 도구에서 감지 이벤트를 가져옵니다. type 매개변수의 값은 아래 표에 나와 있습니다.
여러 감지 도구에서 감지 이벤트를 가져오려면 쉼표로 구분하여 나열해야 합니다.

joinNo

join=1이면 응답에서 두 단계 이벤트가 병합되고, duration 매개변수가 이벤트 지속 시간에 해당하는 값으로 반환됩니다.

join=0이면 응답에서 두 단계 이벤트가 병합되지 않습니다.

limit_to_archiveNo

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

archiveNo

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

detectorNo

Axxon One 2.0부터

특정 검출 도구에서 감지 이벤트를 가져올 수 있으며 detector 매개변수의 값은 아래 표에 나와 있습니다.

샘플 요청:

  • http://127.0.0.1:80/archive/events/detectors/Server1/DeviceIpint.2/SourceEndpoint.video:0:0/past/future?limit=10&offset=0—특정 카메라에서 감지 이벤트 가져오기, 내림차순 정렬. 최대 제한은 10입니다.
  • http://127.0.0.1:80/archive/events/detectors/Server1/past/future?limit=5&offset=0—Server1의 모든 검출 도구에서 감지 이벤트 가져오기. 각 감지 도구에 대한 최대 제한은 5입니다.
  • http://127.0.0.1:80/archive/events/detectors/Server1/past/future?limit=5&offset=0&type=Ray—Server1의 모든 센서에서 감지 이벤트 가져오기. 각 센서에 대한 최대 제한은 5입니다.
  • http://127.0.0.1:80/archive/events/detectors/A-ZHUKOV/DeviceIpint.1/SourceEndpoint.video:0:0/future/past?limit=100&detector=hosts/Server1/AVDetector.1/EventSupplier—Server1의 특정 검출 도구에서 감지 이벤트 가져오기
  • http://root:root@127.0.0.1:80/archive/events/detectors/Server1/DeviceIpint.1/SourceEndpoint.video:0:0/20230323T112000.000/20230430T210000.000?limit=100&offset=0&type=listed_face_detected,MotionDetected—Server1의 여러 감지 도구에서 감지 이벤트 가져오기. 감지 도구는 쉼표로 구분하여 나열해야 합니다.
  • http://127.0.0.1:80/archive/events/detectors/past/future?limit=1&type=Ray—Axxon 도메인의 모든 센서에서 현재 상태 가져오기

Attention!

첫 번째 요청에서는 past/future 매개변수를 사용하는 것이 좋습니다. 이후에는 가장 최근 기록의 타임스탬프를 얻어 이를 사용하여 후속 기록을 요청해야 합니다. 이후 요청에서 past/future 매개변수와 limit, offset 매개변수를 함께 사용하면 중복된 기록이 반환될 수 있습니다.

샘플 응답:

1) join=1

{
    "events": [
        {
            "duration": "000000.467000",
            "id": "09b8729a-a6fc-4ffa-8a83-aebc5c19d171",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [
                {
                    "bottom": "0.20831976890563964",
                    "index": "0",
                    "left": "0.57320795059204099",
                    "right": "0.6804207420349121",
                    "top": "0.09125151634216308"
                }
            ],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T112815.527000",
            "type": "moveInZone"
        },
        {
            "duration": "000004.154000",
            "id": "90c5d09e-c0bb-4c49-bf8b-22d3afffe8c1",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [
                {
                    "bottom": "0.72451157569885249",
                    "index": "0",
                    "left": "0.092941055297851571",
                    "right": "0.24284084320068361",
                    "top": "0.4965816402435303"
                }
            ],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T112814.426000",
            "type": "moveInZone"
        },
        {
            "duration": "000005.155000",
            "id": "dc953fad-bb08-4bae-bdce-62a09ab2dbd9",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [
                {
                    "bottom": "0.37916545867919921",
                    "index": "0",
                    "left": "0.10621988296508789",
                    "right": "0.2311831474304199",
                    "top": "0.11115360260009766"
                }
            ],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T112814.293000",
            "type": "moveInZone"
        },
        {
            "duration": "000003.170000",
            "id": "f00875f0-bad7-4e74-879c-0a564baa9d36",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [
                {
                    "bottom": "0.2848846626281738",
                    "index": "0",
                    "left": "0.11811468601226806",
                    "right": "0.18662774562835693",
                    "top": "0.11245393753051756"
                }
            ],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T112813.358000",
            "type": "moveInZone"
        }
    ],
    "more": true
}

2) join=0

{
 "events": [
  {
   "alertState": "ended",
   "id": "cd3571bb-73c1-45cb-8965-a01e167836db",
   "multiPhaseSyncId": "6d72973d-7188-4fa7-9bf9-e3ba6013f2e3",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125142.417000",
   "type": "moveInZone"
  },
  {
   "alertState": "began",
   "id": "310ce582-5f0d-4c27-a1d5-b14ccc5a877d",
   "multiPhaseSyncId": "6d72973d-7188-4fa7-9bf9-e3ba6013f2e3",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [
    {
     "bottom": "0.46943313598632813",
     "index": "0",
     "left": "0.14642228603363036",
     "right": "0.23025640964508054",
     "top": "0.027766456604003897"
    }
   ],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125142.200000",
   "type": "moveInZone"
  },
  {
   "alertState": "began",
   "id": "aa193bbc-89e8-4204-8805-ac8c915b323c",
   "multiPhaseSyncId": "807248bf-4cee-431e-a29f-18ee0ed911ce",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [
    {
     "bottom": "0.36835212707519532",
     "index": "0",
     "left": "0.072501201629638662",
     "right": "0.19335731506347656",
     "top": "0.03212909698486327"
    }
   ],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125141.966000",
   "type": "moveInZone"
  },
  {
   "alertState": "ended",
   "id": "5b15234d-2a7f-415f-af57-2ac1ce5aa75a",
   "multiPhaseSyncId": "17fca913-f7a3-4f29-997f-d02a575d9fc4",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125136.978000",
   "type": "moveInZone"
  },
  {
   "alertState": "ended",
   "id": "48882f92-a809-424c-b7a7-55ac56b05061",
   "multiPhaseSyncId": "8bb9edbe-4391-4c26-8c7a-7faf620a62eb",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125136.661000",
   "type": "moveInZone"
  },
  {
   "alertState": "ended",
   "id": "6e98f979-c4f4-4c78-bbf4-6fc268219d79",
   "multiPhaseSyncId": "92534e2f-0f88-4698-a1a2-4e70d10cb00a",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125136.477000",
   "type": "moveInZone"
  },
  {
   "alertState": "ended",
   "id": "c9dff8bc-423b-414b-8dee-0a0b119a43df",
   "multiPhaseSyncId": "c8785151-f344-4c21-88de-6c339139afdf",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125135.843000",
   "type": "moveInZone"
  },
  {
   "alertState": "ended",
   "id": "db1f1147-ed50-46ff-84b7-8f06676d8f8e",
   "multiPhaseSyncId": "7eceb0b4-c04d-4e17-a405-3aff419fd94a",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125135.677000",
   "type": "moveInZone"
  },
  {
   "alertState": "began",
   "id": "f9ccceda-9e16-4832-9f1f-1270fd0be365",
   "multiPhaseSyncId": "17fca913-f7a3-4f29-997f-d02a575d9fc4",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [
    {
     "bottom": "0.30296741485595702",
     "index": "0",
     "left": "0.14849423646926879",
     "right": "0.21262614011764525",
     "top": "0.092105445861816404"
    }
   ],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125135.677000",
   "type": "moveInZone"
  },
  {
   "alertState": "began",
   "id": "87ca4e1e-4a8c-433a-8b67-6e73f65fa0e2",
   "multiPhaseSyncId": "7eceb0b4-c04d-4e17-a405-3aff419fd94a",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [
    {
     "bottom": "0.22597263336181642",
     "index": "0",
     "left": "0.080717468261718744",
     "right": "0.19577339172363281",
     "top": "0.014194698333740235"
    }
   ],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125134.909000",
   "type": "moveInZone"
  }
 ],
 "more": true
}                            

Attention!

기본적으로 요청 타임아웃은 10초입니다.

서버가 10초 이내에 모든 이벤트(수량은 limit 매개변수에 설정됨)를 반환하지 못하면, 응답은 다음과 같습니다:

{
   "events": [],
   "more": false
}

이 경우, 요청을 반복하고 limit 매개변수의 값을 줄여야 합니다.


Note

multiPhaseSyncId 매개변수는 alertState 매개변수가 있는 이중 단계 알람에 대해서만 응답에 포함됩니다.

timestamp 필드는 고유하지 않으므로 검색 간격부터 시작하여 이전에 수신한 알람을 건너뛰어야 할 수 있습니다.

대기열 감지 도구 트리거링을 요청할 때, 응답에는 최소값과 최대값으로 표현된 큐 길이 추정값을 포함하는 추가 매개변수가 포함됩니다.

       {
            "alertState": "happened",
            "extra": [
                {
                    "queueMax": "4"
                },
                {
                    "queueMin": "4"
                }
            ],
            "id": "b17129b2-1588-794b-94f6-d078a226efb2",
            "origin": "hosts/Server1/AVDetector.4/EventSupplier",
            "rectangles": [],
            "source": "hosts/Server1/DeviceIpint.2/SourceEndpoint.video:0:0",
            "timestamp": "20181206T075621.621000",
            "type": "QueueDetected"
        }
}

번호판 인식에서 감지 결과를 요청할 때, 응답에는 인식된 번호판을 유니코드 형식으로 포함하는 추가 plate 매개변수가 포함됩니다.

  "alertState" : "happened",
            "id" : "f1f334a3-3fb3-4770-80bf-c6519240b5cf",
            "origin" : "hosts/Server1/AVDetector.1/EventSupplier",
            "plate" : "\u0045\u0041\u0033",
            "rectangles" :
            [
                {
                    "bottom" : 0.70833333333333337,
                    "index" : 0,
                    "left" : 0.4597222222222222,
                    "right" : 0.67222222222222228,
                    "top" : 0.64409722222222221
                }
            ],
            "source" : "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp" : "20230725T140945.208000",
            "type" : "plateRecognized"
        }

type 매개변수의 가능한 값들:

검출 도구type
Scene Analytics detection tools–
Line crossingoneLine
Motion in areamoveInZone
Stop in areastopInZone
Appearance in areacomeInZone
Disappearance in areaoutOfZone
LoiteringlongInZone
Multiple objectslostObject
Number Plate RecognitionplateRecognized
Number Plate Recognition (from the list)listed_lpr_detected
Face detectionfaceAppeared
Face detection (from the list)listed_face_detected
Visitors counterPeopleIn, PeopleOut
Queue detectionQueueDetected
Fire detectionFireDetected
Smoke detectionSmokeDetected
Neural countinglotsObjects
Position changeSceneChangeDetected
Image Noise DetectionCameraBlindDetected
Loss of qualityImageDegradation
Blurred Image DetectionBlurredDegradation
Compression Artifacts DetectionCompressedDegradation
Motion detectionMotionDetected
No signalNullAudio
SignalSignalAudio
Noise

NoiseAudio

Pose detection–
Man down detectionrecumbent
Sitting person detectionsitDown
Hands up detectionhandsUp
Water level detectionLevelOut
Handrail holding detectionhandRail
People counterlotsObjects
Close-standing people detectionpeopleDistance
People maskingenabledMaskEvents

detector 매개변수의 가능한 값들:

detector

검출 도구
SceneDescriptionScene Analytics detection tools
CrossOneLineLine crossing
moveInZoneMotion in area
StopInZoneStop in area
ComeInZoneAppearance in area
OutOfZoneDisappearance in area
LongInZoneLoitering
lostObjectMultiple objects
LprDetectorNumber Plate Recognition
TvaFaceDetectorFace detection
PeopleCounterVisitors counter
QueueDetectorQueue detection
FireDetectorFire detection
SmokeDetectorSmoke detection
NeuroCounterNeural counting
SceneChangePosition change
QualityDegradationLoss of quality
QualityDegradation_v2

Image Noise Detection

BlurredDegradationBlurred Image Detection
CompressedDegradationCompression Artifacts Detection
MotionDetectionMotion detection
NullAudioDetectionNo signal
SignalAudioDetectionSignal
NoiseAudioDetection

Noise

PoseDetectorPose detection
RecumbentDetectorMan down detection
SitDownDetectorSitting person detection
HandsUpDetectorHands up detection
ActiveShooterDetectorShooter detection
WaterLevelDetectorWater level detection
HandRailDetectorHandrail holding detection
PeopleCountDetectorBySkeletonPeople counter
PeopleDistanceDetectorClose-standing people detection
PoseMaskingDetectorPeople masking

Attention!

  • 검출 도구 트리거링 유형의 대소문자 구분은 보장되지 않습니다. 예를 들어, 'ComeInZone', 'comeInZone', 'COMEINZOne' 값은 동일한 것으로 간주됩니다.
  • 리스트에 포함되지 않은 값을 받은 경우, 내장된 검출 도구가 트리거된 것입니다.

시스템 로그에서 감사 로그 이벤트 가져오기

GET http://IP-address:port/prefix/audit/{HOSTNAME}/{ENDTIME}/{BEGINTIME}

{HOSTNAME} − 서버 이름

Note

ENDTIME과 BEGINTIME 구문은 Get MM archive contents 섹션에 설명되어 있습니다.

Attention!

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

ENDTIME > BEGINTIME 일 경우, 이벤트는 내림차순으로 정렬됩니다.

파라미터필수설명

filter

No

다음은 <->  <:> 로 구분된 범위 또는 간단한 코드로 모두 표현할 수 있는 이벤트 목록입니다.

이벤트 유형 목록:

1 − 이벤트 로그에 표시되지 않음
2 − 감사 이벤트의 BOT 위반 (예: 수동으로 경계가 설정됨)
3 − 감사 이벤트의 EOT 위반 (예: 수동으로 경계가 설정됨)
4 − 일부 감사 이벤트가 누락됨 (예: 수동으로 삭제됨)
5 − 테이블 항목 변경됨
6 − 비활성 로그 (이벤트 없음 또는 로그 업데이트 표시)
/// 외부 이벤트
7 − 사용자 추가됨
8 − 사용자 삭제됨
9 − 사용자 매개변수 변경됨
10 − 역할 추가됨
11 − 역할 삭제됨
12 − 역할 매개변수 변경됨
13 − 사용자 로그인
14 − 사용자 로그아웃
15 − 장치 추가됨
16 − 장치 삭제됨
17 − 장치 매개변수 변경됨
18 − 탐지 항목 추가됨
19 − 탐지 항목 삭제됨
20 − 탐지 매개변수 변경됨
21 − 아카이브 추가됨
22 − 아카이브 삭제됨
23 − 아카이브 매개변수 변경됨
24 − 탐지 규칙(매크로) 생성됨
25 − 탐지 규칙(매크로) 삭제됨
26 − 탐지 규칙(매크로) 매개변수 변경됨
27 − 경고 발생됨
28 − 구역이 활성화됨
29 − 구역이 비활성화됨
30 − 아카이브에서 내보내기 수행됨
31 − 알림 발신자(소리, 이메일 등) 추가됨
32 − 알림 발신자 삭제됨
33 − 알림 발신자 매개변수 변경됨
34 − 일반 매개변수 변경됨
35 − 아카이브 기록 매개변수 변경됨
36 − 내보내기 에이전트 추가됨
37 − 내보내기 에이전트 삭제됨
38 − 내보내기 에이전트 매개변수 변경됨
39 − 매크로 생성됨
40 − 매크로 삭제됨
41 − 매크로 매개변수 변경됨
42 − 사용자가 경고를 처리함
43 − 위험한 경고
44 − 의심스러운 경고
45 − 허위 경고
46 − 경고가 건너뛰어짐
47 − 서버가 Axxon 도메인에 포함됨
48 − 서버가 Axxon 도메인에서 제외됨
49 − 아카이브 보기
50 − 카메라 보기
51 − 레이아웃 보기
52 − 아카이브에서 포렌식 검색
53 − 아카이브에서 얼굴을 통한 지역 검색
54 − 아카이브에서 번호판을 통한 지역 검색
55 − 시스템 로그 내보내기
56 − LDAP 폴더 추가됨
57 − LDAP 폴더 삭제됨
58 − LDAP 폴더 매개변수 변경됨
59 − 레이아웃 생성됨
60 − 레이아웃 삭제됨
61 − 레이아웃 변경됨
62 − 사용자 로그인 실패
63 − PTZ 제어
64 − 아카이브 댓글 추가됨
65 − 아카이브 댓글 변경됨
66 − 라이선스 만료됨
67 − 사용자 비활성화로 로그아웃
68 − 사용자 비활성화로 클라이언트 차단됨
69 − 사용자가 클라이언트 잠금 해제
70 − 사용자가 클라이언트 차단
71 − 예기치 않은 클라이언트 종료

샘플 요청:

GET http://127.0.0.1:80/audit/SERVER1/past/future?filter=17-20,6,1:4

샘플 응답:

{
  "events": [
    {
      "data": {
        "component": "Camera3",
        "componentType": "camera",
        "device": "Camera3",
        "host": "SERVER1",
        "property": "vstream-virtual/folder",
        "setting": "Directory",
        "value": "D:/Movies/Spirit"
      },
      "eventType": 17,
      "timestamp": "20161205T120410.698000"
    },
    {
      "data": {
        "detector": "Face detection",
        "device": "Camera1",
        "host": "SERVER1"
      },
      "eventType": 18,
      "timestamp": "20161205T120459.319000"
    }
  ]
}

알람 목록 가져오기

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

Note

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

Attention!

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

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

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

{HOSTNAME} − 서버 이름 (서버 목록 가져오기 참조)

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

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

파라미터필수설명
limitNo

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

offsetNo

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

limit_to_archiveNo

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

archiveNo

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

샘플 요청:

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.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
}
파라미터설명
raisedAt

raisedAt 필드는 고유하지 않으므로 검색 간격부터 이전에 수신한 알람을 건너뛰어야 할 수 있습니다.

reasons

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

severity

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

initiator

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

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

Content

  • No labels

검출 도구의 트리거

시스템 로그에서 감사 이벤트 가져오기

알람 목록 가져오기