--- title: "getBlockStorageInstanceList" slug: "cli-vserver-storage-getblockstorageinstancelist" 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-getblockstorageinstancelist" --- > ## 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. # getBlockStorageInstanceList VPC環境で利用できます。 ブロックストレージインスタンスリストを照会します。 ## 構文 `getBlockStorageInstanceList`構文は次の通りです。 ``` ./ncloud vserver getBlockStorageInstanceList \ [--zoneCode ] \ [--blockStorageInstanceNoList ] \ [--blockStorageName ] \ [--blockStorageInstanceStatusCode ] \ [--blockStorageDiskTypeCode ] \ [--blockStorageDiskDetailTypeCode ] \ [--blockStorageSize ] \ [--blockStorageTypeCodeList ] \ [--blockStorageVolumeTypeCodeList ] \ [--hypervisorTypeCodeList ] \ [--serverInstanceNo ] \ [--serverName ] \ [--connectionInfo ] \ [--pageNo ] \ [--pageSize ] \ [--regionCode ] \ [--output ] ``` ## オプション `getBlockStorageInstanceList`の実行時に指定できるオプションについて説明します。 ### 必須オプション `getBlockStorageInstanceList`の必須オプションです。 | オプション | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `--pageSize` | Integer | Conditional | ページごとの項目数 - `1`~`1000` (デフォルト: `1`) - `pageNo`入力時、必ず入力 | ### 任意オプション `getBlockStorageInstanceList`の任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。 | オプション | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `--zoneCode` | String | Optional | ゾーンコード - [getZoneList](/docs/ja/cli-vserver-server-common-getzonelist)を参照 | | `--blockStorageInstanceNoList` | List | Optional | ブロックストレージインスタンス番号リスト - スペースで区切って複数入力可能 (例: `--blockStorageInstanceNoList 1234 2345`) | | `--blockStorageName` | String | Optional | ブロックストレージ名 - `blockStorageName`、`serverName`、`connectionInfo`のうち、1つだけ使用 | | `--blockStorageInstanceStatusCode` | String | Optional | ブロックストレージインスタンスの状態コード - `INIT` \| `CREAT` \| `ATTAC` - `INIT`: 作成中 - `CREAT`: 使用可能 - `ATTAC`: 使用中 | | `--blockStorageDiskTypeCode` | String | Optional | ブロックストレージのディスクタイプコード - `NET`: ネットワークディスク | | `--blockStorageDiskDetailTypeCode` | String | Optional | ブロックストレージディスクの詳細タイプコード - `HDD` \| `SSD` | | `--blockStorageSize` | Integer | Optional | ブロックストレージ容量 (GB) - 入力した容量以下のブロックストレージを照会 | | `--blockStorageTypeCodeList` | List | Optional | ブロックストレージタイプコードリスト - `BASIC` \| `SVRBS` - `BASIC`: 基本ストレージ - `SVRBS`: 追加ストレージ - スペースで区切って複数入力可能 (例: `--blockStorageTypeCodeList BASIC SVRBS`) | | `--blockStorageVolumeTypeCodeList` | List | Optional | ブロックストレージボリュームタイプコードリスト - `HDD` \| `SSD` \| `FB1` \| `CB1` - スペースで区切って複数入力可能 (例: `--blockStorageVolumeTypeCodeList SSD CB1`) | | `--hypervisorTypeCodeList` | List | Optional | ハイパーバイザタイプコードリスト - `XEN` \| `KVM` - スペースで区切って複数入力可能 (例: `--hypervisorTypeCodeList XEN KVM`) - [getHypervisorTypeList](/docs/ja/cli-vserver-server-common-gethypervisortypelist)を参照 | | `--serverInstanceNo` | String | Optional | サーバインスタンス番号 - [getServerInstanceList](/docs/ja/cli-vserver-server-getserverinstancelist)を参照 | | `--serverName` | String | Optional | ブロックストレージ接続サーバ名 - `blockStorageName`、`serverName`、`connectionInfo`のうち、1つだけ使用 | | `--connectionInfo` | String | Optional | ブロックストレージ接続情報 - {サーバ名} {デバイス名}または{サーバ名}:{デバイス名}形式で入力 (例: `s173dc67dc2e /dev/xvda`、`s173dc67dc2e:/dev/xvda`) - `blockStorageName`、`serverName`、`connectionInfo`のうち、1つだけ使用 | | `--pageNo` | Integer | Optional | ページ番号 - `0`~N (デフォルト: `0`) - 最初のページ: `0`または`1`を入力 | ### 共通オプション `vserver`コマンドで共通して使用するオプションについては、[Server (VPC)のオプション](/docs/ja/cli-vserver#%EC%98%B5%EC%85%98)をご参照ください。 ## 例 ブロックストレージインスタンスリストの照会リクエストが成功すると、各ブロックストレージの識別情報および構成情報が返されます。 ### コマンド コマンドの例は次の通りです。 ``` ./ncloud vserver getBlockStorageInstanceList \ --zoneCode KR-1 \ --blockStorageInstanceStatusCode ATTAC \ --blockStorageDiskTypeCode NET \ --blockStorageDiskDetailTypeCode SSD \ --blockStorageTypeCodeList BASIC SVRBS \ --blockStorageVolumeTypeCodeList SSD CB1 \ --hypervisorTypeCodeList XEN KVM \ --pageNo 0 \ --pageSize 10 \ --regionCode KR \ --output json ``` ### 出力 出力の例は次の通りです。 ``` { "getBlockStorageInstanceListResponse": { "totalRows": 3, "blockStorageInstanceList": [ { "blockStorageInstanceNo": "89012345", "serverInstanceNo": "34567890", "blockStorageName": "test-block-storage-01", "blockStorageType": { "code": "SVRBS", "codeName": "サーバ BS" }, "blockStorageSize": 53687091200, "deviceName": "/dev/xvdb", "blockStorageProductCode": "SPBSTBSTAD000006", "blockStorageInstanceStatus": { "code": "ATTAC", "codeName": "ブロックストレージ ATTACHED状態" }, "blockStorageInstanceOperation": { "code": "NULL", "codeName": "ブロックストレージ NULL OP" }, "blockStorageInstanceStatusName": "attached", "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" } }, { "blockStorageInstanceNo": "89012346", "serverInstanceNo": "34567890", "blockStorageName": "test-server-02", "blockStorageType": { "code": "BASIC", "codeName": "基本 BS" }, "blockStorageSize": 53687091200, "deviceName": "/dev/xvda", "blockStorageProductCode": "SPBSTBSTBS000005", "blockStorageInstanceStatus": { "code": "ATTAC", "codeName": "ブロックストレージ ATTACHED状態" }, "blockStorageInstanceOperation": { "code": "NULL", "codeName": "ブロックストレージ NULL OP" }, "blockStorageInstanceStatusName": "attached", "createDate": "2026-05-14T17:29:43+0900", "blockStorageDescription": "test-server-02's basic 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" } }, { "blockStorageInstanceNo": "89012347", "serverInstanceNo": "34567891", "blockStorageName": "test-server-01", "blockStorageType": { "code": "BASIC", "codeName": "基本 BS" }, "blockStorageSize": 10737418240, "deviceName": "/dev/vda", "blockStorageProductCode": "BST.CB.CB1.V001", "blockStorageInstanceStatus": { "code": "ATTAC", "codeName": "ブロックストレージ ATTACHED状態" }, "blockStorageInstanceOperation": { "code": "NULL", "codeName": "ブロックストレージ NULL OP" }, "blockStorageInstanceStatusName": "attached", "createDate": "2026-04-28T13:01:30+0900", "blockStorageDescription": "test-server-01's basic storage", "blockStorageDiskType": { "code": "NET", "codeName": "ネットワークストレージ" }, "blockStorageDiskDetailType": { "code": "SSD", "codeName": "SSD" }, "maxIopsThroughput": 100, "isEncryptedVolume": false, "zoneCode": "KR-1", "regionCode": "KR", "isReturnProtection": false, "blockStorageVolumeType": { "code": "CB1", "codeName": "Common BlockStorage 1" }, "hypervisorType": { "code": "KVM", "codeName": "KVM" }, "throughput": 104857600, "iops": 100, "blockStorageSnapshotInstanceNo": 90123456 } ], "requestId": "b1c2d3e4-f5a6-7890-bcde-f12345678901", "returnCode": "0", "returnMessage": "success" } } ```