노드 쌍 수정

지정한 노드 쌍의 설정과 활성/대기 노드 정보를 수정합니다. 새 노드 쌍은 노드 쌍 생성 API로 등록할 수 있습니다.

필요 권한

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

HTTP 요청

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

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 \
     -X PUT \
     https://HOSTNAME/api/sonar/node-pairs/a1b2c3d4-e5f6-7890-abcd-ef1234567890

요청 매개변수

경로 매개변수

키	타입	설명	비고
guid	문자열	노드 쌍 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	X	문자열	노드 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 접속 암호	미지정 시 기존 암호 유지

Note

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

정상 응답

{}

오류 응답

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

HTTP 상태 코드 400 응답

{
  "error_code": "null-argument",
  "error_msg": "type 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"
}