createLoadBalancerInstance

Prev Next

Available in VPC

Overview

Create load balancer instances.

Request

Request parameters

Parameter name Required Type Restrictions Description
regionCode No String - Region code
Decide the Region in which the load balancer instance will be created
regionCode can be obtained through the getRegionList action
Default: Select the first Region of the getRegionList search results
loadBalancerTypeCode Yes String - Load balancer type code
Determine the load balancer type.
Options: APPLICATION | NETWORK | NETWORK_PROXY
loadBalancerName No String Min: 3, Max: 30
Only English letters, numbers, and "-" can be used, and it must start with an English letter
It must end with an English letter or number
- Load balancer name
Default: NAVER Cloud Platform automatically assigns it.
loadBalancerNetworkTypeCode No String - Load balancer network type code
Options: PUBLIC | PRIVATE
Default: PUBLIC
throughputTypeCode No String - Load balancing performance type code
Options: SMALL | MEDIUM | LARGE | XLARGE
Default: SMALL
The values that can be selected are limited depending on the type of load balancer

Application, Network Proxy Load Balancer: SMALL (default) | MEDIUM | LARGE | XLARGE
Network Load Balancer: DYNAMIC (Default)
idleTimeout No Integer Min: 1, Max: 3600 (seconds) - Connection hold time
It is only valid if the load balancer type is not NETWORK
Default: 60 (seconds)
vpcNo Yes String - VPC number
Determine the VPC where the load balancer instance will be created
vpcNo can be obtained through the getVpcList action
loadBalancerDescription No String Description of the load balancer instance to be created
subnetNoList.N Conditional List<String> - List of the subnet numbers
Either subnetNoList or loadBalancerSubnetList must be entered
loadBalancerSubnetList is applied when both subnetNoList and loadBalancerSubnetList are passed
The subnet located in the selected VPC is selected
Select one subnet dedicated for the load balancer per zone
subnetNo can be obtained through the getSubnetList action
e.g., 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 passed
loadBalancerSubnetList.N.subnetNo is required when applying loadBalancerSubnetList
The subnet located in the selected VPC is selected
Select one subnet dedicated for the load balancer per zone
subnetNo can be obtained through the getSubnetList action
loadBalancerSubnetList.N.publicIpInstanceNo No String - Public IP instance number
Valid only if loadBalancerNetworkTypeCode is PUBLIC
It can only be used in the SGN (Singapore) Region.
Default: A new public IP is created and assigned
loadBalancerListenerList.N.protocolTypeCode No String - Load balancer listener protocol type code
The available type of listener protocols and default value are decided, depending on the load balancer type
APPLICATION : HTTP (Default) / HTTPS
NETWORK : TCP (Default) / UDP
NETWORK_PROXY : TCP (Default) / TLS
The UDP protocol can only be used in the SGN (Singapore) Region
loadBalancerListenerList.N.port No Integer Min: 1, Max: 65534 - Load balancer listener port
The default port is decided depending on the listener protocol type
Default:
HTTP / TCP / UDP : 80
HTTPS / TLS : 443
The port number must be unique
loadBalancerListenerList.N.targetGroupNo Yes String - Target group number
The selected target group applies to the DEFAULT rule of each listener
You can't use target groups already in use by other load balancers
The available target groups are limited depending on the load balancer type and target group protocol type
NETWORK : TCP \ UDP
NETWORK_PROXY : PROXY_TCP
APPLICATION : HTTP / HTTPS
targetGroupNo can be obtained through the getTargetGroupList action
loadBalancerListenerList.N.useHttp2 No Boolean - HTTP/2 protocol usage status
Options: true | false
Default: false
It is only valid if the listener protocol type is HTTPS
loadBalancerListenerList.N.sslCertificateNo Conditional String - SSL certificate number
If the listener protocol type is either HTTPS or TLS, you must set the SSL certificate
sslCertificateNo can be obtained through the GET https://certificatemanager.apigw.ntruss.com/api/v1/certificates action
loadBalancerListenerList.N.tlsMinVersionTypeCode No String - Minimum support version type code of TLS
It is only valid if the listener protocol type is either HTTPS or TLS
Options:
TLSV10 (TLSv1.0)
TLSV11 (TLSv1.1)
TLSV12 (TLSv1.2)
Default: TLSV10
loadBalancerListenerList.N.cipherSuiteList.N No List<String> - Cipher suite list
Select the encryption features to be provided by the load balancer in encryption negotiation with the client
It can only be specified if the listener protocol type is HTTPS or TLS
Options:
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
TLS_RSA_WITH_AES_128_CBC_SHA
TLS_RSA_WITH_AES_128_CBC_SHA256
TLS_RSA_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_256_CBC_SHA
TLS_RSA_WITH_AES_256_CBC_SHA256
TLS_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
Default: Select All
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 example

ncloud vloadbalancer createLoadBalancerInstance --regionCode KR --loadBalancerTypeCode APPLICATION --loadBalancerName test-*** --loadBalancerNetworkTypeCode PRIVATE --throughputTypeCode SMALL --idleTimeout 60 --vpcNo ***04 --subnetNoList ***43 --loadBalancerListenerList "protocolTypeCode='HTTP', port='80', targetGroupNo='***095'"

Response example

<createLoadBalancerInstanceResponse>
  <requestId>959a2fe5-fd1b-459a-9af3-df0e51b68e1d</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <loadBalancerInstanceList>
    <loadBalancerInstance>
      <loadBalancerInstanceNo>***887</loadBalancerInstanceNo>
      <loadBalancerInstanceStatus>
        <code>INIT</code>
        <codeName>LB INIT state</codeName>
      </loadBalancerInstanceStatus>
      <loadBalancerInstanceOperation>
        <code>CREAT</code>
        <codeName>LB CREATE OP</codeName>
      </loadBalancerInstanceOperation>
      <loadBalancerInstanceStatusName>Creating</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>
      </subnetNoList>
      <loadBalancerSubnetList>
        <loadBalancerSubnet>
          <zoneCode>KR-1</zoneCode>
          <subnetNo>***43</subnetNo>
          <publicIpInstanceNo/>
        </loadBalancerSubnet>
      </loadBalancerSubnetList>
      <loadBalancerListenerNoList>
        <loadBalancerListenerNo>***961</loadBalancerListenerNo>
      </loadBalancerListenerNoList>
    </loadBalancerInstance>
  </loadBalancerInstanceList>
</createLoadBalancerInstanceResponse>