changeBlockStorageInstance

VPC環境で利用できます。

ブロックストレージのボリューム容量を変更します。サーバに割り当てられているブロックストレージの場合は、サーバインスタンスが停止状態でのみ変更が可能です。

構文

changeBlockStorageInstance構文は次の通りです。

./ncloud vserver changeBlockStorageInstance \
    --blockStorageInstanceNo <block-storage-instance-no> \
    --blockStorageSize <block-storage-size> \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

オプション

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

必須オプション

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

共通オプション

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

例

ブロックストレージのボリュームサイズ変更リクエストが成功すると、識別情報と変更後の構成および状態情報が返されます。

コマンド

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

./ncloud vserver changeBlockStorageInstance \
    --blockStorageInstanceNo 89012345 \
    --blockStorageSize 60 \
    --regionCode KR \
    --output json

出力

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

{
  "changeBlockStorageInstanceResponse": {
    "totalRows": 1,
    "blockStorageInstanceList": [
      {
        "blockStorageInstanceNo": "89012345",
        "blockStorageName": "test-block-storage-01",
        "blockStorageType": {
          "code": "SVRBS",
          "codeName": "サーバ BS"
        },
        "blockStorageSize": 64424509440,
        "blockStorageProductCode": "SPBSTBSTAD000006",
        "blockStorageInstanceStatus": {
          "code": "CREAT",
          "codeName": "ブロックストレージ CREATED状態"
        },
        "blockStorageInstanceOperation": {
          "code": "CHNG",
          "codeName": "ブロックストレージ RESIZE OP"
        },
        "blockStorageInstanceStatusName": "changingSpec",
        "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": "a2b3c4d5-e6f7-8901-bcde-567890123456",
    "returnCode": "0",
    "returnMessage": "success"
  }
}