---
title: "createLoadBalancerListener"
slug: "cli-vloadbalancer-loadbalancer-createloadbalancerlistener"
updated: 2026-04-23T09:05:00Z
published: 2026-04-23T09:07:37Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# createLoadBalancerListener

## 개요<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 조회 결과의 첫 번째 리전을 선택  |
| loadBalancerInstanceNo                            | Yes          | String                |                           | - 로드밸런서 인스턴스 번호<br/>loadBalancerInstanceNo는 [getLoadBalancerInstanceList](/docs/cli-vloadbalancer-loadbalancer-getloadbalancerinstancelist) 액션을 통해 획득 가능 |
| protocolTypeCode                                  | Yes          | String                |                           | - 리스너 프로토콜 유형 코드<br/>선택한 로드밸런서 유형에 따라서 사용 가능한 리스너 프로토콜 유형이 제한됨<br/>`APPLICATION : HTTP / HTTPS`<br/>`NETWORK : TCP / UDP`<br/>`NETWORK_PROXY : TCP / TLS`<br/>UDP 프로토콜은 SGN(싱가포르) 리전에서만 이용 가능   |
| port                                              | Yes          | Integer               | Min : 1, Max : 65534      | - 리스너 포트<br/>기존에 등록된 리스너의 포트와 중복될 수 없음    |
| 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) 액션을 통해서 획득 가능 |
| useHttp2                                          | No           | Boolean               |                           | - HTTP/2 프로토콜 사용 여부<br/>Options : true \| false<br/>Default : false<br/>리스너 프로토콜 유형이 HTTPS 인 경우에만 유효함 |
| 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"} 액션을 통해 획득 가능  |
| tlsMinVersionTypeCode                             | No           | String                |                           | - TLS 최소 지원 버전 유형 코드<br/>리스너 프로토콜 유형이 HTTPS 또는 TLS 인 경우에만 유효함<br/>Options :<br/>`TLSV10 (TLSv1.0)`<br/>`TLSV11 (TLSv1.1)`<br/>`TLSV12 (TLSv1.2)`<br/>Default : TLSV10 |
|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>

- LoadBalancerListenerList 타입

| LoadBalancerListenerList extends CommonResponse |
| ---------- |
| private Integer totalRows; |
| private List<LoadBalancerListener> loadBalancerListenerList = new ArrayList<>(); |

| LoadBalancerListener |
| ---------- |
| private String loadBalancerInstanceNo; |
| private String loadBalancerListenerNo; |
| private CommonCode protocolType; |
| private Integer port; |
| private Boolean useHttp2; |
| private String sslCertificateNo; |
| private CommonCode tlsMinVersionType; |
| private LoadBalancerRuleNoList loadBalancerRuleNoList; |
| private CipherSuiteList cipherSuiteList; |

| LoadBalancerRuleNoList |
| ---------- |
| private List\<String\> loadBalancerRuleNoList = new ArrayList<>(); |

| CipherSuiteList |
| ---------- |
| private List\<String\> cipherSuiteList = new ArrayList<>(); |


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


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


```
ncloud vloadbalancer createLoadBalancerListener --regionCode FKR --loadBalancerInstanceNo ***887 --protocolTypeCode HTTP --port 80 --targetGroupNo ***095
```

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


```xml
<createLoadBalancerListenerResponse>
  <requestId>55fc050c-3006-4472-bd96-2cb3b1547a53</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <loadBalancerListenerList>
    <loadBalancerListener>
      <loadBalancerInstanceNo>***887</loadBalancerInstanceNo>
      <loadBalancerListenerNo>***961</loadBalancerListenerNo>
      <protocolType>
        <code>HTTP</code>
        <codeName>HTTP protocol</codeName>
      </protocolType>
      <port>80</port>
      <useHttp2>false</useHttp2>
      <sslCertificateNo></sslCertificateNo>
      <tlsMinVersionType/>
      <loadBalancerRuleNoList>
        <loadBalancerRuleNo>***444</loadBalancerRuleNo>
      </loadBalancerRuleNoList>
      <cipherSuiteList/>
    </loadBalancerListener>
  </loadBalancerListenerList>
</createLoadBalancerListenerResponse>
```