노드 페어 조회

지정한 노드 페어의 설정과 활성/대기 노드 정보를 조회합니다.

필요 권한

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

HTTP 요청

GET /api/sonar/node-pairs/:guid

cURL 예시

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

요청 매개변수

경로 매개변수

키	타입	설명	비고
guid	문자열	노드 페어 GUID	36자

정상 응답

{
  "node_pair": {
    "guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "type": "control",
    "name": "primary-control",
    "description": "Primary control node pair",
    "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 (36자)
- 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 읽기 타임아웃 (밀리초)

오류 응답

매개변수 누락

HTTP 상태 코드 400 응답

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

노드 페어 식별자가 GUID 형식이 아닌 경우

HTTP 상태 코드 400 응답

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

노드 페어이 존재하지 않는 경우

HTTP 상태 코드 200 응답

{
  "node_pair": null
}

권한이 없는 경우

HTTP 상태 코드 500 응답

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