노드 쌍 일괄 삭제
지정한 노드 쌍들을 삭제합니다.
필요 권한
관리자 이상의 계정으로 이용할 수 있습니다.
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
요청 매개변수
| 키 | 필수 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| guids | O | 문자열 목록 | 노드 쌍 GUID 목록 | 여러 GUID는 쉼표(,)로 구분 |
정상 응답
모든 노드 쌍이 삭제되면 빈 객체를 반환합니다.
{}
오류 응답
guids가 누락된 경우
HTTP 상태 코드 400 응답
{
"error_code": "null-argument",
"error_msg": "guids should be not null"
}
일부 노드 쌍 삭제에 실패한 경우
HTTP 상태 코드 200 응답
실패한 노드 쌍의 사유와 관련 수집기 목록을 failures 배열로 반환합니다.
{
"failures": [
{
"reason": "node pair is in use",
"node_pair_guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"loggers": ["syslog-01", "dirwatch-02"]
}
]
}
- failures (객체 배열): 삭제에 실패한 노드 쌍 목록
- reason (문자열): 삭제 실패 사유
- node_pair_guid (문자열): 삭제에 실패한 노드 쌍 GUID
- loggers (문자열 목록): 해당 노드 쌍에 남아 있는 수집기 이름 목록. 남은 수집기가 없으면 반환되지 않음
권한이 없는 경우
HTTP 상태 코드 401 응답
{
"error_code": "no-permission",
"error_msg": "no-permission"
}