List Proxmox nodes with status and resource usage (CPU, memory in GB, uptime).

List all VMs and containers across the cluster.

Returns vmid, name, node, type (qemu=VM, lxc=container), status, and usage. Optionally filter by type ("qemu" or "lxc").

Detailed current status of one VM or container.

Needs node (e.g. "pve1"), vmid, and type ("qemu" or "lxc"). Use list_guests first to find these.

List storage pools with real usage (GB). Optionally scope to one node.

Uses the per-node endpoint (which reports used/total/avail); with no node it queries every node so usage is populated rather than null.

List what's stored on a storage pool — templates, ISOs, backups, disk images.

content optionally filters by type: vztmpl | iso | backup | images | rootdir. Useful for finding a template/ISO volid or seeing which disk images live on a pool. Needs the node and the storage id (from storage).

Recent task log for a node (migrations, starts, backups, etc.).

Status (and tail of the log) of a Proxmox task by its UPID.

Get a UPID from recent_tasks or from a power tool's return value. Tells you whether the task is running or finished, its exit status ("OK" or an error), and the last log_lines lines of output.

Full provisioning config of a VM/container: cores, memory (MB), disks/mounts, network, etc.

Needs node, vmid, type ("qemu"/"lxc"). Returns Proxmox's raw config keys (e.g. cores, memory, rootfs/mp0…, net0, ostype). Use this to see how a guest is provisioned before calling set_guest_resources.

Live network interfaces and IP addresses of a running guest.

LXC reads directly; QEMU requires the guest agent (returns a note if it's not installed/running). Needs node, vmid, type.

Start a stopped VM or container. Needs node, vmid, type ("qemu"/"lxc").

Gracefully shut down a guest (sends ACPI/clean shutdown to the OS).

Preferred over stop_guest. Needs node, vmid, type.

Hard-stop a guest (pulls the virtual power cord — may lose unsaved data).

Use shutdown_guest unless the guest is unresponsive. Needs node, vmid, type.

Reboot a guest gracefully. Needs node, vmid, type.

Change a guest's CPU cores and/or memory. RECONFIGURES the guest.

• cores: CPU core count (LXC = total cores; QEMU = cores per socket).

• memory_mb: RAM in MB.

Provide at least one. For LXC this applies live (no reboot). For QEMU, core/ memory changes generally take effect on the next reboot. Read the current values first with guest_config. Needs node, vmid, type.

List a guest's snapshots (plus the synthetic current state). Needs node, vmid, type.

Take a snapshot named name — the safety net before a risky change.

Optional description. Returns the task UPID (track with task_status). Needs node, vmid, type.

Roll a guest BACK to snapshot name — discards ALL changes since it. IRREVERSIBLE.

Two-step by design: call without confirm to get a preview (nothing changes); then re-call with confirm set to the guest's exact name to actually roll back. Needs node, vmid, type.

Delete snapshot name (frees its disk usage; does not affect the running guest).

Needs node, vmid, type. Returns the task UPID.

List backup archives on a storage, newest first. Optionally filter to one vmid.

Needs the node and storage id (from storage).

Back up a guest now (vzdump) to storage. mode="snapshot" runs with no downtime.

• mode: snapshot (live, default) | suspend | stop.

• compress: zstd (default) | gzip | lzo | 0 (none).

Returns the task UPID (track with task_status). Needs node, vmid, storage.