---
title: "getLoadBalancerTargetServerInstanceList"
slug: "cli-loadbalancer-getloadbalancertargetserverinstancelist"
tags: ["Load Balancer"]
updated: 2026-10-22T09:07:25Z
published: 2026-10-22T09:07:25Z
canonical: "cli-gov.ncloud-docs.com/cli-loadbalancer-getloadbalancertargetserverinstancelist"
---

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

# getLoadBalancerTargetServerInstanceList

## 개요

로드밸런서에 할당 가능한 서버 인스턴스 리스트 조회

## 설명

로드밸런서 상태에 따른 할당 가능한 서버 인스턴스 리스트를 조회합니다.

## 요청 파라미터

| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
| --- | --- | --- | --- | --- |
| networkUsageTypeCode |  | String |  | - 네트워크 용도 구분 코드 PBLIP(PublicIP) \| PRVT(PrivateIP) Default: PBLIP |
| regionNo | No | String |  | 입력 가능한 상태는 getRegionList 액션을 통해 획득 가능 |

## 응답 데이터 타입

- ServerInstanceList 타입

| ServerInstanceList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<serverinstance data-tomark-pass=""> serverInstanceList = new ArrayList<serverinstance data-tomark-pass="">();</serverinstance></serverinstance> |

| ServerInstance |
| --- |
| private String serverInstanceNo; |
| private String serverName; |
| private String serverDescription; |
| private Integer cpuCount; |
| private Long memorySize; |
| private Long baseBlockStorageSize; |
| private CommonCode platformType; |
| private String loginKeyName; |
| private Boolean isFeeChargingMonitoring; |
| private String publicIp; |
| private String privateIp; |
| private String serverImageName; |
| private CommonCode serverInstanceStatus; |
| private CommonCode serverInstanceOperation; |
| private String serverInstanceStatusName; |
| private Date createDate; |
| private Date uptime; |
| private String serverImageProductCode; |
| private String serverProductCode; |
| private Boolean isProtectServerTermination; |
| private String portForwardingPublicIp; |
| private Integer portForwardingExternalPort; |
| private Integer portForwardingInternalPort; |
| private Zone zone; |
| private Region region; |
| private CommonCode baseBlockStorageDiskType; |
| private CommonCode baseBlockStorageDiskDetailType; |
| private CommonCode serverInstanceType |
| private String userData; |
| private List<accesscontrolgroup data-tomark-pass=""> accessControlGroupList;</accesscontrolgroup> |
| private List<instancetag data-tomark-pass=""> instanceTagList;</instancetag> |

## 예시

### 호출

```
ncloud loadbalancer getLoadBalancerTargetServerInstanceList --networkUsageTypeCode PBLIP
```

### 응답

```
{
  "getLoadBalancerTargetServerInstanceListResponse": {
    "requestId": "309c2bc3-c477-4dd1-91d9-924a19dbdad0",
    "returnCode": 0,
    "returnMessage": "success",
    "totalRows": 2,
    "serverInstanceList": [
    {
      "serverInstanceNo": 463086,
      "serverName": "penguin",
      "serverDescription": "",
      "cpuCount": 2,
      "memorySize": 2147483648,
      "baseBlockStorageSize": 53687091200,
      "platformType": {
        "code": "LNX64",
        "codeName": "Linux 64 Bit"
      },
      "loginKeyName": "ncloud",
      "isFeeChargingMonitoring": false,
      "publicIp": "",
      "privateIp": "10.39.3.139",
      "serverImageName": "centos-7.3-64",
      "serverInstanceStatus": {
        "code": "RUN",
        "codeName": "Server run state"
      },
      "serverInstanceOperation": {
        "code": "NULL",
        "codeName": "Server NULL OP"
      },
      "serverInstanceStatusName": "running",
      "createDate": "2017-12-04T16:26:54+0900",
      "uptime": "2017-12-04T17:33:16+0900",
      "serverImageProductCode": "SPSW0LINUX000046",
      "serverProductCode": "SPSVRSTAND000049",
      "isProtectServerTermination": false,
      "portForwardingPublicIp": "49.236.160.9",
      "zone": {
        "zoneNo": 2,
        "zoneName": "KR-1",
        "zoneDescription": "가산 NANG zone"
      },
      "region": {
        "regionNo": 1,
        "regionCode": "KR",
        "regionName": "Korea"
      },
      "baseBlockStorageDiskType": {
        "code": "NET",
        "codeName": "Network Storage"
      },
      "baseBlockStroageDiskDetailType": {
        "code": "HDD",
        "codeName": "HDD"
      },
      "userData": "",
      "accessControlGroupList": [
       {
           "accessControlGroupConfigurationNo": 17759,
           "accessControlGroupName": "ncloud-default-acg",
           "accessControlGroupDescription": "Default AccessControlGroup",
           "isDefault": true,
           "createDate": "2013-12-03T10:37:43+0900"
       }
       ]
    },
    {
      "serverInstanceNo": 460370,
      "serverName": "s-361oopnmo2nxoz001",
      "serverDescription": "Auto scaling group \u0027secu\u0027 소속의 자동 생성된 서버",
      "cpuCount": 2,
      "memorySize": 4294967296,
      "baseBlockStorageSize": 53687091200,
      "platformType": {
        "code": "LNX64",
        "codeName": "Linux 64 Bit"
      },
      "loginKeyName": "beta-20",
      "isFeeChargingMonitoring": false,
      "publicIp": "",
      "privateIp": "10.39.2.157",
      "serverImageName": "centos-7.3-64",
      "serverInstanceStatus": {
        "code": "RUN",
        "codeName": "Server run state"
      },
      "serverInstanceOperation": {
        "code": "NULL",
        "codeName": "Server NULL OP"
      },
      "serverInstanceStatusName": "running",
      "createDate": "2017-12-03T18:27:43+0900",
      "uptime": "2017-12-03T18:30:49+0900",
      "serverImageProductCode": "SPSW0LINUX000046",
      "serverProductCode": "SPSVRSTAND000004",
      "isProtectServerTermination": false,
      "portForwardingPublicIp": "49.236.160.9",
      "zone": {
        "zoneNo": 2,
        "zoneName": "KR-1",
        "zoneDescription": "가산 NANG zone"
      },
      "region": {
        "regionNo": 1,
        "regionCode": "KR",
        "regionName": "Korea"
      },
      "baseBlockStorageDiskType": {
        "code": "NET",
        "codeName": "Network Storage"
      },
      "baseBlockStroageDiskDetailType": {
        "code": "HDD",
        "codeName": "HDD"
      },
      "userData": "",
      "accessControlGroupList": [
      {
        "accessControlGroupConfigurationNo": 17759,
        "accessControlGroupName": "ncloud-default-acg",
        "accessControlGroupDescription": "Default AccessControlGroup",
        "isDefault": true,
        "createDate": "2013-12-03T10:37:43+0900"
      }
      ]
     }
    ]
  }
}
```

```
<?xml version="1.0" encoding="UTF-8"?>
<getLoadBalancerTargetServerInstanceListResponse>
  <requestId>71493679-3725-4565-8459-9c45e25fde68</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <serverInstanceList>
    <serverInstance>
      <serverInstanceNo>1289694</serverInstanceNo>
      <serverName>ncloud-mktest</serverName>
      <serverDescription></serverDescription>
      <cpuCount>1</cpuCount>
      <memorySize>2147483648</memorySize>
      <baseBlockStorageSize>53687091200</baseBlockStorageSize>
      <platformType>
        <code>LNX64</code>
        <codeName>Linux 64 Bit</codeName>
      </platformType>
      <loginKeyName>beagle</loginKeyName>
      <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
      <publicIp></publicIp>
      <privateIp>10.41.84.156</privateIp>
      <serverImageName>centos-7.3-64</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>2019-02-22T15:03:49+0900</createDate>
      <uptime>2019-02-22T15:07:30+0900</uptime>
      <serverImageProductCode>SPSW0LINUX000046</serverImageProductCode>
      <serverProductCode>SPSVRSTAND000003</serverProductCode>
      <isProtectServerTermination>false</isProtectServerTermination>
      <portForwardingPublicIp>106.10.59.225</portForwardingPublicIp>
      <zone>
        <zoneNo>3</zoneNo>
        <zoneName>KR-2</zoneName>
        <zoneCode>KR-2</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>HDD</code>
        <codeName>HDD</codeName>
      </baseBlockStorageDiskDetailType>
      <serverInstanceType>
        <code>COMPT</code>
        <codeName>Compact Server</codeName>
      </serverInstanceType>
      <userData></userData>
      <accessControlGroupList>
        <accessControlGroup>
          <accessControlGroupConfigurationNo>4371</accessControlGroupConfigurationNo>
          <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
          <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
          <isDefault>true</isDefault>
          <createDate>2017-02-16T14:25:15+0900</createDate>
        </accessControlGroup>
      </accessControlGroupList>
      <instanceTagList/>
    </serverInstance>
  </serverInstanceList>
</getLoadBalancerTargetServerInstanceListResponse>
```