---
title: "createServerImage"
slug: "createserverimage"
updated: 2026-04-23T09:04:52Z
published: 2026-04-23T09:07:28Z
canonical: "cli-fin.ncloud-docs.com/createserverimage"
---

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

# createServerImage

<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 조회 결과의 첫 번째 리전을 선택                            |ssss
| serverInstanceNo                              | Yes         | String  | -                                                                          | - 원본 서버의 인스턴스 번호                                                                                                                                                                                                    |
| serverImageName                               | Yes         | String  | Min : 3, Max : 30<br>영어, 숫자, "-"의 특수문자만 허용하며 영어로 시작해야 함<br>영어 또는 숫자로 끝나야 함 | - 서버 이미지 이름                                                                                                                                                                                                         |
| serverImageDescription                        | No          | String  | Min : 0, Max : 1000 Bytes                                                  | - 생성할 서버 이미지에 대한 설명                                                                                                                                                                                                 |
| blockStorageList.N.order                      | Yes         | Integer | Min : 0, Max : 20                                                          | - 블럭스토리지 순서<br>생성할 서버 이미지에 할당될 스토리지 순서 결정<br>기본 스토리지가 반드시 한 개 존재 <br>기본 스토리지로 설정하려면 0 입력<br>스토리지는 최대 21개까지 할당 가능                                                                                                |
| blockStorageList.N.snapshotInstanceNo         | Yes         | String  | -                                                                          | - 스토리지 스냅샷 인스턴스 번호<br>서버 이미지를 생성할 대상이 되는 스냅샷 인스턴스 결정<br>snapshotInstanceNo는 [getBlockStorageSnapshotInstanceList](/docs/cli-vserver-snapshot-getblockstoragesnapshotinstancelist) 액션을 통해 획득 가능                  |
| blockStorageList.N.blockStorageSize           | Conditional | Integer | -                                                                          | - 스토리지 크기(GB)<br>생성할 스토리지 크기(GB) 결정<br>스냅샷을 지정한 경우에는 스냅샷 사이즈보다 크거나 같아야합니다.<br>볼륨 타입별 사이즈 제약사항은 사용자 가이드를 참고<br>Compute > Server > VPC > Server 사용 > Server > Block Storage > Block Storage 개요 > Block Storage 개요 |
| blockStorageList.N.blockStorageVolumeTypeCode | Conditional | String  | -                                                                          | - 스토리지 타입<br>생성할 스토리지 타입 결정<br>기본 스토리지는 변경불가. <br>Options : CB1 \| FB1<br> 스토리지 스냅샷 인스턴스 번호(snapshotInstanceNo)와 스토리지 타입(blockStorageVolumeTypeCode) 중 반드시 한 개를 필수로 입력                                          |
| blockStorageList.N.noBlockStorage             | Conditional | Boolean | -                                                                          | - 스토리지 제외 여부<br>스토리지 제외 여부 결정<br>기본 스토리지는 변경불가. <br>Options : true \| false<br> false인 경우, 스토리지 스냅샷 인스 턴스 번호(snapshotInstanceNo)을 필수로 입력                                                                        |
| blockStorageList.N.emptyBlockStorage          | Conditional | Boolean | -                                                                          | - 신규 스토리지 생성 여부<br>스냅샷으로부터 스토리지를 생성하지 않고 신규 스토리지를 생성합니다.<br>기본 스토리지는 변경불가. <br>Options : true \| false<br> false인 경우, 스토리지 스냅샷 인스턴스 번호(snapshotInstanceNo)을 필수로 입력                                              |
| 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&lt;ServerImage&gt; serverImageList = new ArrayList<>(); |

| ServerImage                                                      |
|------------------------------------------------------------------|
| private String serverImageNo;                                    |
| private String serverImageName;                                  |
| private String serverImageDescription;                           |
| private CommonCode serverImageType;                              |
| 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 createServerImage --regionCode KR --serverInstanceNo 1234 --serverImageName test-***
```

### 응답 예시<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>
      <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>
```