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
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
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.)
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.
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:
The figures in the table come from your site’s plan and take precedence over this summary.
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:
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:
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.
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.
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.
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:
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.
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.
With the API: DELETE /block-storage/volumes/{volume_id}?workspace_id=YOUR-WORKSPACE-ID.
