---
title: "getServerSpecList"
slug: "cli-vserver-server-common-getserverspeclist"
updated: 2026-04-23T08:56:56Z
published: 2026-04-23T08:58:53Z
canonical: "cli.ncloud-docs.com/cli-vserver-server-common-getserverspeclist"
---

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

# 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 \| 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>
```