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.

changeBlockStorageVolumeSize

Prev Next

VPC環境で利用できます。

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

構文

changeBlockStorageVolumeSize構文は次の通りです。

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

オプション

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

必須オプション

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

オプション タイプ 必須の有無 説明
--blockStorageInstanceNo String Required ブロックストレージインスタンス番号
--blockStorageSize Integer Required ブロックストレージ容量 (GB)
  • 10~2000
  • 10GB単位で入力
  • 既存の容量以上にのみ変更可能
  • 変更結果は、サーバでファイルストレージ容量を拡張してから適用
  • ストレージ容量の変更を参照

共通オプション

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

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

コマンド

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

./ncloud vserver changeBlockStorageVolumeSize \
    --blockStorageInstanceNo 89012345 \
    --blockStorageSize 70 \
    --regionCode KR \
    --output json

出力

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

{
  "changeBlockStorageVolumeSizeResponse": {
    "totalRows": 1,
    "blockStorageInstanceList": [
      {
        "blockStorageInstanceNo": "89012345",
        "blockStorageName": "test-block-storage-01",
        "blockStorageType": {
          "code": "SVRBS",
          "codeName": "サーバ BS"
        },
        "blockStorageSize": 75161927680,
        "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": "b3c4d5e6-f7a8-9012-cdef-678901234567",
    "returnCode": "0",
    "returnMessage": "success"
  }
}