예외 규칙 조회

지정한 시나리오 예외 규칙을 조회합니다.

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     "https://HOSTNAME/api/sonar/exception-rules/a1b2c3d4-e5f6-7890-abcd-ef1234567890?type=STREAM&scenario_guid=b2c3d4e5-f6a7-8901-bcde-f12345678901"

요청 매개변수

경로 매개변수

쿼리 매개변수

정상 응답

{
  "rule": {
    "guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "type": "STREAM",
    "description": "테스트 서버 예외 처리",
    "exprs": {
      "operator": "and",
      "operands": [
        {
          "field": "src_ip",
          "type": "ip",
          "operator": "eq",
          "value": "192.0.2.1"
        }
      ]
    },
    "valid_from": "2025-01-01 00:00:00+0900",
    "valid_until": "2025-12-31 23:59:59+0900",
    "created_at": "2025-01-01 00:00:00+0900",
    "user_guid": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
    "user_name": "관리자",
    "scenario_guid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "scenario_name": "DMZ 포트 스캔"
  }
}

• rule (객체): 예외 규칙. 존재하지 않으면 null.
  • guid (문자열): 예외 규칙 GUID
  • type (문자열): 유형. STREAM 또는 BATCH.
  • description (문자열): 메모
  • exprs (객체): 조건 트리
  • valid_from (날짜): 유효 시작 일자
  • valid_until (날짜): 유효 종료 일자
  • created_at (날짜): 생성일시
  • user_guid (문자열): 생성한 사용자 GUID
  • user_name (문자열): 생성한 사용자 성명
  • scenario_guid (문자열): 시나리오 GUID
  • scenario_name (문자열): 시나리오 이름

오류 응답

지정한 예외 규칙이 존재하지 않는 경우

HTTP 상태 코드 200 응답

{
  "rule": null
}

식별자가 GUID 형식이 아닌 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-param-type",
  "error_msg": "guid should be guid type."
}

유형이 누락된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "null-argument",
  "error_msg": "type should be not null"
}