Documentation Index

Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

Cluster LB Subnet 수정

Prev Next

VPC 환경에서 이용 가능합니다.

클러스터에 설정한 로드밸런서 서브넷이 삭제된 경우, 새로운 로드밸런서 서브넷을 설정합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
PATCH /vnks/v2/clusters/{uuid}/lb-subnet (한국 리전)
PATCH /vnks/sgn-v2/clusters/{uuid}/lb-subnet (싱가포르 리전)
PATCH /vnks/jpn-v2/clusters/{uuid}/lb-subnet (일본 리전)

요청 헤더

Ncloud Kubernetes Service API에서 공통으로 사용하는 헤더에 대한 정보는 Ncloud Kubernetes Service 요청 헤더를 참조해 주십시오.

요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
uuid String Required 클러스터의 UUID

요청 쿼리 파라미터

요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
lbSubnetNo Integer Conditional 로드밸런서 서브넷 인스턴스 번호
  • lbSubnetNoList를 입력하지 않은 경우, 필수 입력
  • lbSubnetNoList 입력 시 무시됨
lbSubnetNoList Array Conditional 로드밸런서 서브넷 인스턴스 번호 목록
  • lbSubnetNo를 입력하지 않은 경우, 필수 입력
  • 멀티존 구성 시 존별 1개씩 최대 2개 입력 (서로 다른 존의 서브넷만 허용)
  • 동일 파라미터 반복(lbSubnetNoList=1000&lbSubnetNoList=2000) 또는 쉼표로 구분(lbSubnetNoList=1000,2000)하여 입력
  • 첫 번째 값이 단일존 로드밸런서 및 네트워크 로드밸런서의 대표 서브넷으로 사용됨
igwYn String Optional Public 로드밸런서 서브넷 여부
  • Y | N (기본값)
    • Y: Public 로드밸런서 서브넷
    • N: Private 로드밸런서 서브넷

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request PATCH 'https://nks.apigw.ntruss.com/vnks/v2/clusters/****a20e-e0fb-4dc9-af1b-97fd3f8d****/lb-subnet?lbSubnetNo=140000' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Sub Account Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

멀티존 로드밸런서 서브넷으로 변경하는 요청 예시는 다음과 같습니다.

curl --location --request PATCH 'https://nks.apigw.ntruss.com/vnks/v2/clusters/****a20e-e0fb-4dc9-af1b-97fd3f8d****/lb-subnet?lbSubnetNoList=140000&lbSubnetNoList=141000' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Sub Account Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
uuid String - 클러스터의 UUID

응답 상태 코드

Ncloud Kubernetes Service API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud Kubernetes Service 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
    "uuid": "****a20e-e0fb-4dc9-af1b-97fd3f8d****"
}