Documentation Index

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

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

setLoadBalancerInstanceSubnet

Prev Next

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

개요

로드밸런서의 서브넷을 설정합니다.
기존에 설정된 서브넷을 포함하여 설정하며, 기존 서브넷과 다른 ZONE에 위치한 서브넷을 추가 할 수 있습니다.

요청

요청 파라미터

파라미터명 필수 여부 타입 제약 사항 설명
regionCode No String - 리전 코드
Subnet 설정을 변경할 로드밸런서 인스턴스의 리전(Region) 결정 가능
regionCode는 getRegionList 액션을 통해 획득 가능
Default : getRegionList 조회 결과의 첫 번째 리전을 선택
loadBalancerInstanceNo Yes String - Subnet 설정을 변경할 로드밸런서 인스턴스 번호
loadBalancerInstanceNo는 getLoadBalancerInstanceList 액션을 통해 획득 가능
subnetNoList.N Conditional List<String> - Subnet 번호 리스트
subnetNoList 와 loadBalancerSubnetList 둘 중 한가지 필수 입력
subnetNoList 와 loadBalancerSubnetList 모두 전달 시 loadBalancerSubnetList 적용
선택한 로드밸런서와 같은 VPC에 위치하는 Subnet 선택
ZONE 별로 한 개의 로드밸런서 전용 Subnet을 선택 가능
기존에 설정된 Subnet을 포함하여 선택
subnetNo는 getSubnetList 액션을 통해 획득 가능
ex) --subnetNoList 1234 --subnetNoList 2345
loadBalancerSubnetList.N.subnetNo Conditional String - Subnet 번호
subnetNoList 와 loadBalancerSubnetList 둘 중 한 가지 필수 입력
subnetNoList 와 loadBalancerSubnetList 모두 전달 시 loadBalancerSubnetList 적용
loadBalancerSubnetList 적용시 loadBalancerSubnetList.N.subnetNo 필수
선택한 로드밸런서와 같은 VPC 에 위치하는 Subnet 선택
ZONE별로 한 개의 로드밸런서 전용 Subnet을 선택 가능
subnetNo는 getSubnetList 액션을 통해 획득 가능
loadBalancerSubnetList.N.publicIpInstanceNo No String - 공인 IP 인스턴스 번호
loadBalancerNetworkTypeCode 가 PUBLIC 인 경우에만 유효
네이버 클라우드 플랫폼[공공기관용] 에서 이용 불가
Default : 새로운 공인 IP를 생성하여 할당

응답

응답 데이터 타입

  • LoadBalancerInstanceList 타입
LoadBalancerInstanceList extends CommonResponse
private Integer totalRows;
private List loadBalancerInstanceList = new ArrayList<>();
LoadBalancerInstance
private String loadBalancerInstanceNo;
private CommonCode loadBalancerInstanceStatus;
private CommonCode loadBalancerInstanceOperation;
private String loadBalancerInstanceStatusName;
private String loadBalancerDescription;
private Date createDate;
private String loadBalancerName;
private String loadBalancerDomain;
private LoadBalancerIpList loadBalancerIpList;
private CommonCode loadBalancerType;
private CommonCode loadBalancerNetworkType;
private CommonCode throughputType;
private Integer idleTimeout;
private String vpcNo;
private String regionCode;
private SubnetNoList subnetNoList;
private List<LoadBalancerSubnet> loadBalancerSubnetList;
private LoadBalancerListenerNoList loadBalancerListenerNoList;
LoadBalancerIpList
private List loadBalancerIpList = new ArrayList<>();
SubnetNoList
private List subnetNoList = new ArrayList<>();
LoadBalancerSubnet
private String zoneCode;
private String subnetNo;
private String publicIpInstanceNo;
LoadBalancerListenerNoList
private List loadBalancerListenerNoList = new ArrayList<>();

예시

요청 예시

ncloud vloadbalancer setLoadBalancerInstanceSubnet --regionCode KR --loadBalancerInstanceNo ***887 --subnetNoList ***43 ***44

응답 예시

<setLoadBalancerInstanceSubnetResponse>
  <requestId>959a2fe5-fd1b-459a-9af3-df0e51b68e1d</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <loadBalancerInstanceList>
    <loadBalancerInstance>
      <loadBalancerInstanceNo>***887</loadBalancerInstanceNo>
      <loadBalancerInstanceStatus>
        <code>USED</code>
        <codeName>LB USED state</codeName>
      </loadBalancerInstanceStatus>
      <loadBalancerInstanceOperation>
        <code>CHANG</code>
        <codeName>LB CHANGE OP</codeName>
      </loadBalancerInstanceOperation>
      <loadBalancerInstanceStatusName>Changing</loadBalancerInstanceStatusName>
      <loadBalancerDescription></loadBalancerDescription>
      <createDate>2020-12-20T19:21:02+0900</createDate>
      <loadBalancerName>test-***</loadBalancerName>
      <loadBalancerDomain>test-***-***887-***.com</loadBalancerDomain>
      <loadBalancerIpList>
        <loadBalancerIp>***.***.5.6</loadBalancerIp>
      </loadBalancerIpList>
      <loadBalancerType>
        <code>APPLICATION</code>
        <codeName>Application Load Balancer</codeName>
      </loadBalancerType>
      <loadBalancerNetworkType>
        <code>PRIVATE</code>
        <codeName>Private</codeName>
      </loadBalancerNetworkType>
      <throughputType>
        <code>SMALL</code>
        <codeName>Small</codeName>
      </throughputType>
      <idleTimeout>60</idleTimeout>
      <vpcNo>***04</vpcNo>
      <regionCode>KR</regionCode>
      <subnetNoList>
        <subnetNo>***43</subnetNo>
        <subnetNo>***44</subnetNo>
      </subnetNoList>
      <loadBalancerSubnetList>
        <loadBalancerSubnet>
          <zoneCode>KR-1</zoneCode>
          <subnetNo>***43</subnetNo>
          <publicIpInstanceNo/>
        </loadBalancerSubnet>
        <loadBalancerSubnet>
          <zoneCode>KR-2</zoneCode>
          <subnetNo>***44</subnetNo>
          <publicIpInstanceNo/>
        </loadBalancerSubnet>
      </loadBalancerSubnetList>
      <loadBalancerListenerNoList>
        <loadBalancerListenerNo>***961</loadBalancerListenerNo>
      </loadBalancerListenerNoList>
    </loadBalancerInstance>
  </loadBalancerInstanceList>
</setLoadBalancerInstanceSubnetResponse>