---
title: "createBlockStorageInstance"
slug: "cli-vserver-storage-createblockstorageinstance"
tags: ["BlockStorage", "Server", "Storage"]
updated: 2026-05-21T09:02:01Z
published: 2026-05-21T09:11:30Z
canonical: "cli-gov.ncloud-docs.com/cli-vserver-storage-createblockstorageinstance"
---

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

# createBlockStorageInstance

<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 조회 결과의 첫 번째 리전을 선택  |
| zoneCode                                        | Conditional           | String                |              -             | - ZONE 코드<br>블록 스토리지 인스턴스가 생성될 존(zone) 결정 가능<br>zoneCode는 [getCodeList](/docs/cli-vserver-server-common-getzonelist) 액션을 통해 획득 가능(KVM 스토리지인 경우 필수)  |
| blockStorageName                                  | No           | String                | Min : 3, Max : 30<br>영어, 숫자, "-"의 특수문자만 허용하며 영어로 시작해야 함<br>영어 또는 숫자로 끝나야 함 | - 블록 스토리지 이름<br/>Default : NAVER Cloud Platform가 자동으로 부여함    |
| blockStorageDiskDetailTypeCode                    | No           | String                |             -              | - 블록 스토리지 디스크 상세 유형 코드<br>생성할 블록 스토리지 디스크 상세 유형 결정 가능<br>XEN 블록 스토리지만 유효<br/>Options : SSD \| HDD<br/>Default : SSD |
| blockStorageVolumeTypeCode                    | Conditional           | String                |                 -          | - 블록 스토리지 볼륨타입 코드<br>생성할 블록 스토리지 볼륨타입 결정 가능<br>blockStorageVolumeTypeCode는 [getBlockStorageVolumeTypeList](/docs/cli-vserver-storage-getblockstoragevolumetypelist) 액션을 통해 획득 가능<br/>KVM 블록 스토리지는 필수<br/>Options : SSD \| HDD \| FB1 \| CB1 <br>|
| serverInstanceNo                                  | Conditional          | String                |              -             | - 서버 인스턴스 번호<br>처음 블록 스토리지 생성시 반드시 서버에 할당되어야 함<br>serverInstanceNo는 [getServerInstanceList](/docs/cli-vserver-server-getserverinstancelist) 액션을 통해 획득 가능<br>XEN 블록 스토리지인 경우 필수<br>KVM 블록 스토리지는 생성과 동시에 서버에 할당하는 것이 지원되지 않으므로 serverInstanceNo가 없어야 함    |
| blockStorageSnapshotInstanceNo                    | No           | String                |                           | - 블록 스토리지 스냅샷 인스턴스 번호<br>직접 생성한 스냅샷으로부터 블록 스토리지를 생성시 입력함<br/>blockStorageSnapshotInstanceNo는 [getBlockStorageSnapshotInstanceList](/docs/cli-vserver-snapshot-getblockstoragesnapshotinstancelist) 액션을 통해 획득 가능  |
| blockStorageSize                                  | Conditional  | Integer               |  - XEN 블록 스토리지<br>Min : 10, Max : 2000 GB<br/>- KVM 블록 스토리지<br>Min : 10, Max : 16380 GB<br>10GB 단위 입력 | - 블록 스토리지 사이즈<br>생성할 블록 스토리지 사이즈 결정 가능<br>XEN 블록 스토리지 스냅샷을 이용하여 생성하는 경우 자동으로 결정됨<br/>KVM 블록 스토리지 스냅샷을 이용하여 생성하는 경우에는 스냅샷 사이즈보다 크거나 같아야합니다.<br>볼륨 타입별 사이즈 제약사항은 사용자 가이드를 참고<br>Compute > Server > VPC > Server 사용 > Server > Block Storage > Block Storage 개요 > Block Storage 개요 |
| blockStorageDescription                           | No           | String                | Min : 0, Max : 1000 Bytes | 생성할 블록 스토리지에 대한 설명 |
| isReturnProtection                 | No           | Boolean               |                           | - 반납 보호 여부<br>반납 보호 여부 설정 가능<br/>Options : true \| false<br>Default : false  |
| output | No | String | | 응답 결과의 포맷 타입<ul><li>Options : xml \| json</li><li>Default : json</li></ul> |

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

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

| BlockStorageInstanceList extends CommonResponse |
| ---------- |
| private Integer totalRows; |
| private List<BlockStorageInstance> blockStorageInstanceList = new ArrayList<>(); |

| BlockStorageInstance |
| ---------- |
| private String blockStorageInstanceNo; |
| private String serverInstanceNo; |
| private String blockStorageName; |
| private CommonCode blockStorageType; |
| private Long blockStorageSize; |
| private String deviceName; |
| private String blockStorageProductCode; |
| private CommonCode blockStorageInstanceStatus; |
| private CommonCode blockStorageInstanceOperation; |
| private String blockStorageInstanceStatusName; |
| private Date createDate; |
| private String blockStorageDescription; |
| private CommonCode blockStorageDiskType; |
| private CommonCode blockStorageDiskDetailType; |
| private Integer maxIopsThroughput; |
| private Boolean isEncryptedVolume; |
| private String zoneCode; |
| private String regionCode; |
| private Boolean isReturnProtection; |


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

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

```
ncloud vserver createBlockStorageInstance --regionCode KR --blockStorageName test-*** --blockStorageDiskDetailTypeCode SSD --serverInstanceNo ***4299 --blockStorageSize 50 --isReturnProtection false
```

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

```xml
<createBlockStorageInstanceResponse>
  <requestId>89254a11-97e3-41d6-9ed2-e9249ebcec7a</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <blockStorageInstanceList>
    <blockStorageInstance>
      <blockStorageInstanceNo>***7746</blockStorageInstanceNo>
      <serverInstanceNo>***4299</serverInstanceNo>
      <blockStorageName>test-***</blockStorageName>
      <blockStorageType>
        <code>SVRBS</code>
        <codeName>Server BS</codeName>
      </blockStorageType>
      <blockStorageSize>53687091200</blockStorageSize>
      <deviceName></deviceName>
      <blockStorageProductCode>SPBSTBSTAD000006</blockStorageProductCode>
      <blockStorageInstanceStatus>
        <code>INIT</code>
        <codeName>Block storage INIT state</codeName>
      </blockStorageInstanceStatus>
      <blockStorageInstanceOperation>
        <code>NULL</code>
        <codeName>Block Storage NULLOP</codeName>
      </blockStorageInstanceOperation>
      <blockStorageInstanceStatusName>initialized</blockStorageInstanceStatusName>
      <createDate>2020-08-24T22:25:35+0900</createDate>
      <blockStorageDescription></blockStorageDescription>
      <blockStorageDiskType>
        <code>NET</code>
        <codeName>Network Storage</codeName>
      </blockStorageDiskType>
      <blockStorageDiskDetailType>
        <code>SSD</code>
        <codeName>SSD</codeName>
      </blockStorageDiskDetailType>
      <maxIopsThroughput>4000</maxIopsThroughput>
      <isEncryptedVolume>false</isEncryptedVolume>
      <zoneCode>KR-1</zoneCode>
      <regionCode>KR</regionCode>
      <isReturnProtection>false</isReturnProtection>
    </blockStorageInstance>
  </blockStorageInstanceList>
</createBlockStorageInstanceResponse>
```