---
title: "getServerImageList"
slug: "cli-vserver-serverimage-getserverimagelist"
updated: 2026-04-23T08:56:52Z
published: 2026-04-23T08:58:50Z
canonical: "cli.ncloud-docs.com/cli-vserver-serverimage-getserverimagelist"
---

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

# getServerImageList

<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 조회 결과의 첫 번째 리전을 선택                     |
| serverImageNoList.N        | No          | List&lt;String&gt; |       | - 서버 이미지 번호 리스트<br>서버 이미지 번호로 필터링하여 검색 가능<br>serverImageNo는 [getServerImageList](/docs/cli-vserver-serverimage-getserverimagelist) 액션을 통해 획득 가능<br>ex) serverImageNoList.1=1234&serverImageNoList.2=2345 |
| serverImageName            | No          | String             |       | - 서버 이미지 이름<br>서버 이미지 이름으로 필터링하여 검색 가능                                                                                                                                                                   |
| serverImageStatusCode      | No          | String             |       | - 서버 이미지 상태 코드<br>서버 이미지 상태 코드로 필터링하여 검색 가능<br>Options : INIT \| CREAT \| CREFL                                                                                                                                  |
| serverImageTypeCodeList.N  | No          | List&lt;String&gt; |       | - 서버 이미지 타입 코드 리스트<br>서버 이미지 타입 코드로 필터링하여 검색 가능<br>Options : SELF \| NCP<br>ex) serverImageTypeCodeList.1=NCP                                                                                            |
| hypervisorTypeCodeList.N   | No          | List&lt;String&gt; |       | - 하이퍼바이저 타입 코드 리스트<br>하이퍼바이저 타입 코드로 필터링하여 검색 가능<br>Options : XEN \| KVM<br>ex) hypervisorTypeCodeList.1=XEN&hypervisorTypeCodeList.2=KVM                                                                 |
| osTypeCodeList.N           | No          | List&lt;String&gt; |       | - OS 타입 코드 리스트<br>OS 타입 코드로 필터링하여 검색 가능<br>Options : CENTOS \| UBUNTU \| WINDOWS \| ROCKY \| NAVIX<br>ex) osTypeCodeList.1=CENTOS&osTypeCodeList.2=UBUNTU                                                                  |
| platformCategoryCodeList.N | No          | List&lt;String&gt; |       | - 플랫폼 카테고리 코드 리스트<br>플랫폼 카테고리 코드로 필터링하여 검색 가능<br>Options : OS \| APP \| DBMS \| GPU<br>ex) platformCategoryCodeList.1=OS&platformCategoryCodeList.2=GPU                                                  |
| pageNo                     | No          | Integer            |       | - 페이징된 결과의 페이지 번호<br>결과값을 pageNo, pageSize를 이용하여 페이징 처리 가능                                                                                                                                               |
| pageSize                   | Conditional | Integer            |       | - 페이징 시 보여줄 각 페이지 사이즈<br>결과값을 pageNo, pageSize를 이용하여 페이징 처리 가능<br>pageNo 입력시 반드시 입력 필요                                                                                                                   |
| sortedBy                   | No          | String             |       | - 정렬 대상<br>결과값을 서버 이미지 이름으로 정렬 가능<br>Options : serverImageName                                                                                                                                           |
| sortingOrder               | No          | String             |       | - 정렬 순서<br>sortedBy 이용시 오름차순/내림차순 정렬을 설정<br>Options : ASC (오름차순) \| DESC (내림차순)<br>Default : ASC                                                                                                         |
| output                     | No          | String             |       | - 응답 결과의 포맷 타입<br>Options : xml \| json<br>Default : json                                                                                                                                                |

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

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

- ServerImageList 타입

| ServerImageList extends CommonResponse                               |
|----------------------------------------------------------------------|
| private Integer totalRows;                                           |
| private List&lt;ServerImage&gt; serverImageList = new ArrayList<>(); |

| ServerImage                                                      |
|------------------------------------------------------------------|
| private String serverImageNo;                                    |
| private String serverImageName;                                  |
| private String serverImageDescription;                           |
| private CommonCode serverImageType;                              |
| private CommonCode serverImageLifeCyclePhase;                    |
| private CommonCode hypervisorType;                               |
| private CommonCode cpuArchitectureType;                          |
| private CommonCode osCategoryType;                               |
| private CommonCode osType;                                       |
| private String serverImageStatusName;                            |
| private CommonCode serverImageStatus;                            |
| private CommonCode serverImageOperation;                         |
| private String serverImageProductCode;                           |
| private Date createDate;                                         |
| private CommonCode shareStatus;                                  |
| private SharedLoginIdList sharedLoginIdList;                     |
| private String platformCategoryCode;                             |
| private List&lt;BlockStorageMapping&gt; blockStorageMappingList; |

| BlockStorageMapping                            |
|------------------------------------------------|
| private Integer order;                         |
| private String blockStorageSnapshotInstanceNo; |
| private String blockStorageSnapshotName;       |
| private Long blockStorageSize;                 |
| private String blockStorageName;               |
| private CommonCode blockStorageVolumeType;     |
| private Long iops;                             |
| private Long throughput;                       |
| private Boolean isEncryptedVolume;             |

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

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

```
ncloud vserver getServerImageList --regionCode KR --serverImageNoList ***5847 --serverImageName test-*** --serverImageStatusCode CREAT --osTypeCodeList CENTOS
```

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

```xml
<getServerImageListResponse>
  <requestId></requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <serverImageList>
    <serverImage>
      <serverImageNo>***5847</serverImageNo>
      <serverImageName>test-***</serverImageName>
      <serverImageDescription></serverImageDescription>
      <serverImageType>
        <code>NCP</code>
        <codeName>NCP Server Image</codeName>
      </serverImageType>
      <serverImageLifeCyclePhase>
        <code>IN_SERVICE</code>
        <codeName>In Service</codeName>
      </serverImageLifeCyclePhase>
      <hypervisorType>
        <code>XEN</code>
        <codeName>XEN</codeName>
      </hypervisorType>
      <cpuArchitectureType>
        <code>X86_64</code>
        <codeName>x86 64bit</codeName>
      </cpuArchitectureType>
      <osCategoryType>
        <code>LINUX</code>
        <codeName>LINUX</codeName>
      </osCategoryType>
      <osType>
        <code>CENTOS</code>
        <codeName>CENTOS</codeName>
      </osType>
      <serverImageProductCode>SW.VSVR.OS.LNX64.CNTOS.0703.B050</serverImageProductCode>
      <serverImageStatus>
        <code>CREAT</code>
        <codeName>Server created state</codeName>
      </serverImageStatus>
      <serverImageOperation>
        <code>NULL</code>
        <codeName>NULL OP</codeName>
      </serverImageOperation>
      <serverImageStatusName>created</serverImageStatusName>
      <createDate>2020-08-24T10:34:27+0900</createDate>
      <blockStorageMappingList>
        <blockStorageMapping>
          <order>0</order>
          <blockStorageSize>53687091200</blockStorageSize>
          <blockStorageVolumeType>
            <code>HDD</code>
            <codeName>HDD</codeName>
          </blockStorageVolumeType>
          <isEncryptedVolume>false</isEncryptedVolume>
        </blockStorageMapping>
      </blockStorageMappingList>
      <shareStatus>
        <code>NULL</code>
        <codeName>NSI Share NULL State</codeName>
      </shareStatus>
      <sharedLoginIdList/>
      <platformCategoryCode>OS</platformCategoryCode>
    </serverImage>
  </serverImageList>
</getServerImageListResponse>
```