How to query hard disk usage via web API?

[jtongen]

I'd like to query the amount of hard disk space used on the server (or remaining) via the web API. I see I can query the total size of the hard disks via:

/nodes/{node}/disks/list

(There is a 'size' field in there). How can I query the size used or remaining, of the total size of the disk? It shows up in the webUI, but Im not able to find the rest API to query that information.


I'd like to be able to do this because it seems that proxmox VMs go unstable if the disk usage goes to 100%; it seems to allow additional clones but most of the VMs effectively crash at 100% disk consumption (my vm images are on a separate partition, so the server itself is fine).

 

[steven99]

Have a look at /api2/json/nodes/NODE_NAME/disks/zfs (if ZFS is used ) and that should show the free space . Replacing zfs with "lvm" should show details there but don't use LVM so can not test.

 

[jtongen]

Do I have any options if I use neither zfs nor lvm?

 

[steven99]

Well, what are you using?

/api2/json/nodes/{node}/storage may show you what you want as it should show all storage setup within proxmox.

 

[jtongen]

I'm using hardware RAID, so just using partitions directly.

/api2/json/nodes/{node}/storage works! one of the attrs returned is: used_fraction, so that'll work great for my need. Thanks for the help

 

[DerDanilo]

## Storage usage

pvesh get /nodes/pve1/storage --output-format json-pretty --human-readable 1  | grep -i used_fra

Works fine so far. @jtongen How do you monitor this value? Some bash magic or some other tool/script?

## Overprovisioning

I also would like to monitor overprovisioning status for the lvmthin and directory based storage types. If it grows to much there could be storage problems when burst usage occurs (software updates e.g.).
Clearly it must be available since PVE shows a warning when migrating a disk.

How to do that via CLI?
Or is this a LVM feature showing this info? Any idea?