---
title: "createBlockStorageSnapshotInstance"
slug: "cli-vserver-snapshot-createblockstoragesnapshotinstance"
tags: ["Snapshot", "BlockStorage", "Server"]
updated: 2026-10-22T09:07:15Z
published: 2026-10-22T09:07:15Z
canonical: "cli-gov.ncloud-docs.com/cli-vserver-snapshot-createblockstoragesnapshotinstance"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# createBlockStorageSnapshotInstance

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

## 개요

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

## 요청

### 요청 파라미터

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

## 응답

### 응답 데이터 타입

- BlockStorageSnapshotInstanceList 타입

| BlockStorageSnapshotInstanceList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<blockstoragesnapshotinstance data-tomark-pass=""> blockStorageSnapshotInstanceList = new ArrayList&lt;&gt;();</blockstoragesnapshotinstance> |

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

## 예시

### 요청 예시

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

### 응답 예시

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