노드 쌍 생성

새 노드 쌍을 등록합니다. 활성 노드 정보는 필수이며, 대기 노드 정보는 선택 사항입니다. 기존 노드 쌍의 설정은 노드 쌍 수정 API로 변경할 수 있습니다.

필요 권한

클러스터 관리자 권한이 필요합니다.

HTTP 요청

POST /api/sonar/node-pairs

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -d type=DATA \
     -d name=data-pair \
     -d nid=data-a \
     -d host=192.0.2.20 \
     -d port=8443 \
     -d user=admin \
     -d password=secret \
     -X POST \
     https://HOSTNAME/api/sonar/node-pairs

요청 매개변수

키	필수	타입	설명	비고
guid	X	문자열	노드 쌍 GUID	36자. 미지정 시 무작위 생성
type	O	문자열	노드 유형	`CONTROL`(분석 노드) 또는 `DATA`(수집 노드)
name	O	문자열	노드 쌍 이름
description	X	문자열	노드 쌍 설명
vip_host	X	문자열	대표 주소(VIP)
vip_port	X	32비트 정수	대표 웹 포트(VIP)
nid	O	문자열	노드 A 식별자
host	O	문자열	노드 A 호스트 주소
port	O	32비트 정수	노드 A 웹 포트
user	O	문자열	노드 A 접속 계정
password	O	문자열	노드 A 접속 암호
secure	X	불리언	노드 A HTTPS 사용 여부	기본값: `false`
check_cert	X	불리언	노드 A 서버 인증서 검증 여부	미지정 시 검증하지 않음
connect_timeout	X	32비트 정수	노드 A 접속 타임아웃(밀리초)	기본값: `10000`
read_timeout	X	32비트 정수	노드 A 읽기 타임아웃(밀리초)	기본값: `10000`
nid2	X	문자열	노드 B 식별자	지정 시 대기 노드를 구성
host2	X	문자열	노드 B 호스트 주소	대기 노드(`nid2`) 지정 시 필수
port2	X	32비트 정수	노드 B 웹 포트	대기 노드(`nid2`) 지정 시 필수
user2	X	문자열	노드 B 접속 계정	대기 노드(`nid2`) 지정 시 필수
password2	X	문자열	노드 B 접속 암호	대기 노드(`nid2`) 지정 시 필수

Note

대기 노드의 HTTPS 사용 여부, 인증서 검증 여부, 타임아웃 값은 활성 노드의 설정을 그대로 사용합니다.

정상 응답

{
  "guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

guid (문자열): 생성된 노드 쌍 GUID

오류 응답

필수 매개변수가 누락된 경우

HTTP 상태 코드 400 응답

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

노드 쌍 이름이 중복된 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "duplicated node pair name: data-pair"
}

권한이 없는 경우

HTTP 상태 코드 500 응답

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