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

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. KVM-based block storage is not supported.

Syntax

The changeBlockStorageVolumeSize syntax is as follows:

./ncloud vserver changeBlockStorageVolumeSize \
    --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 changeBlockStorageVolumeSize.

Required options

The following options are required for changeBlockStorageVolumeSize.

Options Type Required Description
--blockStorageInstanceNo String Required Block storage instance number
--blockStorageSize Integer Required Block storage size (GB)
  • 10-2000
  • 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 changeBlockStorageVolumeSize \
    --blockStorageInstanceNo 89012345 \
    --blockStorageSize 70 \
    --regionCode KR \
    --output json

Output

The output example is as follows:

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