---
title: "changeLoadBalancerListenerConfiguration"
slug: "cli-vloadbalancer-loadbalancer-changeloadbalancerlistenerconfiguration"
tags: ["Load Balancer"]
updated: 2026-09-17T09:10:37Z
published: 2026-09-17T09:10:37Z
canonical: "cli-fin.ncloud-docs.com/cli-vloadbalancer-loadbalancer-changeloadbalancerlistenerconfiguration"
---

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

# changeLoadBalancerListenerConfiguration

로드밸런서 리스너의 설정을 변경합니다.

## 구문

`changeLoadBalancerListenerConfiguration` 구문은 다음과 같습니다.

```
./ncloud vloadbalancer changeLoadBalancerListenerConfiguration \
    --loadBalancerListenerNo <load-balancer-listener-no> \
    --protocolTypeCode <HTTP|HTTPS|TCP|UDP|TLS> \
    --port <port> \
    [--useHttp2 <true|false>] \
    [--sslCertificateNo <ssl-certificate-no>] \
    [--tlsMinVersionTypeCode <TLSV10|TLSV11|TLSV12>] \
    [--cipherSuiteList <cipher-suite-list>] \
    [--regionCode <FKR>] \
    [--output <json|xml>]
```

## 옵션

`changeLoadBalancerListenerConfiguration` 실행 시 지정할 수 있는 옵션을 설명합니다.

### 필수 옵션

`changeLoadBalancerListenerConfiguration`의 필수 옵션입니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--loadBalancerListenerNo` | String | Required | 로드밸런서 리스너 번호 - [getLoadBalancerListenerList](/docs/cli-vloadbalancer-loadbalancer-getloadbalancerlistenerlist) 참조 |
| `--protocolTypeCode` | String | Required | 로드밸런서 리스너의 프로토콜 유형 - `HTTP` \| `HTTPS` \| `TCP` \| `UDP` \| `TLS` - 로드밸런서의 유형에 따라서 선택할 수 있는 값이 제한됨 - 애플리케이션 로드밸런서: `HTTP` \| `HTTPS` - 네트워크 로드밸런서: `TCP` \| `UDP` - 네트워크 프록시 로드밸런서: `TCP` \| `TLS` |
| `--port` | Integer | Required | 로드밸런서 리스너 포트 - `1`~`65534` - 기존에 등록된 리스너 포트와 중복 불가 |
| `--sslCertificateNo` | String | Conditional | SSL 인증서 번호 - 리스너의 프로토콜 유형이 `HTTPS` 또는 `TLS`이면 SSL 인증서 설정 필수 - [getCertificateList](/docs/security-certificatemanager-getcertificatelist) 참조 |

### 선택 옵션

`changeLoadBalancerListenerConfiguration`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--useHttp2` | Boolean | Optional | HTTP/2 프로토콜 사용 여부 - `true` \| `false` (기본값) - `true`: 사용 - `false`: 사용 안 함 - 리스너의 프로토콜 유형이 `HTTPS`이면 설정 가능 |
| `--tlsMinVersionTypeCode` | String | Optional | TLS 최소 지원 버전 - `TLSV10` (기본값) \| `TLSV11` \| `TLSV12` - `TLSV10`: TLS 1.0 - `TLSV11`: TLS 1.1 - `TLSV12`: TLS 1.2 - 리스너의 프로토콜 유형이 `HTTPS` 또는 `TLS`이면 설정 가능 |
| `--cipherSuiteList` | List | Optional | 클라이언트와 암호화 협상 시 로드밸런서가 제공하는 암호 도구 목록 - `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` - 기본값: 리스너 프로토콜을 `HTTPS` 또는 `TLS`로 신규 설정 시 전체 선택 (리스너 프로토콜을 변경하지 않으면 기존 설정 유지) - 리스너의 프로토콜 유형이 `HTTPS` 또는 `TLS`이면 설정 가능 |

### 공통 옵션

`vloadbalancer` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Load Balancer 옵션](/docs/cli-vloadbalancer#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

로드밸런서 리스너 설정 변경 요청이 성공하면 로드밸런서에 등록된 리스너의 구성 정보가 반환됩니다.

### 명령

명령 예시는 다음과 같습니다.

```
./ncloud vloadbalancer changeLoadBalancerListenerConfiguration \
    --loadBalancerListenerNo 60002222 \
    --protocolTypeCode HTTP \
    --port 9090 \
    --regionCode FKR \
    --output json
```

### 출력

출력 예시는 다음과 같습니다.

```
{
  "changeLoadBalancerListenerConfigurationResponse": {
    "totalRows": 2,
    "loadBalancerListenerList": [
      {
        "loadBalancerInstanceNo": "41112223",
        "loadBalancerListenerNo": "60002222",
        "protocolType": {
          "code": "HTTP",
          "codeName": "HTTP protocol"
        },
        "port": 9090,
        "useHttp2": false,
        "sslCertificateNo": "",
        "tlsMinVersionType": {},
        "loadBalancerRuleNoList": [
          "70002222"
        ],
        "cipherSuiteList": []
      },
      {
        "loadBalancerInstanceNo": "41112223",
        "loadBalancerListenerNo": "60001111",
        "protocolType": {
          "code": "HTTP",
          "codeName": "HTTP protocol"
        },
        "port": 80,
        "useHttp2": false,
        "sslCertificateNo": "",
        "tlsMinVersionType": {},
        "loadBalancerRuleNoList": [
          "70001111"
        ],
        "cipherSuiteList": []
      }
    ],
    "requestId": "69b3e5ec-855d-4f71-a50b-d7052008c9bc",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```