소명 요청 근거 로그 조회

소명 요청에 연결된 근거 로그를 조회합니다. 게스트 접근이 허용되므로 token 매개변수를 사용하여 세션 인증 없이 호출할 수 있습니다.

HTTP 요청

GET /api/sonar/explanation-requests/:guid/logs

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     "https://HOSTNAME/api/sonar/explanation-requests/49272877-75f2-4c2f-9301-d21c4f9a106d/logs?type=EXPLANATION&schema_code=firewall&limit=10&offset=0"

요청 매개변수

경로 매개변수

키	타입	설명	비고
guid	문자열	소명 요청 GUID	36자

쿼리 매개변수

키	필수	타입	설명	비고
type	O	문자열	소명 유형	`EXPLANATION`, `AUDITOR_COMMENT`, `MANAGER_COMMENT` 중 하나
token	X	문자열	게스트 접근 토큰	세션 인증 대신 사용 가능
schema_code	O	문자열	로그 스키마 코드
limit	O	32비트 정수	최대 건수	최대 `1000`
offset	O	64비트 정수	건너뛸 건수	`0` 이상

정상 응답

{
  "count": 2,
  "total_count": 15,
  "records": [
    {
      "_time": "2024-01-15 09:00:00+0900",
      "src_ip": "192.0.2.1",
      "dst_ip": "198.51.100.1",
      "action": "ALLOW"
    }
  ],
  "field_order": ["_time", "src_ip", "dst_ip", "action"]
}

count (32비트 정수): 현재 페이지의 레코드 수
total_count (32비트 정수): 전체 레코드 수
(배열) records: 근거 로그 레코드 목록
field_order (배열): 필드 순서 목록 (존재하지 않을 수 있음)

오류 응답

offset이 0 미만인 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "offset should be >= 0"
}

limit이 1000을 초과하는 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "limit should be <= 1000"
}

유효하지 않은 스키마 코드를 지정한 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "invalid schema code"
}