예외 규칙 조회

지정한 예외 규칙의 상세 정보를 조회합니다.

필요 권한

사용자 이상의 계정으로 이용할 수 있습니다.

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     "https://HOSTNAME/api/sonar/exception-rules/a1b2c3d4-e5f6-7890-abcd-ef1234567890?type=stream&scenario_guid=4d2f8a31-9b21-4d12-8a90-7f1c1a2b3c4d"

요청 매개변수

경로 매개변수

요청 본문 매개변수

정상 응답

{
  "rule": {
    "guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "type": "STREAM",
    "description": "사내 정기 점검 IP 예외",
    "exprs": {
      "operator": "AND",
      "operands": [
        {
          "field": "src_ip",
          "type": "IP",
          "operator": "EQ",
          "value": "192.0.2.10"
        }
      ]
    },
    "valid_from": "2026-04-01T00:00:00+0900",
    "valid_until": "2026-05-01T00:00:00+0900",
    "created_at": "2026-04-15T09:00:00+0900",
    "user_guid": "e722b073-892a-4e9e-ba78-d556324a1a82",
    "user_name": "박현재",
    "scenario_guid": "4d2f8a31-9b21-4d12-8a90-7f1c1a2b3c4d",
    "scenario_name": "내부 IP 무단 접근"
  }
}

• rule (객체): 예외 규칙 정보. 존재하지 않으면 null
  • guid (문자열): 예외 규칙 고유 식별자
  • type (문자열): 시나리오 유형. STREAM, BATCH 중 하나
  • description (문자열): 메모
  • exprs (객체): 조건 트리. 구조는 예외 규칙 목록 조회 응답의 exprs 필드와 동일
  • valid_from (날짜): 유효 시작 일자 (yyyy-MM-dd'T'HH:mm:ssZ 형식)
  • valid_until (날짜): 유효 종료 일자 (yyyy-MM-dd'T'HH:mm:ssZ 형식)
  • created_at (날짜): 생성 일자 (yyyy-MM-dd'T'HH:mm:ssZ 형식)
  • user_guid (문자열): 생성자 GUID
  • user_name (문자열): 생성자 이름
  • scenario_guid (문자열): 시나리오 GUID
  • scenario_name (문자열): 시나리오 이름

오류 응답

필수 매개변수가 누락된 경우

HTTP 상태 코드 400 응답

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

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

HTTP 상태 코드 400 응답

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

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

HTTP 상태 코드 200 응답

{
  "rule": null
}

권한이 없는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "no-permission"
}