---
title: "getServerSpecList"
slug: "cli-vserver-server-common-getserverspeclist"
updated: 2026-04-23T09:04:54Z
published: 2026-04-23T09:07:31Z
---

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

# getServerSpecList

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

## 개요

서버 스펙 리스트를 조회합니다.

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| regionCode | No | String |  | - 리전 코드 서버 스펙 리스트가 조회될 리전(Region) 결정 가능 regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능 Default: getRegionList 조회 결과의 첫 번째 리전을 선택 |
| serverImageNo | No | String |  | - 서버 이미지 번호 서버 이미지 번호로 필터링하여 검색 가능 serverImageNo는 [getServerImageList](/docs/cli-vserver-serverimage-getserverimagelist) 액션을 통해 획득 가능 |
| zoneCode | No | String |  | - ZONE 코드 서버 스펙 리스트가 조회될 존(zone) 결정 가능 zoneCode는 [getZoneList](/docs/cli-vserver-server-common-getzonelist) 액션을 통해 획득 가능 |
| serverSpecCodeList.N | No | List<String> |  | - 서버 스펙 코드 리스트 서버 스펙 코드로 필터링하여 검색 가능 ex) serverSpecCodeList.1=m2-g2-h100 |
| hypervisorTypeCodeList.N | No | List<String> |  | - 하이퍼바이저 타입 코드 리스트 하이퍼바이저 타입 코드로 필터링하여 검색 가능 Options: XEN \| RHV \| KVM ex) hypervisorTypeCodeList.1=XEN&hypervisorTypeCodeList.2=KVM |
| output | No | String |  | 응답 결과의 포맷 타입 - Options: xml \| json - Default: json |

## 응답

### 응답 데이터 타입

- ServerSpecList 타입

| ServerSpecList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<serverspec data-tomark-pass=""> serverSpecList = new ArrayList&lt;&gt;();</serverspec> |

| ServerSpec |
| --- |
| private String serverSpecCode; |
| private CommonCode hypervisorType; |
| private CommonCode cpuArchitectureType; |
| private String generationCode; |
| private Integer cpuCount; |
| private Long memorySize; |
| private Integer blockStorageMaxCount; |
| private Long blockStorageMaxIops; |
| private Long blockStorageMaxThroughput; |
| private Long networkPerformance; |
| private Integer networkInterfaceMaxCount; |
| private Integer gpuCount; |
| private String serverSpecDescription; |
| private String serverProductCode; |

## 예시

### 요청 예시

```
ncloud vserver getServerSpecList --regionCode KR --serverImageNo ***5847 --serverSpecCodeList c2-g3 --hypervisorTypeCodeList KVM
```

### 응답 예시

```
<getServerSpecListResponse>
  <requestId></requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <serverSpecList>
    <serverSpec>
      <serverSpecCode>c2-g3</serverSpecCode>
      <hypervisorType>
        <code>KVM</code>
        <codeName>KVM</codeName>
      </hypervisorType>
      <cpuArchitectureType>
        <code>X86_64</code>
        <codeName>x86 64bit</codeName>
      </cpuArchitectureType>
      <generationCode>G3</generationCode>
      <cpuCount>2</cpuCount>
      <memorySize>4294967296</memorySize>
      <blockStorageMaxCount>20</blockStorageMaxCount>
      <blockStorageMaxIops>5250</blockStorageMaxIops>
      <blockStorageMaxThroughput>81</blockStorageMaxThroughput>
      <networkPerformance>17179869184</networkPerformance>
      <networkInterfaceMaxCount>3</networkInterfaceMaxCount>
      <serverSpecDescription>vCPU 2EA, Memory 4GB</serverSpecDescription>
      <productCode>SVR.VSVR.HICPU.C002.M004.G003</productCode>
    </serverSpec>
  </serverSpecList>
</getServerSpecListResponse>
```