Overview

Sets subnets of load balancers.
It configures subnets including the subnets already set. You can add subnets in different zones from the existing subnets.

Request

Request parameter

Parameter name	Requirement status	Type	Description
regionCode	No	String	- Region code Determines the region of the load balancer instance to change subnet settings for. regionCode can be obtained through the getRegionList action. Default: Selects the first region of the getRegionList search results.
loadBalancerInstanceNo	Yes	String	- Instance number of load balancer to change subnet settings for loadBalancerInstanceNo can be obtained through the getLoadBalancerInstanceList action.
It can be obtained through the vloadbalancer-loadbalancer-getloadbalancerinstancelist action.
subnetNoList.N	Yes	List	- List of the subnet numbers Either subnetNoList or loadBalancerSubnetList must be entered. loadBalancerSubnetList is applied when both subnetNoList and loadBalancerSubnetList are delivered. You can select subnets in the same VPC as the selected load balancer. You can select one subnet dedicated to the load balancer per zone. You can select including subnets that have already been set. subnetNo can be obtained through the getSubnetList action. ex) subnetNoList.1=1234&subnetNoList.2=2345
loadBalancerSubnetList.N.subnetNo	Conditional	String	- Subnet number Either subnetNoList or loadBalancerSubnetList must be entered. loadBalancerSubnetList is applied when both subnetNoList and loadBalancerSubnetList are delivered. loadBalancerSubnetList.N.subnetNo is required when loadBalancerSubnetList is applied You can select subnets in the same VPC as the selected load balancer. You can select one subnet dedicated to the load balancer per zone. subnetNo can be obtained through the getSubnetList action.
loadBalancerSubnetList.N.publicIpInstanceNo	No	String	- Public IP instance number It's only valid when loadBalancerNetworkTypeCode is PUBLIC. It can only be used in the SGN (Singapore) region. Default: A new public IP is created and assigned.
responseFormatType	No	String	- Format type of the response result Options : xml \| json Default : xml

Response

Response data type

LoadBalancerInstanceList type

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<>();

Examples

Request examples

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

Response examples

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

Was this article helpful?

Table of contents

Overview
Request
- Request parameter
Response
- Response data type
Examples
- Request examples
- Response examples