---
title: "getServerImageDetail"
slug: "cli-vserver-serverimage-getserverimagedetail"
updated: 2026-04-23T09:04:52Z
published: 2026-04-23T09:07:28Z
---

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

# getServerImageDetail

<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>serverImageNo는 [getServerImageList](/docs/cli-vserver-serverimage-getserverimagelist) 액션을 통해 획득 가능                                                            |
| output | No | String | | 응답 결과의 포맷 타입<ul><li>Options : xml \| json</li><li>Default : json</li></ul> |

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

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

- ServerImageList 타입

| ServerImageList extends CommonResponse                         |
|----------------------------------------------------------------|
| private Integer totalRows;                                     |
| private List<ServerImage> 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<BlockStorageMapping> 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 getServerImageDetail --regionCode KR --serverImageNo ***5847
```

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

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