---
title: "createBlockStorageInstance"
slug: "compute-server-createblockstorageinstance"
tags: ["Server Image", "BlockStorage"]
updated: 2026-10-22T10:47:05Z
published: 2026-10-22T10:47:05Z
canonical: "api-gov.ncloud-docs.com/compute-server-createblockstorageinstance"
---

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

# createBlockStorageInstance

## 개요

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

## 요청

### 요청 파라미터

| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
| --- | --- | --- | --- | --- |
| blockStorageName | No | String | Min : 3, Max : 30 | - 생성할 블록 스토리지명 Default : NAVER Cloud Platform 에서 기본값으로 할당 |
| blockStorageSize | Yes | Long | Min : 10, Max : 2000 | - 생성할 블록 스토리지 사이즈 필수항목이며, 10GB 단위로 입력이 가능하고 최대 2000GB 까지만 입력 가능 |
| blockStorageDescription | No | String | Min : 1, Max : 1000 | 생성할 블록 스토리지에 대한 설명 |
| serverInstanceNo | Yes | String |  | - Attach할 서버 인스턴스 번호 getServerInstanceList 액션을 통해 서버 인스턴스 번호 획득 가능 |
| diskDetailTypeCode | Yes | String |  | - 디스크유형 상세코드 Options : HDD \| SSD Default : HDD |
| responseFormatType | No | String |  | - 응답 결과의 포맷 타입 Options : xml \| json Default : xml |

## 응답

### 응답 바디

- [BlockStorageInstanceList](/docs/common-apidatatype-blockstorageinstancelist)

## 예시

### 요청 예시

```
GET {SERVER_API_URL}/createBlockStorageInstance
?blockStorageSize=10
&serverInstanceNo=1021003
&diskDetailTypeCode=HDD
```

### 응답 예시

```
<createBlockStorageInstanceResponse>
  <requestId>1c844a3f-6149-4223-bcfc-b2fc6294dd17</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <blockStorageInstanceList>
    <blockStorageInstance>
      <blockStorageInstanceNo>1089090</blockStorageInstanceNo>
      <serverInstanceNo>1021003</serverInstanceNo>
      <serverName>s1669aa4e78c</serverName>
      <blockStorageType>
        <code>SVRBS</code>
        <codeName>Server BS</codeName>
      </blockStorageType>
      <blockStorageName>bst167588711f2</blockStorageName>
      <blockStorageSize>10737418240</blockStorageSize>
      <deviceName></deviceName>
      <blockStorageProductCode>SPBSTBSTAD000002</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>2018-11-28T13:15:06+0900</createDate>
      <blockStorageInstanceDescription></blockStorageInstanceDescription>
      <diskType>
        <code>NET</code>
        <codeName>Network Storage</codeName>
      </diskType>
      <diskDetailType>
        <code>HDD</code>
        <codeName>HDD</codeName>
      </diskDetailType>
      <zone>
        <zoneNo>3</zoneNo>
        <zoneName>KR-2</zoneName>
        <zoneCode>KR-2</zoneCode>
        <zoneDescription>평촌 zone</zoneDescription>
        <regionNo>1</regionNo>
      </zone>
    </blockStorageInstance>
  </blockStorageInstanceList>
</createBlockStorageInstanceResponse>
```

## 에러 코드

아래 에러 코드는 이 액션(Action)에서 특징적으로 발생하는 에러입니다. 공통적으로 발생하는 에러에 대한 상세한 설명은 [NAVER Cloud Platform API](/docs/common-ncpapi-ncpapi)를 참고해주세요

| HTTP Response Code | 리턴 코드 | 리턴 메시지 |
| --- | --- | --- |
| 400 | 10300 | Instance name is already in use. please use other name. |
| 400 | 10708 | Server shall not be beyond {0}G2. |
| 400 | 10713 | Not found contract information. Please check your input parameter. |
| 400 | 10723 | Additional storage is not available for Micro Server. |
| 400 | 23001 | Unable to allocate more than {0} storages (included default storage) to the corresponding Linux server. |
| 400 | 23002 | Unable to allocate more than {0} storages (included default storage) to the corresponding Windows server. |
| 400 | 24100 | Input parameter value is invalid. The value of the storage size must be a integer greater than zero. |
| 400 | 24101 | Input parameter value is invalid. The minimum value of the storage size is 10 GB and the maximum, 1 T2. |
| 400 | 24102 | Input parameter value is invalid. The value of storage size must be a multiple of 10 G2. |
| 400 | 24103 | Input parameter value is invalid. The minimum length of the name is 3 bytes and the maximum, 30 bytes. |
| 400 | 24105 | Input parameter value is invalid. The name must contain only lower case letters, digits, and hyphen('-'); it must start with a letter and end with a letter or digit. |
| 400 | 24109 | The input parameter instance number is invalid. |
| 400 | 24120 | The input parameter server instance number is invalid. |
| 400 | 24300 | The length constraints of the parameter description (memo) were violated. The minimum length is 0 byte, the maximum, 1,000 bytes. |
| 400 | 25005 | Unable to perform allocation command since (other) user is either operating the target server which is to be allocated with storage or an error in target server. |