노드 쌍 조회

지정한 노드 쌍의 설정과 활성/대기 노드 정보를 조회합니다. 전체 노드 쌍 목록은 노드 쌍 목록 조회 API로 확인할 수 있습니다.

필요 권한

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

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     https://HOSTNAME/api/sonar/node-pairs/a1b2c3d4-e5f6-7890-abcd-ef1234567890

요청 매개변수

경로 매개변수

정상 응답

{
  "node_pair": {
    "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_pair (맵): 노드 쌍 구성 정보
  • guid (문자열): 노드 쌍 GUID
  • type (문자열): 노드 유형. CONTROL(분석 노드), DATA(수집 노드)
  • name (문자열): 노드 쌍 이름
  • description (문자열): 노드 쌍 설명
  • is_local (불리언): 로컬 노드 쌍 여부
  • is_alive (불리언): 노드 쌍 활성 상태. true이면 활성, false이면 단절
  • vip_host (문자열): 대표 주소(VIP)
  • vip_port (32비트 정수): 대표 웹 포트(VIP)
  • guid1 (문자열): 노드 A GUID
  • 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 읽기 타임아웃(밀리초)

오류 응답

guid가 누락된 경우

HTTP 상태 코드 400 응답

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

guid가 GUID 형식이 아닌 경우

HTTP 상태 코드 400 응답

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

권한이 없는 경우

HTTP 상태 코드 500 응답

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