Get storage details for a VM

Retrieve information about disks, filesystems, and storage pools associated with a specific virtual machine (VM). This is useful for monitoring your server's storage space and performance.

VPS Services Storage

Context

Used in the dashboard

/instance/[id]

Where to get IDs / values

Path Parameters

vmid integer · min: 1 required Example: 10000

Unique vmid identifier

Headers

Accept Example
Content-Type Example

Responses

200
data object required
data.blockStats object required
data.blockStats.totalRead string required · Example: 753.67 GB
data.blockStats.totalReadBytes integer required · Example: 809250440722
data.blockStats.totalWrite string required · Example: 6.5 TB
data.blockStats.totalWriteBytes integer required · Example: 7144464573952
data.disks array<object> required · Example: [{"name":"ide0","storage":"block-storage-vm","path":"vm-10073-cloudinit","size":"unknow...
data.disks[].bootOrder integer · nullable required · Example: 1

Nullable: may be null when not applicable.

data.disks[].device string required · Example: /dev/ide0
data.disks[].isCdrom boolean required · Example: true
data.disks[].name string required · Example: ide0
data.disks[].path string required · Example: vm-10073-cloudinit
data.disks[].readBytes integer required · Example: 1465392
data.disks[].readOps integer required · Example: 1142
data.disks[].size string · enum required · Example: unknown
200G
50G
unknown
data.disks[].sizeBytes integer required · Example: 0
data.disks[].sizeFormatted string · enum required · Example: 0 B
0 B
200 GB
50 GB
data.disks[].storage string required · Example: block-storage-vm
data.disks[].type string · enum required · Example: IDE
IDE
SCSI
data.disks[].usedBytes integer required · Example: 32943689728
data.disks[].usedFormatted string required · Example: 30.68 GB
data.disks[].usedPercent integer required · Example: 65
data.disks[].writeBytes integer required · Example: 0
data.disks[].writeOps integer required · Example: 0
data.filesystems array<object> required · Example: [{"mountpoint":"/boot/efi","type":"vfat","name":"sda15","totalBytes":109395456,"totalFo...
data.filesystems[].freeBytes integer required · Example: 102995968
data.filesystems[].freeFormatted string required · Example: 98.22 MB
data.filesystems[].mountpoint string required · Example: /boot/efi
data.filesystems[].name string required · Example: sda15
data.filesystems[].totalBytes integer required · Example: 109395456
data.filesystems[].totalFormatted string · enum required · Example: 104.33 MB
104.33 MB
192.68 GB
47.37 GB
818.74 MB
data.filesystems[].type string · enum required · Example: vfat
ext4
vfat
data.filesystems[].usedBytes integer required · Example: 6399488
data.filesystems[].usedFormatted string required · Example: 6.1 MB
data.filesystems[].usedPercent integer required · Example: 6
data.guestAgentAvailable boolean required · Example: true
data.storagePools array<object> required · Example: [{"storage":"local","type":"dir","content":"images","active":0,"enabled":0,"shared":0,"...
data.storagePools[].active integer required · Example: 0
data.storagePools[].available integer required · Example: 0
data.storagePools[].content string required · Example: images
data.storagePools[].enabled integer required · Example: 0
data.storagePools[].shared integer required · Example: 0
data.storagePools[].storage string · enum required · Example: local
block-storage
block-storage-vm
fleecing-storage
iso
local
local-btrfs
local-zfs
pbs-offsite-10g
data.storagePools[].total integer required · Example: 0
data.storagePools[].type string · enum required · Example: dir
btrfs
cephfs
dir
pbs
rbd
zfspool
data.storagePools[].used integer required · Example: 0
data.storagePools[].usedPercent integer required · Example: 0
data.vmNotRunning boolean required · Example: false
requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

GET https://cloud.hostup.se/api/vm/{vmid}/storage
For AI assistants
cURL 
curl -X GET "https://cloud.hostup.se/api/vm/10000/storage" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response 
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "disks": [
      {
        "name": "ide0",
        "storage": "block-storage-vm",
        "path": "vm-10073-cloudinit",
        "size": "unknown",
        "type": "IDE",
        "device": "/dev/ide0",
        "isCdrom": true,
        "bootOrder": null,
        "sizeBytes": 0,
        "sizeFormatted": "0 B",
        "usedBytes": 32943689728,
        "usedFormatted": "30.68 GB",
        "usedPercent": 65,
        "readBytes": 1465392,
        "writeBytes": 0,
        "readOps": 1142,
        "writeOps": 0
      },
      {
        "name": "scsi0",
        "storage": "block-storage-vm",
        "path": "vm-10073-disk-0",
        "size": "50G",
        "type": "SCSI",
        "device": "/dev/scsi0",
        "isCdrom": false,
        "bootOrder": 1,
        "sizeBytes": 53687091200,
        "sizeFormatted": "50 GB",
        "usedBytes": 32943689728,
        "usedFormatted": "30.68 GB",
        "usedPercent": 65,
        "readBytes": 809248932864,
        "writeBytes": 7144464573952,
        "readOps": 133429279,
        "writeOps": 821426307
      }
    ],
    "filesystems": [
      {
        "mountpoint": "/boot/efi",
        "type": "vfat",
        "name": "sda15",
        "totalBytes": 109395456,
        "totalFormatted": "104.33 MB",
        "usedBytes": 6399488,
        "usedFormatted": "6.1 MB",
        "freeBytes": 102995968,
        "freeFormatted": "98.22 MB",
        "usedPercent": 6
      },
      {
        "mountpoint": "/boot",
        "type": "ext4",
        "name": "sda16",
        "totalBytes": 858513408,
        "totalFormatted": "818.74 MB",
        "usedBytes": 122019840,
        "usedFormatted": "116.37 MB",
        "freeBytes": 736493568,
        "freeFormatted": "702.38 MB",
        "usedPercent": 14
      },
      {
        "_truncated": "... and 1 more items"
      }
    ],
    "storagePools": [
      {
        "storage": "local",
        "type": "dir",
        "content": "images",
        "active": 0,
        "enabled": 0,
        "shared": 0,
        "total": 0,
        "used": 0,
        "available": 0,
        "usedPercent": 0
      },
      {
        "storage": "local-zfs",
        "type": "zfspool",
        "content": "rootdir,images",
        "active": 0,
        "enabled": 0,
        "shared": 0,
        "total": 0,
        "used": 0,
        "available": 0,
        "usedPercent": 0
      },
      {
        "_truncated": "... and 4 more items"
      }
    ],
    "blockStats": {
      "totalRead": "753.67 GB",
      "totalWrite": "6.5 TB",
      "totalReadBytes": 809250440722,
      "totalWriteBytes": 7144464573952
    },
    "guestAgentAvailable": true,
    "vmNotRunning": false
  }
}