---
title: "createLoadBalancerInstance"
slug: "cli-vloadbalancer-loadbalancer-createloadbalancerinstance"
tags: ["Load Balancer", "VPC"]
updated: 2026-04-23T08:57:16Z
published: 2026-04-23T08:59:03Z
canonical: "cli.ncloud-docs.com/cli-vloadbalancer-loadbalancer-createloadbalancerinstance"
---

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

# createLoadBalancerInstance

<p class="platform-info type-vpc">VPC 환경에서 이용 가능합니다.</p>

## 개요<a name="개요"></a>

로드밸런서 인스턴스를 생성합니다.

## 요청<a name="요청"></a>


### 요청 파라미터<a name="요청파라미터"></a>


| 파라미터명                                           | 필수 여부      | 타입                   | 제약 사항                   | 설명                                         |
| ------------------------------------------------- | ------------ | --------------------- | ------------------------- | ------------------------------------------- |
| regionCode                                        | No           | String                |                           | - 리전 코드<br/> 로드밸런서 인스턴스가 생성될 리전(Region)을 결정<br/> regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득<br/> Default : getRegionList 조회 결과의 첫 번째 리전을 선택  |
| loadBalancerTypeCode                              | Yes          | String                |                           | - 로드밸런서 유형 코드<br/> 로드밸런서 유형 결정<br/> Options : APPLICATION \| NETWORK \| NETWORK_PROXY |
| loadBalancerName                                  | No           | String                | Min : 3, Max : 30<br/> 영어, 숫자, "-"의 특수문자만 허용,영어로 시작,<br/> 영어 또는 숫자로 끝나야 함 | - 로드밸런서 이름<br/> Default : NAVER Cloud Platform가 자동으로 부여 |
| loadBalancerNetworkTypeCode                       | No           | String                |                           | - 로드밸런서 네트워크 유형 코드<br/> Options : PUBLIC \| PRIVATE<br/> Default : PUBLIC  |
| throughputTypeCode                                | No           | String                |                           | - 부하 처리 성능 유형 코드<br/>Options : SMALL \| MEDIUM \| LARGE \| XLARGE<br/>Default : SMALL <br/> 로드 밸런서의 유형에 따라서 선택할 수 있는 값이 제한됨<br/><br/>애플리케이션, 네트워크 프록시 로드 밸런서: SMALL(기본값) \| MEDIUM \| LARGE \| XLARGE <br/> 네트워크 로드 밸런서: DYNAMIC (기본값)   |
| idleTimeout                                       | No           | Integer               | Min : 1, Max : 3600 초    | - 연결 유지 시간<br/> 로드밸런서 유형이 NETWORK 가 아닌 경우에만 유효<br/> Default : 60 (초)    |
| vpcNo                                             | Yes          | String                |                           | - VPC 번호<br/> 로드밸런서 인스턴스가 생성될 VPC를 결정<br/> vpcNo는 [getVpcList](/docs/cli-vpc-vpcmanagement-getvpclist) 액션을 통해서 획득 |
| loadBalancerDescription                           | No           | String                |                           | 생성할 로드밸런서 인스턴스에 대한 설명  |
| subnetNoList.N                                    | Conditional          | List&lt;String&gt;    |                           | - Subnet 번호 리스트<br/>subnetNoList 와 loadBalancerSubnetList 둘 중 한가지 필수 입력<br/>subnetNoList 와 loadBalancerSubnetList 모두 전달시 loadBalancerSubnetList 적용<br/>선택한 VPC 에 위치하는 Subnet 선택<br/>ZONE 별로 한개의 로드밸런서 전용 Subnet 선택 가능<br/>subnetNo는 [getSubnetList](/docs/cli-vpc-subnetmanagement-getsubnetlist) 액션을 통해 획득 가능<br/>ex) subnetNoList.1=1234&subnetNoList.2=2345    |
|loadBalancerSubnetList.N.subnetNo|Conditional|String||- Subnet 번호<br/>subnetNoList 와 loadBalancerSubnetList 둘 중 한가지 필수 입력<br/>subnetNoList 와 loadBalancerSubnetList 모두 전달시 loadBalancerSubnetList 적용<br/>loadBalancerSubnetList 적용시 loadBalancerSubnetList.N.subnetNo 필수<br/>선택한 VPC 에 위치하는 Subnet 선택<br/>ZONE 별로 한개의 로드밸런서 전용 Subnet 선택 가능<br/>subnetNo는 [getSubnetList](/docs/cli-vpc-subnetmanagement-getsubnetlist) 액션을 통해 획득 가능|
|loadBalancerSubnetList.N.publicIpInstanceNo|No|String||- 공인IP인스턴스번호<br/>loadBalancerNetworkTypeCode 가 PUBLIC 인 경우에만 유효<br/>SGN(싱가포르) 리전에서만 이용 가능<br/>Default : 새로운 공인IP를 생성하여 할당|
| loadBalancerListenerList.N.protocolTypeCode       | No           | String                |                           | - 로드밸런서 리스너 프로토콜 유형 코드<br/> 로드밸런서 유형에 따라서 사용 가능한 리스너 프로토콜 유형과 기본값 결정<br/>`APPLICATION : HTTP (Default) / HTTPS`<br/>`NETWORK : TCP (Default) / UDP`<br/>`NETWORK_PROXY : TCP (Default) / TLS`<br/>UDP 프로토콜은 SGN(싱가포르) 리전에서만 이용 가능    |
| loadBalancerListenerList.N.port                   | No           | Integer               | Min : 1, Max : 65534      | - 로드밸런서 리스너 포트<br/> 리스너 프로토콜 유형에 따라서 포트 기본값 결정<br/> Default :<br/>`HTTP / TCP / UDP : 80`<br/>`HTTPS / TLS : 443`<br/> 포트 번호는 중복 불가   |
| loadBalancerListenerList.N.targetGroupNo          | Yes          | String                |                           | - 타겟 그룹 번호<br/> 선택한 타겟 그룹은 각 리스너의 DEFAULT 규칙에 적용<br/> 다른 로드밸런서에서 이미 사용 중인 타겟 그룹은 이용 불가<br/> 로드밸런서 유형과 타겟 그룹 프로토콜 유형에 따라서 사용 가능한 타겟 그룹이 제한<br/>`NETWORK : TCP \ UDP`<br/>`NETWORK_PROXY : PROXY_TCP`<br/>`APPLICATION : HTTP / HTTPS`<br/> targetGroupNo는 [getTargetGroupList](/docs/cli-vloadbalancer-targetgroup-gettargetgrouplist) 액션을 통해서 획득  |
| loadBalancerListenerList.N.useHttp2               | No           | Boolean               |                           | - HTTP/2 프로토콜 사용 여부<br/> Options : true \| false<br/> Default : false<br/>리스너 프로토콜 유형이 HTTPS 인 경우에만 유효 |
| loadBalancerListenerList.N.sslCertificateNo       | Conditional  | String                |                           | - SSL 인증서 번호<br/> 리스너 프로토콜 유형이 HTTPS 또는 TLS 인 경우 SSL 인증서를 반드시 설정<br/> sslCertificateNo는 [GET https://certificatemanager.apigw.ntruss.com/api/v1/certificates](https://api.ncloud-docs.com/docs/security-certificatemanager-getcertificatelist){target="_blank"} 액션을 통해서 획득 |
| loadBalancerListenerList.N.tlsMinVersionTypeCode  | No           | String                |                           | - TLS 최소 지원 버전 유형 코드<br/> 리스너 프로토콜 유형이 HTTPS 또는 TLS 인 경우에만 유효<br/> Options :<br/>`TLSV10 (TLSv1.0)`<br/>`TLSV11 (TLSv1.1)`<br/>`TLSV12 (TLSv1.2)`<br/> Default : TLSV10 |
|loadBalancerListenerList.N.cipherSuiteList.N|No|List\<String\>||- 암호화 스위트 리스트<br/>로드밸런서가 Client와 암호화 협상에서 제공할 암호화 기능들을 선택<br/>리스너 프로토콜 유형이 HTTPS / TLS 인 경우에만 지정 가능<br/>Options :<br/>`TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA`<br/>`TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256`<br/>`TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256`<br/>`TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA`<br/>`TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384`<br/>`TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384`<br/>`TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA`<br/>`TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256`<br/>`TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256`<br/>`TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA`<br/>`TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384`<br/>`TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384`<br/>`TLS_RSA_WITH_AES_128_CBC_SHA`<br/>`TLS_RSA_WITH_AES_128_CBC_SHA256`<br/>`TLS_RSA_WITH_AES_128_GCM_SHA256`<br/>`TLS_RSA_WITH_AES_256_CBC_SHA`<br/>`TLS_RSA_WITH_AES_256_CBC_SHA256`<br/>`TLS_RSA_WITH_AES_256_GCM_SHA384`<br/>`TLS_DHE_RSA_WITH_AES_128_CBC_SHA`<br/>`TLS_DHE_RSA_WITH_AES_128_CBC_SHA256`<br/>`TLS_DHE_RSA_WITH_AES_256_CBC_SHA`<br/>`TLS_DHE_RSA_WITH_AES_256_CBC_SHA256`<br/>Default : Select All|
| responseFormatType                                | No           | String                |                           | - 응답 결과의 포맷 타입<br/> Options : xml \| json<br/> Default : xml |

## 응답<a name="응답"></a>


### 응답 데이터 타입<a name="응답데이터타입"></a>

- LoadBalancerInstanceList 타입

| LoadBalancerInstanceList extends CommonResponse |
| ---------- |
| private Integer totalRows; |
| private List<LoadBalancerInstance> 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<String> loadBalancerIpList = new ArrayList<>(); |

| SubnetNoList |
| ---------- |
| private List<String> subnetNoList = new ArrayList<>(); |

| LoadBalancerSubnet |
| ---------- |
| private String zoneCode; |
| private String subnetNo; |
| private String publicIpInstanceNo; |

| LoadBalancerListenerNoList |
| ---------- |
| private List<String> loadBalancerListenerNoList = new ArrayList<>(); |


## 예시<a name="예시"></a>


### 요청 예시<a name="요청예시"></a>


```
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'"
```

### 응답 예시<a name="응답예시"></a>


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