시나리오 예외 규칙 생성

지정한 탐지 시나리오에 새로운 예외 규칙을 등록합니다. 조건 트리(exprs)와 일치하는 이벤트는 유효 기간(valid_from-valid_until) 동안 탐지에서 제외됩니다.

필요 권한

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

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -d type="stream" \
     -d scenario_guid="a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
     -d description="사내 관리자 IP 제외" \
     -d 'exprs={"field":"src_ip","type":"IP","operator":"EQ","value":"203.0.113.10"}' \
     --data-urlencode 'valid_from=2026-06-01 00:00:00+0900' \
     --data-urlencode 'valid_until=2026-12-31 23:59:59+0900' \
     -X POST \
     https://HOSTNAME/api/sonar/exception-rules

요청 매개변수

exprs 객체 속성

exprs는 리프 노드(단일 조건) 또는 그룹 노드(조건 그룹) 중 하나의 형태를 가지는 JSON 객체입니다.

리프 노드(단일 조건)의 속성:

• field (문자열): 필드 이름. 영문자, 숫자, _, ., -만 사용 가능, 최대 128자
• type (문자열): 값 타입. STRING, NUMBER, BOOLEAN, IP 중 하나
• operator (문자열): 비교 연산자. type에 따라 사용 가능한 값이 다름(하단 표 참고)
• value: 비교 대상 값. operator가 IS_NULL, IS_NOT_NULL이면 생략, 그 외에는 필수(STRING은 문자열, NUMBER는 숫자, BOOLEAN은 불리언, IP는 IP 주소 문자열)

그룹 노드(조건 그룹)의 속성:

• operator (문자열): 그룹 연산자. AND, OR, NOT, SRC_IP, DST_IP, SRC_IP_DST_IP 중 하나
• operands (객체 배열): 하위 조건 목록(리프 노드 또는 그룹 노드). NOT은 1개, SRC_IP·DST_IP는 1개(field가 각각 src_ip, dst_ip이고 type이 IP, operator가 EQ 또는 NEQ인 리프 노드), SRC_IP_DST_IP는 2개(첫 번째 field는 src_ip, 두 번째는 dst_ip, 둘 다 type IP·operator EQ 또는 NEQ)여야 함

정상 응답

{
  "guid": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
}

• guid (문자열): 생성된 예외 규칙 GUID

오류 응답

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

HTTP 상태 코드 400 응답

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

type 값이 stream, batch가 아닌 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "No enum constant com.logpresso.sonar.api.exceptionrule.ExceptionRuleType.FOO"
}

description 값의 길이가 잘못된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'description' must be shorter than or equal to 2000 characters."
}

valid_from이 valid_until보다 늦은 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "valid_from should be earlier than valid_until"
}

조건 트리가 제약을 초과한 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "too many conditions: 51"
}

exprs의 field 형식이 올바르지 않은 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "invalid field format: src ip"
}

시나리오가 존재하지 않는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "scenario not found: a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

권한이 없는 경우

HTTP 상태 코드 500 응답

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