---
title: "changeLoadBalancerInstanceConfiguration"
slug: "cli-loadbalancer-changeloadbalancerinstanceconfiguration"
updated: 2026-05-21T09:02:08Z
published: 2026-05-21T09:10:09Z
canonical: "cli-gov.ncloud-docs.com/cli-loadbalancer-changeloadbalancerinstanceconfiguration"
---

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

# changeLoadBalancerInstanceConfiguration

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

로드밸런서 인스턴스 설정 변경

## 설명<a name="설명"></a>

로드밸런서 인스턴스의 설정값을 변경합니다.

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

| 파라미터 명                             | 필수 여부   | 타입    | 제약사항            | 설명                                                         |
| --------------------------------------- | ----------- | ------- | ------------------- | ------------------------------------------------------------ |
| loadBalancerInstanceNo                  | Yes         | String  |                     | - 설정을 변경할 로드밸런서 인스턴스 번호<br/>getLoadBalacerInstanceList 액션을 통해서 인스턴스번호를 알 수 있음 |
| loadBalancerAlgorithmTypeCode           | Yes         | String  | Min : 1,Max : 5     | - 로드밸런서 알고리즘 구분 코드<br/>입력 가능한 알고리즘: ROUND ROBIN (RR),   LEAST_CONNECTION (LC) |
| loadBalancerDescription                 | No          | String  | Min : 1,Max : 1000  | 수정할 로드밸런서 설명                                       |
| loadBalancerRuleList.protocolTypeCode   | Yes         | String  | Min : 1,Max : 5     | - 로드밸런서 RULE의 프로토콜 구분 코드<br/>입력 가능한 코드: HTTP \| TCP |
| loadBalancerRuleList.loadBalancerPort   | Yes         | Integer | Min : 1,Max : 65534 | 로드밸런서 RULE의 로드밸런서 포트                            |
| loadBalancerRuleList.serverPort         | Yes         | Integer | Min : 1,Max : 65534 | 로드밸런서 RULE의 서버 포트                                  |
| loadBalancerRuleList.l7HealthCheckPath  | Conditional | String  | Min : 1,Max : 600   | - 로드밸런서 RULE의 헬스 체크 경로</br>loadBalancerRuleList.N.protocolTypeCode   값이 HTTP인 경우에는 필수 항목 |
| loadBalancerRuleList.certificateName    | Conditional | String  | Min : 1,Max : 300   | 로드밸런서 생성시 로드밸런서 RULE을 입력해야 함</br>로드밸런서 SSL 공인인증서</br>loadBalancerRuleList.protocloTypeCode 값이 SSL/HTTPS인 경우에는 필수 항목 |
| loadBalancerRuleList.N.proxyProtocolUseYn|No|String||프록시 프로토콜 사용 여부<br/>loadBalancerRuleList.N.protocloTypeCode 값이 `TCP` `SSL` 인 경우에만 설정 가능<br/>Options : `Y(설정)` \| `N(해제)`|
| loadBalancerRuleList.N.stickySessionUseYn|No|String||세션별 접근 사용 여부<br/>loadBalancerRuleList.N.protocloTypeCode 값이 `HTTP` `HTTPS` 인 경우에만 설정 가능<br/>Options : `Y(설정)` \| `N(해제)`|
| loadBalancerRuleList.N.http2UseYn|No|String||HTTP/2 프로토콜 사용 여부<br/>loadBalancerRuleList.N.protocloTypeCode 값이 `HTTPS` 인 경우에만 설정 가능<br/>Options : `Y(설정)` \| `N(해제)`|
| loadBalancerRuleList.N.serverProtocolTypeCode|No|String||- 서버 프로토콜 구분 코드<br/>loadBalancerRuleList.N.protocloTypeCode 값이 `HTTPS` 인 경우에만 설정 가능<br/>Options : `HTTP` `HTTPS`<br/>Default : `HTTP`|
| zoneNoList                               | No          | List<String> |          | 로드밸런서의 존을 변경하고자 할 때 입력 <br/> 존번호는 getZoneList 액션을 통해 획득 가능 <br/> 존을 변경할 경우 로드밸런서 IP가 변경됨 <br/> 사설 IP 로드밸런서는 존을 변경할 수 없음 `멀티 존 기능은 지원 예정` |

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

| LoadBalancerInstanceList extends CommonResponse |
| ---------------------------------------- |
| private Integer totalRows;
| private List\<LoadBalancerInstance\> loadBalancerInstanceList = new ArrayList\<LoadBalancerInstance\>(); |

| LoadBalancerInstance                                                     |
| ----------------------------------------                                 |
| private String loadBalancerInstanceNo;                                   |
| private String virtualIp;                                                |
| private String loadBalancerName;                                         |
| private CommonCode loadBalancerAlgorithmType;                            |
| private String loadBalancerDescription;                                  |
| private Date createDate;                                                 |
| private String domainName;                                               |
| private String loadBalancerInstanceStatusName;                           |
| private CommonCode loadBalancerInstanceStatus;                           |
| private CommonCode loadBalancerInstanceOperation;                        |
| private CommonCode networkUsageType;                                     |
| private Boolean isHttpKeepAlive;                                         |
| private Integer connectionTimeout;                                       |
| private String certificateName;                                          |
| private List\<LoadBalancerRule\> loadBalancerRuleList;                     |
| private List<LoadBalancedServerInstance> loadBalancedServerInstanceList; |

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

### 호출<a name="호출"></a>

```
ncloud loadbalancer changeLoadBalancerInstanceConfiguration --loadBalancerInstanceNo 465475 --loadBalancerAlgorithmTypeCode RR --loadBalancerRuleList protocolTypeCode=HTTP,loadBalancerPort=80,serverPort=1024,l7HealthCheckPath=/l7check.html,proxyProtocolUseYn=N
```

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


```json
{
  "changeLoadBalancerInstanceConfigurationResponse": {
    "requestId": "962fa0f6-b7b3-4d33-8567-862f33c87771",
    "returnCode": 0,
    "returnMessage": "success",
    "totalRows": 1,
    "loadBalancerInstanceList": [
     {
       "loadBalancerInstanceNo": 465475,
       "virtualIp": "49.236.164.49,49.236.164.68",
       "loadBalancerName": "penguinlb",
       "loadBalancerAlgorithmType": {
         "code": "RR",
         "codeName": "Round Robin"
       },
       "loadBalancerDescription": "",
       "createDate": "0518-12-03T12:25:18+0900",
       "domainName": "slb-465475.ncloudslb.com",
       "loadBalancerInstanceStatusName": "changing",
       "loadBalancerInstanceStatus": {
         "code": "USED",
         "codeName": "NET USED state"
       },
       "loadBalancerInstanceOperation": {
         "code": "CHANG",
         "codeName": "NET CHANGE OP"
       },
       "networkUsageType": {
         "code": "PBLIP",
         "codeName": "Public"
       },
       "isHttpKeepAlive": false,
       "connectionTimeout": 60,
       "certificateName": "",
       "loadBalancerRuleList": [
         {
             "protocolType": {
               "code": "HTTP",
               "codeName": "http"
             },
             "loadBalancerPort": 80,
             "serverPort": 1024,
             "l7HealthCheckPath": "/l7check.html",
             "certificateName": "",
             "proxyProtocolUseYn": "N",
             "stickySessionUseYn": "N",
             "http2UseYn": "N"
         }
       ],
       "loadBalancedServerInstanceList": [
         ""
       ]
      }
    ]
  }
}
```
```xml
<?xml version="1.0" encoding="UTF-8" ?>
<changeLoadBalancerInstanceConfigurationResponse>
  <requestId>962fa0f6-b7b3-4d33-8567-862f33c87771</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <loadBalancerInstanceList>
    <loadBalancerInstanceNo>465475</loadBalancerInstanceNo>
    <virtualIp>49.236.164.49,49.236.164.68</virtualIp>
    <loadBalancerName>penguinlb</loadBalancerName>
    <loadBalancerAlgorithmType>
      <code>RR</code>
      <codeName>Round Robin</codeName>
    </loadBalancerAlgorithmType>
    <loadBalancerDescription></loadBalancerDescription>
    <createDate>0518-12-03T12:25:18+0900</createDate>
    <domainName>slb-465475.ncloudslb.com</domainName>
    <loadBalancerInstanceStatusName>changing</loadBalancerInstanceStatusName>
    <loadBalancerInstanceStatus>
      <code>USED</code>
      <codeName>NET USED state</codeName>
    </loadBalancerInstanceStatus>
    <loadBalancerInstanceOperation>
      <code>CHANG</code>
      <codeName>NET CHANGE OP</codeName>
    </loadBalancerInstanceOperation>
    <networkUsageType>
      <code>PBLIP</code>
      <codeName>Public</codeName>
    </networkUsageType>
    <isHttpKeepAlive>false</isHttpKeepAlive>
    <connectionTimeout>60</connectionTimeout>
    <certificateName></certificateName>
    <loadBalancerRuleList>
      <protocolType>
        <code>HTTP</code>
        <codeName>http</codeName>
      </protocolType>
      <loadBalancerPort>80</loadBalancerPort>
      <serverPort>1024</serverPort>
      <l7HealthCheckPath>/l7check.html</l7HealthCheckPath>
      <certificateName></certificateName>
      <proxyProtocolUseYn>N</proxyProtocolUseYn>
      <stickySessionUseYn>N</stickySessionUseYn>
      <http2UseYn>N</http2UseYn>
    </loadBalancerRuleList>
    <loadBalancedServerInstanceList></loadBalancedServerInstanceList>
  </loadBalancerInstanceList>
</changeLoadBalancerInstanceConfigurationResponse>
```