attachBlockStorageInstance

Available in VPC

It assigns a block storage instance to the server instance.

Syntax

The attachBlockStorageInstance syntax is as follows:

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

Options

This section describes the options available when running attachBlockStorageInstance.

Required options

The following options are required for attachBlockStorageInstance.

Options	Type	Required	Description
`--blockStorageInstanceNo`	String	Required	Block storage instance number See getBlockStorageInstanceList.
`--serverInstanceNo`	String	Required	Server instance number See getServerInstanceList.

Common options

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

Examples

If the block storage instance allocation request is successful, the latest information about the block storage instance is returned.

Command

The command example is as follows:

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

Output

The output example is as follows:

{
  "attachBlockStorageInstanceResponse": {
    "totalRows": 1,
    "blockStorageInstanceList": [
      {
        "blockStorageInstanceNo": "89012345",
        "serverInstanceNo": "34567890",
        "blockStorageName": "test-block-storage-01",
        "blockStorageType": {
          "code": "SVRBS",
          "codeName": "Server BS"
        },
        "blockStorageSize": 53687091200,
        "blockStorageProductCode": "SPBSTBSTAD000006",
        "blockStorageInstanceStatus": {
          "code": "CREAT",
          "codeName": "Block storage CREATED status"
        },
        "blockStorageInstanceOperation": {
          "code": "ATTAC",
          "codeName": "Block storage ATTACH OP"
        },
        "blockStorageInstanceStatusName": "attaching",
        "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": "e1f2a3b4-c5d6-7890-efab-345678901234",
    "returnCode": "0",
    "returnMessage": "success"
  }
}

Documentation Index