---
title: "getServerInstanceList"
slug: "cli-server-getserverinstancelist"
tags: ["Server"]
updated: 2026-09-17T09:16:00Z
published: 2026-09-17T09:16:00Z
canonical: "cli.ncloud-docs.com/cli-server-getserverinstancelist"
---

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

# getServerInstanceList

## 개요

서버 인스턴스 리스트 조회

## 설명

서버 인스턴스(VM) 리스트를 조회합니다. 페이징 처리가 가능하며 응답 항목 중 userData의 경우에는 서버 인스턴스 상세 조회 시에만 제공됩니다.

## 요청 파라미터

| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
| --- | --- | --- | --- | --- |
| serverInstanceNoList | No | List<String> |  | 조회할 서버 인스턴스 번호 리스트 |
| searchFilterName | No | String |  | 서버 이름(serverName) \| 아이피(ip) [대소문자 구분 없음] 아이피(ip)의 경우에는 사설 아이피, 공인 아이피 모두 가능 |
| searchFilterValue | No | String |  | 검색할 값 |
| pageNo | No | Integer | Min:0, Max:2147483647 | 건수가 많을 경우 페이지 사이즈에 해당하는 페이지 번호 |
| pageSize | No | Integer | Min:0, Max:2147483647 | 한 페이지에서 조회할 페이지 사이즈 |
| serverInstanceStatusCode | No | String | Min:0, Max:5 | - 조회할 서버 인스턴스 상태 코드별 서버 리스트 입력 가능한 상태는 서버 인스턴스 데이터 타입(ServerInstance)의 서버 인스턴스 상태 (serverInstanceStatus) 값 참고 바람 |
| regionNo | No | String |  | 입력 가능한 상태는 getRegionList 액션을 통해 획득 가능 |
| zoneNo | No | String |  | 서버 리스트가 조회될 ZONE 결정 가능 getZoneList 액션을 통해 획득 가능 Default : 해당 리전의 첫번째 ZONE을 선택 |
| baseBlockStorageDiskTypeCode | No | String | Min : 1, Max : 5 | - 서버 디스크 유형 구분 코드 NETWORK DISK(NET) \| LOCAL DISK(LOCAL) |
| baseBlockStorageDiskDetailTypeCode | No | String | Min : 1, Max : 5 | - 서버 디스크 상세 유형 구분 코드 하드디스크(HDD) \| SSD(SSD) |
| sortedBy | No | String |  | 서버 이름(serverName) \| 서버 인스턴스 번호(serverInstanceNo) [대소문자 구분 없음]] Default : 서버 인스턴스 번호(serverInstanceNo) |
| sortingOrder | No | String |  | 오름차순(ascending) \| 내림차순(descending) [대소문자 구분 없음] Default : 오름차순(ascending) |
| serverInstanceTypeCodeList | No | List<String> |  | - 조회할 서버 인스턴스 구분 코드 리스트 Micro(MICRO) \| Compact(COMPT) \| Standard(STAND) \| High Memory(HIMEM) \| GPU(GPU) \| Virtual Dedicated Server(VDS) |
| tagKeyList | No | List<String> |  | 조회할 태그 키 리스트 |
| tagValueList | No | List<String> |  | 조회할 태그 값 리스트 |

## 응답 데이터 타입

- ServerInstanceList 타입

| ServerInstanceList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<ServerInstance> serverInstanceList = new ArrayList<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> accessControlGroupList; |
| private List<InstanceTag> instanceTagList; |
| private List<BlockDevicePartition> blockDevicePartitionList; |

## 예시

### 호출

```
ncloud server getServerInstanceList --serverInstanceStatusCode NSTOP --regionNo 2
```

### 응답

```
{
  "getServerInstanceListResponse": {
    "requestId": "164236f2-effd-4103-96ef-5631de14f5fc",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 2,
    "serverInstanceList": [
      {
        "serverInstanceNo": "324429",
        "serverName": "test-muk",
        "serverDescription": "",
        "cpuCount": 1,
        "memorySize": 2147483648,
        "baseBlockStorageSize": 53687091200,
        "platformType": {
          "code": "LNX64",
          "codeName": "Linux 64 Bit"
        },
        "loginKeyName": "yskey",
        "isFeeChargingMonitoring": false,
        "publicIp": "192.168.10.128",
        "privateIp": "10.113.201.174",
        "serverImageName": "centos-5.7-64",
        "serverInstanceStatus": {
          "code": "NSTOP",
          "codeName": "Server normal stopped state"
        },
        "serverInstanceOperation": {
          "code": "NULL",
          "codeName": "Server NULL OP"
        },
        "serverInstanceStatusName": "stopped",
        "createDate": "2017-05-19T12:07:12+0900",
        "uptime": "2017-05-23T16:56:45+0900",
        "serverImageProductCode": "SPSW0LINUX000010",
        "serverProductCode": "SPSVRSTAND000003",
        "isProtectServerTermination": false,
        "portForwardingPublicIp": "192.168.10.100",
        "zone": {
          "zoneNo": "10",
          "zoneName": "USW-1",
          "zoneDescription": "1st zone"
        },
        "region": {
          "regionNo": "2",
          "regionCode": "USW",
          "regionName": "US-West"
        },
        "baseBlockStorageDiskType": {
          "code": "NET",
          "codeName": "Network Storage"
        },
        "baseBlockStroageDiskDetailType": {
          "code": "HDD",
          "codeName": "HDD"
        },
        "serverInstanceType": {
          "code": "STAND"
          "codeName": "Standard"
        },
        "userData": "",
        "initScriptNo": "",
        "accessControlGroupList": [
          {
            "accessControlGroupConfigurationNo": "1038",
            "accessControlGroupName": "ncloud-default-acg",
            "accessControlGroupDescription": "Default AccessControlGroup",
            "isDefault": true,
            "createDate": "2013-12-03T10:37:39+0900"
          }
        ]
      },
      {
        "serverInstanceNo": "394180",
        "serverName": "mssong-test",
        "serverDescription": "",
        "cpuCount": 2,
        "memorySize": 4294967296,
        "baseBlockStorageSize": 53687091200,
        "platformType": {
          "code": "LNX64",
          "codeName": "Linux 64 Bit"
        },
        "loginKeyName": "redis-web",
        "isFeeChargingMonitoring": false,
        "publicIp": "",
        "privateIp": "10.113.201.150",
        "serverImageName": "centos-6.3-64",
        "serverInstanceStatus": {
          "code": "NSTOP",
          "codeName": "Server normal stopped state"
        },
        "serverInstanceOperation": {
          "code": "NULL",
          "codeName": "Server NULL OP"
        },
        "serverInstanceStatusName": "stopped",
        "createDate": "2017-12-27T23:56:58+0900",
        "uptime": "2017-12-28T00:03:58+0900",
        "serverImageProductCode": "SPSW0LINUX000031",
        "serverProductCode": "SPSVRSTAND000004",
        "isProtectServerTermination": false,
        "portForwardingPublicIp": "192.168.10.100",
        "zone": {
          "zoneNo": "10",
          "zoneName": "USW-1",
          "zoneDescription": "1st zone"
        },
        "region": {
          "regionNo": "2",
          "regionCode": "USW",
          "regionName": "US-West"
        },
        "baseBlockStorageDiskType": {
          "code": "NET",
          "codeName": "Network Storage"
        },
        "baseBlockStroageDiskDetailType": {
          "code": "HDD",
          "codeName": "HDD"
        },
        "serverInstanceType": {
          "code": "STAND"
          "codeName": "Standard"
        },
        "userData": "",
        "accessControlGroupList": [
          {
            "accessControlGroupConfigurationNo": "1038",
            "accessControlGroupName": "ncloud-default-acg",
            "accessControlGroupDescription": "Default AccessControlGroup",
            "isDefault": true,
            "createDate": "2013-12-03T10:37:39+0900"
          }
        ]
      }
    ]
  }
}
```

```
<?xml version="1.0" encoding="UTF-8"?>
<getServerInstanceListResponse>
  <requestId>581b7b0d-2046-4222-ae16-1ffcfc166e79</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>
      <initScriptNo></initScriptNo>
      <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>
</getServerInstanceListResponse>
```