---
title: "createBlockStorageSnapshotInstance"
slug: "cli-vserver-snapshot-createblockstoragesnapshotinstance"
tags: ["Block Storage", "Server", "VPC"]
updated: 2026-04-23T08:56:53Z
published: 2026-04-23T08:58:50Z
canonical: "cli.ncloud-docs.com/cli-vserver-snapshot-createblockstoragesnapshotinstance"
---

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

# createBlockStorageSnapshotInstance

<p class="platform-info type-vpc">VPC 환경에서 이용 가능합니다.</p>

## 개요<a name="개요"></a>

블록 스토리지 스냅샷 인스턴스를 생성합니다.

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

### 요청 파라미터<a name="요청파라미터"></a>

| 파라미터명                                           | 필수 여부      | 타입                   | 제약 사항                   | 설명                                         |
| ------------------------------------------------- | ------------ | --------------------- | ------------------------- | ------------------------------------------- |
| regionCode                                        | No           | String                |                           | 리전 코드<ul><li>originalBlockStorageInstanceNo 에 해당하는 regionCode 입력 (블록스토리지가 위치한 곳에만 스냅샷 생성 가능)</li><li>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능</li><li>Default : getRegionList 조회 결과의 첫 번째 리전을 선택</li></ul>  |
| originalBlockStorageInstanceNo                    | Yes          | String                |                           | 원본 블록 스토리지 인스턴스 번호<ul><li>스냅샷을 생성할 대상이 되는 블록 스토리지를 결정함</li><li>originalBlockStorageInstanceNo는 [getBlockStorageInstanceList](/docs/cli-vserver-storage-getblockstorageinstancelist) 액션을 통해 획득 가능</li></ul>   |
| blockStorageSnapshotName                          | No           | String                | <ul><li>Min : 3, Max : 30</li><li>영어, 숫자, "-"의 특수문자만 허용하며 영어로 시작해야 함</li><li>영어 또는 숫자로 끝나야 함</li></ul> |  블록 스토리지 스냅샷 이름<ul><li>Default : NAVER CLOUD PLATFORM가 자동으로 부여함</li></ul>    |
| blockStorageSnapshotDescription                   | No           | String                | Min : 0, Max : 1000 Bytes | 생성할 블록 스토리지 스냅샷에 대한 설명 |
| snapshotTypeCode                                  | No           | String                |                           | 스냅샷 유형 코드<ul><li>스냅샷 유형 결정 가능</li><li>증분 스냅샷 생성을 위해서는 전체 스냅샷을 먼저 생성해야 함</li><li>증분 스냅샷은 7개까지 생성 가능</li><li>Options : FULL \| INCREMENTAL</li><li>Default : FULL</li></ul> |
| output | No | String | | 응답 결과의 포맷 타입<ul><li>Options : xml \| json</li><li>Default : json</li></ul> |

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

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

| BlockStorageSnapshotInstanceList extends CommonResponse |
| ---------- |
| private Integer totalRows; |
| private List&lt;BlockStorageSnapshotInstance&gt; blockStorageSnapshotInstanceList = new ArrayList<>(); |

| BlockStorageSnapshotInstance |
| ---------- |
| private String blockStorageSnapshotInstanceNo; |
| private String blockStorageSnapshotName; |
| private Long blockStorageSnapshotVolumeSize; |
| private String originalBlockStorageInstanceNo; |
| private CommonCode blockStorageSnapshotInstanceStatus; |
| private CommonCode blockStorageSnapshotInstanceOperation; |
| private String blockStorageSnapshotInstanceStatusName; |
| private Date createDate; |
| private Boolean isEncryptedOriginalBlockStorageVolume; |
| private String blockStorageSnapshotDescription; |
| private CommonCode snapshotType; |
| private String baseSnapshotInstanceNo; |
| private Integer snapshotChainDepth; |
| private CommonCode hypervisorType;                        |
| private Boolean isBootable;                               |
| private CommonCode blockStorageVolumeType;                |


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

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

```
ncloud vserver createBlockStorageSnapshotInstance --regionCode KR --originalBlockStorageInstanceNo ***7746 --blockStorageSnapshotName test-*** --snapshotTypeCode FULL
```

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

```xml
<createBlockStorageSnapshotInstanceResponse>
  <requestId>82de18de-f08f-4490-84c7-5849fbfd9a5d</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <blockStorageSnapshotInstanceList>
    <blockStorageSnapshotInstance>
      <blockStorageSnapshotInstanceNo>***1951</blockStorageSnapshotInstanceNo>
      <blockStorageSnapshotName>test-***</blockStorageSnapshotName>
      <blockStorageSnapshotVolumeSize>53687091200</blockStorageSnapshotVolumeSize>
      <originalBlockStorageInstanceNo>***7746</originalBlockStorageInstanceNo>
      <blockStorageSnapshotInstanceStatus>
        <code>INIT</code>
        <codeName>Block storage INIT state</codeName>
      </blockStorageSnapshotInstanceStatus>
      <blockStorageSnapshotInstanceOperation>
        <code>NULL</code>
        <codeName>Block Storage NULLOP</codeName>
      </blockStorageSnapshotInstanceOperation>
      <blockStorageSnapshotInstanceStatusName>initialized</blockStorageSnapshotInstanceStatusName>
      <createDate>2020-08-25T10:50:30+0900</createDate>
      <isEncryptedOriginalBlockStorageVolume>false</isEncryptedOriginalBlockStorageVolume>
      <blockStorageSnapshotDescription></blockStorageSnapshotDescription>
      <snapshotType>
        <code>FULL</code>
        <codeName>Full Storage Snapshot</codeName>
      </snapshotType>
      <baseSnapshotInstanceNo/>
      <snapshotChainDepth>0</snapshotChainDepth>
      <isBootable>true</isBootable>
      <hypervisorType>
        <code>KVM</code>
        <codeName>KVM</codeName>
      </hypervisorType>
      <blockStorageVolumeType>
        <code>CB1</code>
        <codeName>Common BlockStorage 1</codeName>
      </blockStorageVolumeType>
    </blockStorageSnapshotInstance>
  </blockStorageSnapshotInstanceList>
</createBlockStorageSnapshotInstanceResponse>
```