Skip to navigation

Create a volume

A Block Storage volume is an extra NVMe disk for a Cloud VM or GPU VM. This page shows how to create one, how to make it bigger later, and how to delete it. A new volume is blank: after you create it, attach it to a VM and format it there.

When to use a volume

You want to…Do this
More disk space for one VM, kept separate from the VMCreate a volume (this page)
More space on an existing volumeResize the volume
A copy of a VM’s disks at a point in timeTake a snapshot
Store files to serve over the internetUse Object Storage

Before you begin

  • Identity verification completed for your account. If the portal shows a Complete KYC Verification banner, finish identity verification first.
  • Wallet credit. The portal checks your organization’s billing before it creates a volume. See Billing and usage.
  • The location (site) of the VM you’ll attach the volume to. A volume can only be attached to VMs in its own site, and the site can’t be changed later.
  • Permission to create resources in the workspace.

Create a volume

1

Open Block Storage

In the portal sidebar, click Block Storage under Infrastructure, then click + Add Volume. (With no volumes yet, the page shows No block volumes yet and the same button.)

2

Choose the location

Under Location, click the card for your VM’s site. Each card shows the location name and site code, for example VGA.

3

Choose the storage type

Under Storage type, select NVMe SSD.

4

Choose the size

Under Volume size, click a row in the table, or enter a size in the Custom row (for example 750). Each row shows the Performance tier, IOPS, Throughput and the monthly and hourly price. The range is 10 GB to 2,000 GB unless the storage plan for the site sets other values:

SizeTierTypical profile
Up to 500 GBStandardAbout 5,000 shared IOPS, up to 125 MiB/s
Above 500 GBHigh PerformanceAbout 10,000 shared IOPS, up to 400 MiB/s

The figures in the table come from your site’s plan and take precedence over this summary.

5

Name the volume

Under Volume details, enter a Volume name: at least 3 characters, lowercase letters, numbers and hyphens only. Examples: db-data, web-uploads.

6

Create it

Check the summary and price at the bottom of the page and click Create Volume. The portal runs a billing check, shows Volume “db-data” is being created, and opens the volume. Its status changes from Creating to Ready. Billing starts now.

Create a volume with the API

Use a platform API token with the block-storage.write scope. First list the plans offered at your site, then create the volume:

# 1. See plans, sizes and prices for the site
curl "https://api.ibee.ai/v1/block-storage/plans?workspace_id=YOUR-WORKSPACE-ID&site_id=YOUR-SITE-ID" \
-H "Authorization: Bearer $IBEE_API_TOKEN"
# 2. Create a 100 GB volume
curl -X POST "https://api.ibee.ai/v1/block-storage/volumes?workspace_id=YOUR-WORKSPACE-ID" \
-H "Authorization: Bearer $IBEE_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "db-data", "size_gb": 100, "site_id": "YOUR-SITE-ID"}'

Creation is asynchronous. Poll GET /block-storage/volumes/{volume_id}/operations until the operation’s status is succeeded (or failed).

Verify

Open Block Storage. The volume is listed with status Ready. Click it to see the Overview tab:

FieldShows
Volume NameThe name you entered
SizeThe provisioned size
ClassBalanced for the standard NVMe class
LocationThe site
ReplicasCopies the platform keeps (2 by default)
CreatedCreation time
Volume IDThe ID, with a copy button

Under it, Attach to Server starts the attach. See Attach and detach a volume.

Resize a volume

You can make a volume bigger at any time. You can’t make it smaller.

Take a snapshot of the VM before you resize a volume that holds important data. A resize can’t be undone.

1

Open the resize dialog

Open the volume and click Resize volume (or Increase size next to Size). From the list, open the volume’s actions menu and choose Resize Volume.

2

Pick the new size

Enter a New size in GB or click a quick size. The dialog shows the allowed range (Increase only) and a quote: the Current and New monthly price and the Monthly change. The new price applies only after the resize succeeds.

3

Check the attached VM

If the volume is attached to a running VM, the dialog asks you to stop or suspend the VM first and refresh — the safer, offline path. Where the VM supports it, you can instead tick I understand the risk and want to resize while the server is running.

4

Resize

Tick I understand that volume size can only be increased and that I must expand the guest filesystem after the resize. and click Resize to (for example Resize to 200 GB). The status shows Resizing, then the toast Volume resized to 200 GB appears.

With the API, send POST /block-storage/volumes/{volume_id}/resize with {"new_size_gb": 200}. For a volume attached to a running VM, also send "vm_state": "running" and "allow_online": true.

Expand the file system

The new space can’t be used until you grow the file system inside the VM. The dialog shows these commands after the resize, for Linux · ext4, Linux · XFS and Windows. Check the device and partition with lsblk -f first:

lsblk -f
# Only if the file system is inside a partition: grow partition 1 first
sudo growpart /dev/vdb 1
# ext4 (use the partition, for example /dev/vdb1, or the whole disk /dev/vdb)
sudo resize2fs /dev/vdb1
# XFS (pass the mount point)
sudo xfs_growfs /mnt/data
df -h

On Windows, open Disk Management, choose Action → Rescan Disks, right-click the volume and choose Extend Volume.

Delete a volume

Deleting a volume erases all its data permanently. Copy anything you need first.

1

Unmount and detach

Unmount the volume inside the VM, then detach it. Delete on the volume page refuses an attached volume with Detach this volume from all servers before deleting.

2

Delete

Click Delete on the volume page, or Delete in the volume’s actions menu. In the Delete Volume dialog, click Delete Volume. The toast Volume “db-data” deleted confirms it, and billing stops.

With the API: DELETE /block-storage/volumes/{volume_id}?workspace_id=YOUR-WORKSPACE-ID.

Limits and billing

Value
Size10–2,000 GB in the portal; the API accepts 1–10,000 GB, within the plan’s range
ResizeIncrease only
NameAt least 3 characters; lowercase letters, numbers, hyphens
Replicas2 by default
SiteFixed at creation
BillingPer GB of provisioned size per month, from creation until deletion — including while detached
Price change on resizeFrom the moment the resize succeeds

Troubleshooting

You seeWhat it meansWhat to do
A billing error after Create VolumeThe billing check failed, for example the wallet balance doesn’t cover the volumeAdd credit under Billing, then try again.
Complete KYC Verification bannerIdentity verification isn’t completeFinish identity verification.
Limit reached (X%) — Increase instead of Create VolumeYour organization reached its usage limitClick it, then Raise a support ticket.
Lowercase letters, numbers, and hyphens. At least 3 characters. in redThe name has spaces, dots, underscores or capitals, or is too shortUse a name like db-data.
The volume stays CreatingCreation hasn’t finishedRefresh the page. If it doesn’t reach Ready, contact support with the Volume ID.
The VM still shows the old size after a resizeThe file system wasn’t expandedRun the commands in Expand the file system.
Detach this volume from all servers before deleting.The volume is attachedUnmount and detach it first.