노드 페어 일괄 삭제

지정한 노드 페어들을 일괄 삭제합니다.

필요 권한

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

HTTP 요청

DELETE /api/sonar/node-pairs
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
     -d guids="a1b2c3d4-e5f6-7890-abcd-ef1234567890,b2c3d4e5-f678-9012-bcde-f12345678901" \
     -X DELETE \
     https://HOSTNAME/api/sonar/node-pairs
요청 매개변수
필수타입설명비고
guidsO문자열 목록노드 페어 GUID 목록쉼표(,)로 구분

정상 응답

{}
일부 노드 페어 삭제에 실패한 경우

수집기가 등록된 노드 페어은 삭제되지 않으며 응답 본문에 실패 항목이 포함됩니다.

{
  "failures": [
    {
      "node_pair_guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "reason": "logger-exist",
      "logger_names": ["syslog-collector", "windows-event"]
    }
  ]
}
  • failures (배열): 삭제에 실패한 노드 페어 목록
    • node_pair_guid (문자열): 노드 페어 GUID
    • reason (문자열): 실패 사유 (logger-exist: 노드 페어에 등록된 수집기가 있음)
    • logger_names (배열): 노드 페어에 등록된 수집기 이름 목록

오류 응답

식별자가 누락된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "null-argument",
  "error_msg": "guids should be not null"
}
권한이 없는 경우

HTTP 상태 코드 500 응답

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