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を参照
`--serverInstanceNo`	String	Conditional	サーバインスタンス番号 XENブロックストレージの場合、必ず入力 KVMブロックストレージは作成と同時にサーバに割り当て不可 getServerInstanceListを参照
`--blockStorageVolumeTypeCode`	String	Conditional	ブロックストレージボリュームタイプコード `SSD` \| `HDD` \| `CB1` \| `FB1` KVMブロックストレージの場合、必ず入力 getBlockStorageVolumeTypeListを参照
`--blockStorageSize`	Integer	Conditional	ブロックストレージ容量 (GB) XEN: `10`~`2000` KVM: `10`~`16380` 10GB単位で入力 XENブロックストレージスナップショットで作成時、自動決定 KVMブロックストレージスナップショットで作成時、既存のスナップショットサイズ以上に設定ストレージタイプごとの制限事項はストレージスペックを参照

任意オプション

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

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

共通オプション

vserverコマンドで共通して使用するオプションについては、Server (VPC)のオプションをご参照ください。

例

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

コマンド

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

./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"
  }
}

Documentation Index