---
title: "createServerImage"
slug: "createserverimage"
updated: 2026-04-23T08:56:52Z
published: 2026-04-23T08:58:50Z
canonical: "cli.ncloud-docs.com/createserverimage"
---

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

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