attachBlockStorageInstance

VPC環境で利用できます。

ブロックストレージインスタンスをサーバインスタンスに割り当てます。

構文

attachBlockStorageInstance構文は次の通りです。

./ncloud vserver attachBlockStorageInstance \
    --blockStorageInstanceNo <block-storage-instance-no> \
    --serverInstanceNo <server-instance-no> \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

オプション

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

必須オプション

attachBlockStorageInstanceの必須オプションです。

共通オプション

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

例

ブロックストレージインスタンスの割り当てリクエストが成功すると、ブロックストレージインスタンスの最新情報が返されます。

コマンド

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

./ncloud vserver attachBlockStorageInstance \
    --blockStorageInstanceNo 89012345 \
    --serverInstanceNo 34567890 \
    --regionCode KR \
    --output json

出力

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

{
  "attachBlockStorageInstanceResponse": {
    "totalRows": 1,
    "blockStorageInstanceList": [
      {
        "blockStorageInstanceNo": "89012345",
        "serverInstanceNo": "34567890",
        "blockStorageName": "test-block-storage-01",
        "blockStorageType": {
          "code": "SVRBS",
          "codeName": "サーバ BS"
        },
        "blockStorageSize": 53687091200,
        "blockStorageProductCode": "SPBSTBSTAD000006",
        "blockStorageInstanceStatus": {
          "code": "CREAT",
          "codeName": "ブロックストレージ CREATED状態"
        },
        "blockStorageInstanceOperation": {
          "code": "ATTAC",
          "codeName": "ブロックストレージ ATTACH OP"
        },
        "blockStorageInstanceStatusName": "attaching",
        "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": "e1f2a3b4-c5d6-7890-efab-345678901234",
    "returnCode": "0",
    "returnMessage": "success"
  }
}