노드 페어 수정

지정한 노드 페어의 정보를 수정합니다.

필요 권한

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

HTTP 요청

PUT /api/sonar/node-pairs/:guid
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
     -d type="control" \
     -d name="primary-control" \
     -d nid="control-a" \
     -d host="192.0.2.10" \
     -d port=8443 \
     -d user="admin" \
     -d password="changeme" \
     -X PUT \
     https://HOSTNAME/api/sonar/node-pairs/a1b2c3d4-e5f6-7890-abcd-ef1234567890
요청 매개변수
경로 매개변수
키타입설명비고
guid문자열노드 페어 GUID36자
요청 본문 매개변수
키필수타입설명비고
typeO문자열노드 유형control 또는 data
nameO문자열노드 페어 이름
descriptionX문자열노드 페어 설명
vip_hostX문자열대표 주소 (VIP)
vip_portX32비트 정수대표 웹 포트 (VIP)
nidO문자열노드 A 식별자
hostO문자열노드 A 호스트 주소
portO32비트 정수노드 A 웹 포트
userO문자열노드 A 접속 계정
passwordX문자열노드 A 접속 암호미지정 시 기존 값 유지
secureX불리언노드 A HTTPS 사용 여부기본값: false
check_certX불리언노드 A 서버 인증서 검증 여부기본값: true
connect_timeoutX32비트 정수노드 A 접속 타임아웃단위 밀리초, 기본값: 10000
read_timeoutX32비트 정수노드 A 읽기 타임아웃단위 밀리초, 기본값: 10000
nid2X문자열노드 B 식별자미지정 시 기존 대기 노드가 제거됨
host2X문자열노드 B 호스트 주소nid2 지정 시 필수
port2O32비트 정수노드 B 웹 포트nid2 지정 시 필수
user2X문자열노드 B 접속 계정nid2 지정 시 필수
password2X문자열노드 B 접속 암호미지정 시 기존 값 유지
secure2X불리언노드 B HTTPS 사용 여부노드 A와 동일하게 적용
check_cert2X불리언노드 B 서버 인증서 검증 여부노드 A와 동일하게 적용
connect_timeout2X32비트 정수노드 B 접속 타임아웃노드 A와 동일하게 적용
read_timeout2X32비트 정수노드 B 읽기 타임아웃노드 A와 동일하게 적용

정상 응답

{}

오류 응답

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

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 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "node pair not found: a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
동일한 이름의 다른 노드 페어이 존재하는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "duplicated node pair name: primary-control"
}
권한이 없는 경우

HTTP 상태 코드 500 응답

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