---
title: "getServerProductList"
slug: "cli-server-getserverproductlist"
tags: ["Server"]
updated: 2026-04-23T08:56:57Z
published: 2026-04-23T08:58:53Z
canonical: "cli.ncloud-docs.com/cli-server-getserverproductlist"
---

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

# getServerProductList

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

서버 상품 리스트 조회

## 설명 <a name="설명"></a>

서버 인스턴스를 생성하기 위해서는 서버 상품(서버 스펙)을 선택하여 생성하여야 합니다.
따라서 서버 상품을 조회할 수 있는 API를 제공합니다.

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

| 파라미터 명            | 필수   여부 | 타입   | 제약사항      | 설명                                                         |
| ---------------------- | ----------- | ------ | ------------- | ------------------------------------------------------------ |
| exclusionProductCode   | No          | String | Min:1, Max:20 | 리스트에서 제외할 상품 코드 입력                    |
| productCode            | No          | String | Min:1, Max:20 | 리스트에서 조회할 상품 코드 입력<br> 1건 조회 시 사용 |
| generationCode         | No          | String | Min:1, Max:20 | 리스트에서 조회할 상품 세대코드 입력 [G1, G2 중 하나]   |
| serverImageProductCode | Conditional | String | Min:1, Max:20 | 서버 이미지 상품 코드<br>서버 이미지 상품에 따라서 생성 가능한 서버 스펙이 달라지게 됨<br>serverImageProductCode or memberServerImageNo 두 개의 파라미터 중 하나의 파라미터는 필수 항목<br>getServerImageProdutList 액션을 통해서 획득 가능 |
| regionNo               | No          | String |               | 입력 가능한 상태는 getRegionList 액션을 통해 획득 가능 |
| zoneNo                 | No          | String |               | 상품 리스트가 조회될 ZONE 결정 가능<br>getZoneList 액션을 통해 획득 가능<br>Default:   해당 리전의 첫번째 ZONE을 선택 |
| memberServerImageNo | Conditional | String |               | 회원 서버 이미지 번호<br>EOL OS에 대한 생성 스펙 조회 가능<br>serverImageProductCode or memberServerImageNo 두 개의 파라미터 중 하나의 파라미터는 필수 항목<br>serverImageProductCode 와 memberServerImageNo 모두 입력시 memberServerImageNo 를 이용하여 조회<br>getMemberServerImageList 액션을 통해 획득 가능 |

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

- ProductList 타입

| ProductList extends CommonResponse       |
| ---------------------------------------- |
| private Integer totalRows; |
| private List\<Product\> productList = new ArrayList\<Product\>(); |
    
| Product                                     |
| ------------------------------------------- |
| private String productCode;                 |
| private String generationCode;              |
| private String productName;                 |
| private CommonCode productType;             |
| private String productDescription;          |
| private CommonCode infraResourceType;       |
| private CommonCode infraResourceDetailType; |
| private Integer cpuCount;                   |
| private Long memorySize;                    |
| private Long baseBlockStorageSize;          |
| private CommonCode platformType;            |
| private String osInformation;               |
| private CommonCode diskType;                |
| private String dbKindCode                   |
| private Long addBlockStorageSize;           |

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

### 호출 <a name="호출"></a>
```
ncloud server getServerProductList --serverImageProductCode SPSW0LINUX000043 --productCode SPSVRSSD00000009
```

### 응답 <a name="응답"></a>
 
```json
{
  "getServerProductListResponse": {
    "requestId": "16996ca6-0f2d-46fa-aca4-4903a5aad3e2",
    "returnCode": "0",
    "returnMessage": "success",
    "productList": [
      {
        "productCode": "SPSVRSSD00000009",
        "generationCode": "G1",
        "productName": "vCPU 16EA, Memory 16GB, [SSD]Disk 50GB",
        "productType": {
          "code": "STAND",
          "codeName": "Standard"
        },
        "productDescription": "vCPU 16EA, Memory 16GB, [SSD]Disk 50GB",
        "infraResourceType": {
          "code": "SVR",
          "codeName": "Server"
        },
        "cpuCount": 16,
        "memorySize": 17179869184,
        "baseBlockStorageSize": 53687091200,
        "osInformation": "",
        "diskType": {
          "code": "NET",
          "codeName": "Network Storage"
        },
        "dbKindCode": "",
        "addBlockStorageSize": 0
      }
    ],
    "totalRows": 1
  }
}
```
```xml
<getServerProductListResponse>
  <requestId>6a17f564-8af2-44fe-b416-1c9ce7b2d200</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <productList>
    <product>
      <productCode>SPSVRSSD00000009</productCode>
      <generationCode>G1</generationCode>
      <productName>vCPU 16EA, Memory 16GB, [SSD]Disk 50GB</productName>
      <productType>
        <code>STAND</code>
        <codeName>Standard</codeName>
      </productType>
      <productDescription>vCPU 16EA, Memory 16GB, [SSD]Disk 50GB</productDescription>
      <infraResourceType>
        <code>SVR</code>
        <codeName>Server</codeName>
      </infraResourceType>
      <cpuCount>16</cpuCount>
      <memorySize>17179869184</memorySize>
      <baseBlockStorageSize>53687091200</baseBlockStorageSize>
      <osInformation></osInformation>
      <diskType>
        <code>NET</code>
        <codeName>Network Storage</codeName>
      </diskType>
      <dbKindCode></dbKindCode>
      <addBlockStorageSize>0</addBlockStorageSize>
    </product>
  </productList>
  <totalRows>1</totalRows>
</getServerProductListResponse>
```
