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

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

# getLoadBalancerInstanceList

## 개요<a name="개요"></a>
로드밸런서 인스턴스 리스트 조회

## 설명<a name="설명"></a>
로드밸런서 인스턴스 리스트를 조회합니다.

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

| 파라미터 명                | 필수 여부 | 타입         | 제약사항                  | 설명                                                         |
| -------------------------- | --------- | ------------ | ------------------------- | ------------------------------------------------------------ |
| loadBalancerInstanceNoList | No        | List<String> | 중복불가                  | 조회할 로드밸런서 인스턴스 번호 리스트                       |
| networkUsageTypeCode       | No        | String       | Min : 1, Max : 5          | - 네트워크 용도 구분   코드</br>PBLIP(Public), PRVT(Private)   |
| regionNo                   | No        | String       |                           | 입력 가능한 상태는 getRegionList 액션을 통해 획득 가능 |
| pageNo                     | No        | Integer      | Min : 0, Max : 2147483647 | 건수가 많을 경우 페이지 사이즈에 해당하는 페이지 번호        |
| pageSize                   | No        | Integer      | Min : 0, Max : 2147483647 | 한 페이지에서 조회할 페이지 사이즈                           |
| sortedBy                   | No        | String       |                           | 목록 결과에 대한 정렬 컬럼을 정할 수 있음</br>로드밸런서 명(loadBalancerName) \| 로드밸런서 인스턴스 번호(loadBalancerInstanceNo) [대소문자 구분 없음]</br>Default:   로드밸런서 인스턴스 번호(loadBalancerInstanceNo) |
| sortingOrder               | No        | String       |                           | 오름차순 내림차순에 대한 목록 결과에   ordering을 정할 수 있음</br>오름차순(ascending) \| 내림차순(descending) [대소문자 구분 없음]</br>Default: 오름차순(ascending) |

## 응답 데이터 타입<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 getLoadBalancerInstanceList --networkUsageTypeCode PRVT
```

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

```json
{
  "getLoadBalancerInstanceListResponse": {
    "requestId": "d3a5be52-2003-4243-a037-3a1734210140",
    "returnCode": 0,
    "returnMessage": "success",
    "totalRows": 1,
    "loadBalancerInstanceList": [
    {
        "loadBalancerInstanceNo": 428577,
        "virtualIp": "10.39.10.76",
        "loadBalancerName": "cdb",
        "loadBalancerAlgorithmType": {
          "code": "RR",
          "codeName": "Round Robin"
        },
        "loadBalancerDescription": "",
        "createDate": "0133-10-23T21:01:41+0900",
        "domainName": "",
        "loadBalancerInstanceStatusName": "used",
        "loadBalancerInstanceStatus": {
          "code": "USED",
          "codeName": "NET USED state"
        },
        "loadBalancerInstanceOperation": {
          "code": "NULL",
          "codeName": "NET NULL OP"
        },
        "networkUsageType": {
          "code": "PRVT",
          "codeName": "Private "
        },
        "isHttpKeepAlive": false,
        "connectionTimeout": 60,
        "certificateName": "",
        "loadBalancerRuleList": [
          {
            "protocolType": {
              "code": "HTTP",
              "codeName": "http"
            },
            "loadBalancerPort": 88,
            "serverPort": 88,
            "l7HealthCheckPath": "/l7check.html",
            "certificateName": "",
            "proxyProtocolUseYn": "N",
            "stickySessionUseYn": "N",
            "http2UseYn": "N"
          }
        ],
        "loadBalancedServerInstanceList": [
          ""
        ]
      }
    ]
  }
}
```
```xml
<?xml version="1.0" encoding="UTF-8" ?>
<getLoadBalancerInstanceListResponse>
  <requestId>d3a5be52-2003-4243-a037-3a1734210140</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <loadBalancerInstanceList>
    <loadBalancerInstanceNo>428577</loadBalancerInstanceNo>
    <virtualIp>10.39.10.76</virtualIp>
    <loadBalancerName>cdb</loadBalancerName>
    <loadBalancerAlgorithmType>
      <code>RR</code>
      <codeName>Round Robin</codeName>
    </loadBalancerAlgorithmType>
    <loadBalancerDescription></loadBalancerDescription>
    <createDate>0133-10-23T21:01:41+0900</createDate>
    <domainName></domainName>
    <loadBalancerInstanceStatusName>used</loadBalancerInstanceStatusName>
    <loadBalancerInstanceStatus>
      <code>USED</code>
      <codeName>NET USED state</codeName>
    </loadBalancerInstanceStatus>
    <loadBalancerInstanceOperation>
      <code>NULL</code>
      <codeName>NET NULL OP</codeName>
    </loadBalancerInstanceOperation>
    <networkUsageType>
      <code>PRVT</code>
      <codeName>Private </codeName>
    </networkUsageType>
    <isHttpKeepAlive>false</isHttpKeepAlive>
    <connectionTimeout>60</connectionTimeout>
    <certificateName></certificateName>
    <loadBalancerRuleList>
      <protocolType>
        <code>HTTP</code>
        <codeName>http</codeName>
      </protocolType>
      <loadBalancerPort>88</loadBalancerPort>
      <serverPort>88</serverPort>
      <l7HealthCheckPath>/l7check.html</l7HealthCheckPath>
      <certificateName></certificateName>
      <proxyProtocolUseYn>N</proxyProtocolUseYn>
      <stickySessionUseYn>N</stickySessionUseYn>
      <http2UseYn>N</http2UseYn>
    </loadBalancerRuleList>
    <loadBalancedServerInstanceList></loadBalancedServerInstanceList>
  </loadBalancerInstanceList>
</getLoadBalancerInstanceListResponse>
```