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

<p class="platform-info type-vpc">VPC 환경에서 이용 가능합니다.</p>

## 개요<a name="개요"></a>

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


## 요청<a name="요청"></a>

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

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


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

### 응답 데이터 타입<a name="응답데이터타입"></a>
- ServerSpecList 타입

| ServerSpecList extends CommonResponse |
| ---------- |
| private Integer totalRows; |
| private List<ServerSpec> serverSpecList = new ArrayList<>(); |

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


## 예시<a name="예시"></a>

### 요청 예시<a name="요청예시"></a>

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

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

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