---
title: "createBlockStorageInstance"
slug: "compute-server-createblockstorageinstance"
updated: 2026-09-17T09:57:42Z
published: 2026-09-17T09:57:42Z
canonical: "api.ncloud-docs.com/compute-server-createblockstorageinstance"
---

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

# createBlockStorageInstance

## 概要

ブロックストレージインスタンスを作成します。

## リクエスト

### リクエストパラメータ

| パラメータ名 | 必須の有無 | タイプ | 制限事項 | 説明 |
| --- | --- | --- | --- | --- |
| blockStorageName | No | String | 最小: 3, 最大: 30 | - 作成するブロックストレージ名 デフォルト: NAVERクラウドプラットフォームがデフォルト値を割り当て |
| blockStorageSize | Yes | Long | 最小: 10, 最大: 2000 | - 作成するブロックストレージの容量 必須入力項目で、10GB単位で最大2000GBまで入力可能 |
| blockStorageDescription | No | String | 最小: 1, 最大: 1000 | 作成するブロックストレージについての説明 |
| serverInstanceNo | Yes | String |  | - Attach対象のサーバインスタンス番号 getServerInstanceListアクションを通じてサーバインスタンス番号を取得 |
| diskDetailTypeCode | Yes | String |  | - ディスクタイプの詳細コード オプション: HDD \| SSD デフォルト: HDD |
| responseFormatType | No | String |  | - レスポンス結果の形式タイプ オプション: xml \| json デフォルト: xml |

## レスポンス

### レスポンスボディ

- [BlockStorageInstanceList](/docs/ja/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>坪村ゾーン</zoneDescription>
        <regionNo>1</regionNo>
      </zone>
    </blockStorageInstance>
  </blockStorageInstanceList>
</createBlockStorageInstanceResponse>
```

## エラーコード

以下のエラーコードは、このアクション(Action)で発生する特徴的なエラーです。共通して発生するエラーについての詳細説明は、[NAVERクラウドプラットフォーム API](/docs/ja/common-ncpapi-index)をご参照ください。

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