배치 탐지 시나리오 실행

지정한 배치 탐지 시나리오를 즉시 실행합니다. 시스템은 배치 탐지 시나리오 쿼리를 비동기적으로 실행하므로 쿼리 완료를 대기하지 않고 응답합니다. 아래의 경우에는 실행하더라도 이벤트나 티켓이 발생하지 않습니다:

  • 배치 시나리오가 비활성화된 경우
  • 쿼리 실행 중에 배치 시나리오가 삭제된 경우

필요 권한

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

HTTP 요청

POST /api/sonar/batch-rules/:guid/run
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
     -X POST \
     https://HOSTNAME/api/sonar/batch-rules/c4ca4744-f310-4480-baa8-0548067abfb3/run
요청 매개변수
필수타입설명비고
guidO문자열배치 탐지 시나리오 GUID36자

정상 응답

{}

오류 응답

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

HTTP 상태 코드 400 응답

{
    "error_code": "invalid-param-type",
    "error_msg": "guid should be guid type."
}
시나리오가 존재하지 않는 경우

HTTP 상태 코드 500 응답

{
    "error_code": "illegal-state",
    "error_msg": "batch rule not found: 05efb651-9644-4518-950f-dbd648c973a7"
}