수집기 상태 일괄 초기화

지정한 수집기의 상태를 초기화합니다. 상태가 초기화되면 수집기는 처음부터 다시 수집합니다.

필요 권한

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

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -d guids="c1dfe306-abba-4ed8-862b-0e98e2effcb6" \
     -X DELETE \
     https://HOSTNAME/api/sonar/loggers/states

요청 매개변수

정상 응답

{
  "failures": []
}

• failures (객체 배열): 상태 초기화에 실패한 수집기 목록. 모두 성공하면 빈 배열을 반환합니다.
  • id (문자열): 초기화에 실패한 수집기 식별자
  • reason (문자열): 실패 사유

오류 응답

수집기가 존재하지 않는 경우

HTTP 상태 코드 200 응답

{
  "failures": [
    {
      "id": "c1dfe306-abba-4ed8-862b-0e98e2effcb6",
      "reason": "logger-not-found"
    }
  ]
}

수집기 식별자가 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"
}