---
title: "createBlockStorageInstance"
slug: "cli-vserver-storage-createblockstorageinstance"
tags: ["Block Storage", "Server", "VPC"]
updated: 2026-09-17T10:11:03Z
published: 2026-09-17T10:11:03Z
canonical: "cli.ncloud-docs.com/cli-vserver-storage-createblockstorageinstance"
---

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

# createBlockStorageInstance

VPC環境で利用できます。

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

## 構文

`createBlockStorageInstance`構文は次の通りです。

```
./ncloud vserver createBlockStorageInstance \
    [--zoneCode <zone-code>] \
    [--serverInstanceNo <server-instance-no>] \
    [--blockStorageVolumeTypeCode <volume-type-code>] \
    [--blockStorageSize <block-storage-size>] \
    [--blockStorageName <block-storage-name>] \
    [--blockStorageDiskDetailTypeCode <SSD|HDD>] \
    [--blockStorageSnapshotInstanceNo <snapshot-instance-no>] \
    [--blockStorageDescription <block-storage-description>] \
    [--isReturnProtection <true|false>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]
```

## オプション

`createBlockStorageInstance`の実行時に指定できるオプションについて説明します。

### 必須オプション

`createBlockStorageInstance`の必須オプションです。

| オプション | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `--zoneCode` | String | Conditional | ゾーンコード - KVMブロックストレージの場合、必ず入力 - [getZoneList](/docs/ja/cli-vserver-server-common-getzonelist)を参照 |
| `--serverInstanceNo` | String | Conditional | サーバインスタンス番号 - XENブロックストレージの場合、必ず入力 - KVMブロックストレージは作成と同時にサーバに割り当て不可 - [getServerInstanceList](/docs/ja/cli-vserver-server-getserverinstancelist)を参照 |
| `--blockStorageVolumeTypeCode` | String | Conditional | ブロックストレージボリュームタイプコード - `SSD` \| `HDD` \| `CB1` \| `FB1` - KVMブロックストレージの場合、必ず入力 - [getBlockStorageVolumeTypeList](/docs/ja/cli-vserver-storage-getblockstoragevolumetypelist)を参照 |
| `--blockStorageSize` | Integer | Conditional | ブロックストレージ容量 (GB) - XEN: `10`~`2000` - KVM: `10`~`16380` - 10GB単位で入力 - XENブロックストレージスナップショットで作成時、自動決定 - KVMブロックストレージスナップショットで作成時、既存のスナップショットサイズ以上に設定 - ストレージタイプごとの制限事項は[ストレージスペック](https://guide.ncloud-docs.com/docs/ja/server-spec-vpc#%EC%8A%A4%ED%86%A0%EB%A6%AC%EC%A7%80-%EC%82%AC%EC%96%91)を参照 |

### 任意オプション

`createBlockStorageInstance`の任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

| オプション | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `--blockStorageName` | String | Optional | ブロックストレージ名 - 未入力時、自動作成 - 英字の小文字、数字、記号の`-`を組み合わせて3~30文字以内で入力 - 文字列の先頭文字は英字の小文字、末尾文字は英字の小文字または数字のみ使用 |
| `--blockStorageDiskDetailTypeCode` | String | Optional | ブロックストレージディスクの詳細タイプコード - `SSD` (デフォルト) \| `HDD` - XENブロックストレージの場合、使用可能 |
| `--blockStorageSnapshotInstanceNo` | String | Optional | ブロックストレージスナップショットインスタンス番号 - 既存のスナップショットでストレージ作成時、入力 - [getBlockStorageSnapshotInstanceList](/docs/ja/cli-vserver-snapshot-getblockstoragesnapshotinstancelist)を参照 |
| `--blockStorageDescription` | String | Optional | ブロックストレージの説明(Byte) - 0~1,000 |
| `--isReturnProtection` | Boolean | Optional | 返却保護にするかどうか - `true` \| `false` - `true`: 保護 - `false`: 保護しない |

### 共通オプション

`vserver`コマンドで共通して使用するオプションについては、[Server (VPC)のオプション](/docs/ja/cli-vserver#%EC%98%B5%EC%85%98)をご参照ください。

## 例

ブロックストレージインスタンスの作成リクエストが成功すると、ブロックストレージの識別情報と初期状態が返されます。

### コマンド

コマンドの例は次の通りです。

```
./ncloud vserver createBlockStorageInstance \
    --serverInstanceNo 34567890 \
    --blockStorageSize 50 \
    --blockStorageName test-block-storage-01 \
    --blockStorageDiskDetailTypeCode SSD \
    --blockStorageDescription "Test block storage" \
    --isReturnProtection false \
    --regionCode KR \
    --output json
```

### 出力

出力の例は次の通りです。

```
{
  "createBlockStorageInstanceResponse": {
    "totalRows": 1,
    "blockStorageInstanceList": [
      {
        "blockStorageInstanceNo": "89012345",
        "serverInstanceNo": "34567890",
        "blockStorageName": "test-block-storage-01",
        "blockStorageType": {
          "code": "SVRBS",
          "codeName": "サーバ BS"
        },
        "blockStorageSize": 53687091200,
        "blockStorageProductCode": "SPBSTBSTAD000006",
        "blockStorageInstanceStatus": {
          "code": "INIT",
          "codeName": "ブロックストレージ INIT状態"
        },
        "blockStorageInstanceOperation": {
          "code": "NULL",
          "codeName": "ブロックストレージ NULL OP"
        },
        "blockStorageInstanceStatusName": "initialized",
        "createDate": "2026-05-14T20:18:21+0900",
        "blockStorageDescription": "Test block storage",
        "blockStorageDiskType": {
          "code": "NET",
          "codeName": "ネットワークストレージ"
        },
        "blockStorageDiskDetailType": {
          "code": "SSD",
          "codeName": "SSD"
        },
        "maxIopsThroughput": 4000,
        "isEncryptedVolume": false,
        "zoneCode": "KR-1",
        "regionCode": "KR",
        "isReturnProtection": false,
        "blockStorageVolumeType": {
          "code": "SSD",
          "codeName": "SSD"
        },
        "hypervisorType": {
          "code": "XEN",
          "codeName": "XEN"
        }
      }
    ],
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```