수집기 그룹 일괄 삭제

지정한 수집기 그룹을 일괄 삭제합니다. 삭제에 실패한 항목은 failures 배열에 담겨 반환됩니다.

필요 권한

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

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -d guids=0565a218-a78d-43ff-89b6-a9899adcf8c5,54157629-74f7-4d80-be5a-8cb8f0c71087 \
     -X DELETE \
     https://HOSTNAME/api/sonar/logger-groups

요청 매개변수

정상 응답

{
  "failures": []
}

• failures (배열): 삭제에 실패한 수집기 그룹 목록. 모두 성공하면 빈 배열입니다.
  • id (문자열): 삭제에 실패한 수집기 그룹 GUID
  • reason (문자열): 실패 사유. 존재하지 않는 그룹이면 logger group not found: <guid>, 그 밖의 오류이면 sql-error입니다.

오류 응답

일부 수집기 그룹 삭제에 실패한 경우

HTTP 상태 코드 200 응답

{
  "failures": [
    {
      "id": "54157629-74f7-4d80-be5a-8cb8f0c71087",
      "reason": "logger group not found: 54157629-74f7-4d80-be5a-8cb8f0c71087"
    }
  ]
}

guids가 누락된 경우

HTTP 상태 코드 400 응답

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

guids에 GUID 형식이 아닌 값이 있는 경우

HTTP 상태 코드 400 응답

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

권한이 없는 경우

HTTP 상태 코드 500 응답

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