노드 쌍 목록 조회

클러스터에 등록된 노드 쌍 목록을 조회합니다. 특정 노드 쌍의 상세 정보는 노드 쌍 조회 API로 확인할 수 있습니다.

필요 권한

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

HTTP 요청

GET /api/sonar/node-pairs

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     "https://HOSTNAME/api/sonar/node-pairs?include_nodes=true"

요청 매개변수

키	필수	타입	설명	비고
include_nodes	X	불리언	노드 상세 정보 포함 여부	기본값: `false`

정상 응답

include_nodes가 true인 경우에만 활성/대기 노드의 상세 접속 정보(guid1, nid, host 등)가 포함됩니다.

{
  "node_pairs": [
    {
      "guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "type": "CONTROL",
      "name": "primary-control",
      "description": "분석 노드 쌍",
      "is_local": true,
      "is_alive": true,
      "vip_host": "203.0.113.10",
      "vip_port": 8443,
      "guid1": "b2c3d4e5-f678-9012-bcde-f12345678901",
      "nid": "control-a",
      "host": "192.0.2.10",
      "port": 8443,
      "user": "admin",
      "secure": true,
      "check_cert": true,
      "connect_timeout": 10000,
      "read_timeout": 10000,
      "guid2": "c3d4e5f6-7890-1234-cdef-123456789012",
      "nid2": "control-b",
      "host2": "192.0.2.11",
      "port2": 8443,
      "user2": "admin",
      "secure2": true,
      "check_cert2": true,
      "connect_timeout2": 10000,
      "read_timeout2": 10000
    }
  ]
}

node_pairs (객체 배열): 노드 쌍 목록
- guid (문자열): 노드 쌍 GUID
- type (문자열): 노드 유형. CONTROL(분석 노드), DATA(수집 노드)
- name (문자열): 노드 쌍 이름
- description (문자열): 노드 쌍 설명
- is_local (불리언): 로컬 노드 쌍 여부
- is_alive (불리언): 노드 쌍 활성 상태. true이면 활성, false이면 단절
- vip_host (문자열): 대표 주소(VIP)
- vip_port (32비트 정수): 대표 웹 포트(VIP)
- guid1 (문자열): 노드 A GUID. include_nodes가 true인 경우에만 반환
- nid (문자열): 노드 A 식별자
- host (문자열): 노드 A 호스트 주소
- port (32비트 정수): 노드 A 웹 포트
- user (문자열): 노드 A 접속 계정
- secure (불리언): 노드 A HTTPS 사용 여부
- check_cert (불리언): 노드 A 서버 인증서 검증 여부
- connect_timeout (32비트 정수): 노드 A 접속 타임아웃(밀리초)
- read_timeout (32비트 정수): 노드 A 읽기 타임아웃(밀리초)
- guid2 (문자열): 노드 B GUID. 대기 노드가 등록된 경우에만 반환
- nid2 (문자열): 노드 B 식별자
- host2 (문자열): 노드 B 호스트 주소
- port2 (32비트 정수): 노드 B 웹 포트
- user2 (문자열): 노드 B 접속 계정
- secure2 (불리언): 노드 B HTTPS 사용 여부
- check_cert2 (불리언): 노드 B 서버 인증서 검증 여부
- connect_timeout2 (32비트 정수): 노드 B 접속 타임아웃(밀리초)
- read_timeout2 (32비트 정수): 노드 B 읽기 타임아웃(밀리초)

오류 응답

권한이 없는 경우

HTTP 상태 코드 500 응답

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