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

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

# createServerImageFromSnapshot

VPC 환경에서 이용 가능합니다.

## 개요

스냅샷을 사용하여 내 서버 이미지 생성합니다.

주의

KVM 스냅샷만 지원됩니다.

## 요청

### 요청 파라미터

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

## 응답

### 응답 데이터 타입

- 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 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; |

## 예시

### 요청 예시

```
ncloud vserver createServerImageFromSnapshot --regionCode KR --serverImageName test-***
```

### 응답 예시

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