Documentation Index

Fetch the complete documentation index at: https://cli.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 액션을 통해서 획득
vloadbalancer-loadbalancer-getloadbalancerinstancelist)액션을 통해 획득 가능
subnetNoList.N Yes List<String> - Subnet 번호 리스트
subnetNoList 와 loadBalancerSubnetList 둘 중 한가지 필수 입력
subnetNoList 와 loadBalancerSubnetList 모두 전달시 loadBalancerSubnetList 적용
선택한 로드밸런서와 같은 VPC 에 위치하는 Subnet 선택
ZONE 별로 한개의 로드밸런서 전용 Subnet을 선택 가능
기존에 설정된 Subnet을 포함하여 선택
subnetNo는 getSubnetList 액션을 통해서 획득 가능
ex) subnetNoList.1=1234&subnetNoList.2=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 인 경우에만 유효
SGN(싱가포르) 리전에서만 이용 가능
Default : 새로운 공인IP를 생성하여 할당
responseFormatType No String - 응답 결과의 포맷 타입
Options : xml | json
Default : xml

응답

응답 데이터 타입

  • 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>