changeBlockStorageInstance

Available in VPC

Change the volume size of block storage. For block storage that is assigned to a server, changes can only be made while the server instance is stopped.

Syntax

The changeBlockStorageInstance syntax is as follows:

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

Options

This section describes the options available when running changeBlockStorageInstance.

Required options

The following options are required for changeBlockStorageInstance.

Options	Type	Required	Description
`--blockStorageInstanceNo`	String	Required	Block storage instance number See getBlockStorageInstanceList.
`--blockStorageSize`	Integer	Required	Block storage size (GB) XEN: `10`-`2000` KVM: `10`-`16380` Enter in 10 GB increments. Can only be changed beyond the existing size. Changes take effect after the server expands the file storage size. See Change storage size.

Common options

For information about the options common to all vserver subcommands, see Server (VPC) options.

Examples

If the request to resize a block storage volume is successful, the identification information, along with the updated configuration and status information, is returned.

Command

The command example is as follows:

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

Output

The output example is as follows:

{
  "changeBlockStorageInstanceResponse": {
    "totalRows": 1,
    "blockStorageInstanceList": [
      {
        "blockStorageInstanceNo": "89012345",
        "blockStorageName": "test-block-storage-01",
        "blockStorageType": {
          "code": "SVRBS",
          "codeName": "Server BS"
        },
        "blockStorageSize": 64424509440,
        "blockStorageProductCode": "SPBSTBSTAD000006",
        "blockStorageInstanceStatus": {
          "code": "CREAT",
          "codeName": "Block storage CREATED status"
        },
        "blockStorageInstanceOperation": {
          "code": "CHNG",
          "codeName": "Block storage RESIZE OP"
        },
        "blockStorageInstanceStatusName": "changingSpec",
        "createDate": "2026-05-14T20:18:21+0900",
        "blockStorageDescription": "Test block storage",
        "blockStorageDiskType": {
          "code": "NET",
          "codeName": "Network storage"
        },
        "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"
  }
}

Documentation Index