---
title: "changeLoadBalancerInstanceConfiguration"
slug: "networking-loadbalancing-changeloadbalancerinstanceconfiguration"
updated: 2026-09-17T09:16:52Z
published: 2026-09-17T09:16:52Z
canonical: "api.ncloud-docs.com/networking-loadbalancing-changeloadbalancerinstanceconfiguration"
---

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

# changeLoadBalancerInstanceConfiguration

Classic 환경에서 이용 가능합니다.

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

## 요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

| 메서드 | URI |
| --- | --- |
| GET | /loadbalancer/v2/changeLoadBalancerInstanceConfiguration |

### 요청 헤더

Load Balancer API에서 공통으로 사용하는 헤더에 대한 정보는 [Load Balancer 요청 헤더](/docs/networking-loadbalancing#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 요청 쿼리 파라미터

요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `loadBalancerInstanceNo` | String | Required | 설정을 변경하려는 로드 밸런서 인스턴스의 번호 - [getLoadBalancerInstanceList](/docs/networking-loadbalancing-getloadbalancerinstancelist) 참조 |
| `loadBalancerAlgorithmTypeCode` | String | Required | 로드 밸런싱에 사용할 알고리즘 유형 - `RR` \| `LC` - `RR`: Round Robin - `LC`: Least Connection |
| `loadBalancerDescription` | String | Optional | 로드 밸런서에 대한 설명(Byte) - 0~1,000 |
| `loadBalancerRuleList.N.protocolTypeCode` | String | Required | 로드 밸런서 규칙의 프로토콜 유형 - `HTTP` \| `HTTPS` \| `TCP` |
| `loadBalancerRuleList.N.loadBalancerPort` | Integer | Required | 로드 밸런서 규칙의 포트 - 1~65534 - 동일한 로드 밸런서에서 포트 중복 불가 - 22, 3389, 64000, 65130, 65131, 18080~18095 포트는 로드 밸런서 관리용으로 사용 불가 |
| `loadBalancerRuleList.N.serverPort` | Integer | Required | 로드 밸런서 규칙의 서버 포트 - 1~65534 - 동일한 로드 밸런서에서 포트 중복 가능 |
| `loadBalancerRuleList.N.l7HealthCheckPath` | String | Conditional | 로드 밸런서 규칙의 헬스 체크 경로 - `/` (기본값) - `/`로 시작하는 URL 경로 - `loadBalancerRuleList.N.protocolTypeCode`가 `HTTP` 또는 `HTTPS`이면 입력 필수 |
| `loadBalancerRuleList.N.certificateName` | String | Conditional | 로드 밸런서의 SSL 공인 인증서 이름 - `loadBalancerRuleList.N.protocloTypeCode`가 `SSL` 또는 `HTTPS`이면 입력 필수 |
| `loadBalancerRuleList.N.proxyProtocolUseYn` | String | Optional | 프록시 프로토콜 사용 여부 - `Y` \| `N` - `Y`: 설정 - `N`: 해제 - `loadBalancerRuleList.N.protocloTypeCode`가 `TCP` 또는 `SSL`이면 설정 가능 |
| `loadBalancerRuleList.N.stickySessionUseYn` | String | Optional | 세션별 접근 사용 여부 - `Y` \| `N` - `Y`: 설정 - `N`: 해제 - `loadBalancerRuleList.N.protocloTypeCode`가 `HTTP` 또는 `HTTPS`이면 설정 가능 |
| `loadBalancerRuleList.N.http2UseYn` | String | Optional | HTTP/2 프로토콜 사용 여부 - `Y` \| `N` - `Y`: 설정 - `N`: 해제 - `loadBalancerRuleList.N.protocloTypeCode`가 `HTTPS`이면 설정 가능 |
| `loadBalancerRuleList.N.serverProtocolTypeCode` | String | Optional | 서버의 프로토콜 유형 - `HTTP` (기본값) \| `HTTPS` - `loadBalancerRuleList.N.protocloTypeCode` `HTTPS`이면 설정 가능 |
| `zoneNoList` | List[String] | Optional | 로드 밸런스의 존을 변경하려는 존 번호 목록 - `zoneNo`는 [getRegionList](/docs/compute-server-getregionlist) 참조 - 존을 변경하면 로드 밸런서 IP가 변경됨 - 사설 IP 로드 밸런서는 존을 변경할 수 없으며 멀티존 지원 예정 |

### 요청 예시

요청 예시는 다음과 같습니다.

```
curl --location 'https://ncloud.apigw.ntruss.com/loadbalancer/v2/changeLoadBalancerInstanceConfiguration?loadBalancerInstanceNo=*******&loadBalancerAlgorithmTypeCode=RR&loadBalancerRuleList.1.l7HealthCheckPath=/&loadBalancerRuleList.1.loadBalancerPort=88&loadBalancerRuleList.1.serverPort=88&loadBalancerRuleList.1.protocolTypeCode=HTTP' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
```

## 응답

응답 형식을 설명합니다.

### 응답 바디

응답 바디는 [LoadBalancerInstance](/docs/common-apidatatype-loadbalancerinstance)를 참조해 주십시오.

### 응답 상태 코드

Load Balancer API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Load Balancer 응답 상태 코드](/docs/networking-loadbalancing#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오.

### 응답 예시

응답 예시는 다음과 같습니다.

```
<changeLoadBalancerInstanceConfigurationResponse>
    <requestId>cdb87e60-2bf1-4438-8d55-470c9f17521c</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <loadBalancerInstanceList>
        <loadBalancerInstance>
            <loadBalancerInstanceNo>********</loadBalancerInstanceNo>
            <virtualIp>***.**.***.**,**.**.***.***</virtualIp>
            <loadBalancerName>YOUR_LOAD_BALANCER</loadBalancerName>
            <loadBalancerAlgorithmType>
                <code>RR</code>
                <codeName>Round Robin</codeName>
            </loadBalancerAlgorithmType>
            <loadBalancerDescription></loadBalancerDescription>
            <createDate>2024-06-07T18:46:01+0900</createDate>
            <domainName>***.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>
            <region>
                <regionNo>1</regionNo>
                <regionCode>KR</regionCode>
                <regionName>Korea</regionName>
            </region>
            <zoneList>
                <zone>
                    <zoneNo>2</zoneNo>
                    <zoneName>KR-1</zoneName>
                    <zoneCode>KR-1</zoneCode>
                    <zoneDescription>가산 zone</zoneDescription>
                    <regionNo>1</regionNo>
                </zone>
                <zone>
                    <zoneNo>3</zoneNo>
                    <zoneName>KR-2</zoneName>
                    <zoneCode>KR-2</zoneCode>
                    <zoneDescription>평촌 zone</zoneDescription>
                    <regionNo>1</regionNo>
                </zone>
            </zoneList>
            <loadBalancerRuleList>
                <loadBalancerRule>
                    <protocolType>
                        <code>HTTP</code>
                        <codeName>http</codeName>
                    </protocolType>
                    <loadBalancerPort>88</loadBalancerPort>
                    <serverPort>88</serverPort>
                    <l7HealthCheckPath>/</l7HealthCheckPath>
                    <certificateName></certificateName>
                    <proxyProtocolUseYn>N</proxyProtocolUseYn>
                    <stickySessionUseYn>N</stickySessionUseYn>
                    <http2UseYn>N</http2UseYn>
                </loadBalancerRule>
            </loadBalancerRuleList>
            <loadBalancedServerInstanceList>
                <loadBalancedServerInstance>
                    <serverInstance>
                        <serverInstanceNo>********</serverInstanceNo>
                        <serverName>YOUR_SERVER</serverName>
                        <serverDescription></serverDescription>
                        <cpuCount>2</cpuCount>
                        <memorySize>4294967296</memorySize>
                        <baseBlockStorageSize>53687091200</baseBlockStorageSize>
                        <platformType>
                            <code>UBS64</code>
                            <codeName>Ubuntu Server 64 Bit</codeName>
                        </platformType>
                        <loginKeyName>YOUR_LOGIN_KEY</loginKeyName>
                        <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
                        <publicIp></publicIp>
                        <privateIp>**.**.***.***</privateIp>
                        <serverImageName>ubuntu-18.04</serverImageName>
                        <serverInstanceStatus>
                            <code>RUN</code>
                            <codeName>Server run state</codeName>
                        </serverInstanceStatus>
                        <serverInstanceOperation>
                            <code>NULL</code>
                            <codeName>Server NULL OP</codeName>
                        </serverInstanceOperation>
                        <serverInstanceStatusName>running</serverInstanceStatusName>
                        <createDate>2024-06-07T18:28:41+0900</createDate>
                        <uptime>2024-06-07T18:35:09+0900</uptime>
                        <serverImageProductCode>SPSW0LINUX000130</serverImageProductCode>
                        <serverProductCode>SPSVRSSD00000003</serverProductCode>
                        <isProtectServerTermination>false</isProtectServerTermination>
                        <portForwardingPublicIp>***.***.***.***</portForwardingPublicIp>
                        <zone>
                            <zoneNo>2</zoneNo>
                            <zoneName>KR-1</zoneName>
                            <zoneCode>KR-1</zoneCode>
                            <zoneDescription>가산 zone</zoneDescription>
                            <regionNo>1</regionNo>
                        </zone>
                        <region>
                            <regionNo>1</regionNo>
                            <regionCode>KR</regionCode>
                            <regionName>Korea</regionName>
                        </region>
                        <baseBlockStorageDiskType>
                            <code>NET</code>
                            <codeName>Network Storage</codeName>
                        </baseBlockStorageDiskType>
                        <baseBlockStorageDiskDetailType>
                            <code>SSD</code>
                            <codeName>SSD</codeName>
                        </baseBlockStorageDiskDetailType>
                        <serverInstanceType>
                            <code>STAND</code>
                            <codeName>Standard</codeName>
                        </serverInstanceType>
                        <userData></userData>
                        <initScriptNo></initScriptNo>
                        <accessControlGroupList>
                            <accessControlGroup>
                                <accessControlGroupConfigurationNo>******</accessControlGroupConfigurationNo>
                                <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
                                <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
                                <isDefault>true</isDefault>
                                <createDate>2021-06-22T18:09:57+0900</createDate>
                            </accessControlGroup>
                        </accessControlGroupList>
                        <instanceTagList/>
                    </serverInstance>
                    <serverHealthCheckStatusList>
                        <serverHealthCheckStatus>
                            <protocolType>
                                <code>HTTP</code>
                                <codeName>http</codeName>
                            </protocolType>
                            <loadBalancerPort>88</loadBalancerPort>
                            <serverPort>88</serverPort>
                            <l7HealthCheckPath>/</l7HealthCheckPath>
                            <proxyProtocolUseYn>N</proxyProtocolUseYn>
                            <serverStatus>false</serverStatus>
                        </serverHealthCheckStatus>
                    </serverHealthCheckStatusList>
                </loadBalancedServerInstance>
            </loadBalancedServerInstanceList>
        </loadBalancerInstance>
    </loadBalancerInstanceList>
</changeLoadBalancerInstanceConfigurationResponse>
```