시나리오 예외 규칙 일괄 삭제

지정한 탐지 시나리오에서 여러 개의 예외 규칙을 일괄 삭제합니다. 만료된 예외 규칙을 한 번에 정리하려면 만료된 예외 규칙 삭제 API를 사용하세요.

필요 권한

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

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -d type="stream" \
     -d scenario_guid="a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
     -d guids="b2c3d4e5-f6a7-8901-bcde-f12345678901" \
     -X DELETE \
     https://HOSTNAME/api/sonar/exception-rules

요청 매개변수

정상 응답

{
  "failures": []
}

• failures (객체 배열): 삭제하지 못한 예외 규칙 목록. 모두 삭제되면 빈 배열입니다
  • id (문자열): 삭제에 실패한 예외 규칙 GUID
  • reason (문자열): 실패 사유. 시나리오 자체가 존재하지 않으면 scenario-not-found(이 경우 guids로 지정한 모든 GUID가 실패 목록에 포함됩니다), 해당 시나리오에서 예외 규칙을 찾을 수 없으면 exception-rule-not-found입니다

일부 예외 규칙 삭제에 실패한 경우

HTTP 상태 코드 200 응답

{
  "failures": [
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "reason": "exception-rule-not-found"
    }
  ]
}

오류 응답

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

HTTP 상태 코드 400 응답

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

scenario_guid, guids가 GUID 형식이 아닌 경우

HTTP 상태 코드 400 응답

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

type 값이 stream, batch가 아닌 경우

HTTP 상태 코드 400 응답

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

권한이 없는 경우

HTTP 상태 코드 500 응답

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