---
title: "LoadBalancerInstance"
slug: "common-vapidatatype-loadbalancerinstance"
tags: ["VPC", "Load Balancer"]
updated: 2026-07-23T09:04:07Z
published: 2026-07-23T09:04:07Z
canonical: "api.ncloud-docs.com/common-vapidatatype-loadbalancerinstance"
---

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

# LoadBalancerInstance

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

로드 밸런서 인스턴스입니다.

## 구문

구문은 다음과 같습니다.

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

## 필드

필드에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `loadBalancerInstanceNo` | String | Required | 로드 밸런서 인스턴스 번호 - 로드 밸런서 인스턴스를 식별하기 위한 네이버 클라우드 플랫폼의 식별자 |
| `loadBalancerInstanceStatus` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 로드 밸런서 인스턴스 상태 - `INIT` \| `CREAT` \| `USED` \| `TERMT` - `INIT`: Initiated - `CREAT`: Created - `USED`: Used - `TERMT`: Terminated |
| `loadBalancerInstanceOperation` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 로드 밸런서 인스턴스 운영 상태 - `CHANG` \| `CREAT` \| `NULL` \| `TERMT` \| `USE` - `CHANG`: Change - `CREAT`: Create - `NULL`: No Operation - `TERMT`: Terminate - `USE`: Use |
| `loadBalancerInstanceStatusName` | String | Required | 로드 밸런서 인스턴스 상태명 - 로드 밸런서 인스턴스 상태와 로드 밸런서 인스턴스 운영 상태를 조합하여 현재의 로드 밸런서 인스턴스 상태명 전달 - `Creating` \| `Running` \| `Changing` \| `Terminating` \| `Terminated` \| `Repairing` |
| `loadBalancerDescription` | String | Optional | 로드 밸런서 설명 |
| `createDate` | Date | Required | 생성 일시(YYYY-MM-DDThh:mm:ssZ) |
| `loadBalancerName` | String | Required | 로드 밸런서 이름 |
| `loadBalancerDomain` | String | Required | 로드 밸런서 접속 정보 도메인 이름 |
| `loadBalancerIpList` | [LoadBalancerIpList](/docs/common-vapidatatype-loadbalanceriplist) | Required | 로드 밸런서 접속 정보 IP 목록 |
| `loadBalancerType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 로드 밸런서 유형 - `APPLICATION` \| `NETWORK` \| `NETWORK_PROXY` - `APPLICATION`: Application Load Balancer - `NETWORK`: Network Load Balancer - `NETWORK_PROXY`: Network Proxy Load Balancer |
| `loadBalancerNetworkType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 로드 밸런서 네트워크 유형 - `PUBLIC` \| `PRIVATE` - `PUBLIC`: Public Network - `PRIVATE`: Private Network |
| `throughputType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 부하 처리 성능 유형 - `SMALL` \| `MEDIUM` \| `LARGE` - `SMALL`: Small Throughput - `MEDIUM`: Medium Throughput - `LARGE`: Large Throughput |
| `idleTimeout` | Integer | Optional | 연결 유지 시간(초) - 1~3,600 |
| `vpcNo` | String | Required | VPC 번호 |
| `regionCode` | String | Required | 로드 밸런서가 위치한 리전 코드 |
| `subnetNoList` | [SubnetNoList](/docs/common-vapidatatype-subnetnolist) | Required | Subnet 번호 - 각 존별로 한 개의 로드 밸런서 전용 서브넷 선택 가능 |
| `loadBalancerSubnetList` | List<[LoadBalancerSubnet](/docs/common-vapidatatype-loadbalancersubnet)> | Required | 로드 밸런서 서브넷 목록 - 로드 밸런서가 위치한 서브넷 정보 |
| `loadBalancerListenerNoList` | [LoadBalancerListenerNoList](/docs/common-vapidatatype-loadbalancerlistenernolist) | Optional | 로드 밸런서에 설정된 리스너 번호 목록 |