pve_agent_info
Query a Proxmox guest's QEMU agent for system information (OS, hostname, users, network). Use exec-status with a PID to poll command completion.
Instructions
READ-ONLY: query the qemu-agent on a guest (ping, osinfo, hostname, users, exec-status, …).
Requires PROXIMO_ENABLE_AGENT=1, the VMID in PROXIMO_AGENT_ALLOWLIST, and a running guest agent inside the VM. No confirm needed — read-only. Returns a dict of the raw qemu-agent response fields for the chosen command; for command='exec-status', run pve_agent_exec first and pass its returned pid here to poll for completion.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pid | No | Process id returned by pve_agent_exec; required only when command='exec-status'. | |
| node | No | Proxmox node name hosting the guest; auto-detected if omitted. | |
| vmid | Yes | Numeric VM ID of the guest to query via the qemu-agent. | |
| command | No | qemu-agent query: ping, info, get-fsinfo, get-host-name, get-osinfo, get-time, get-timezone, get-users, get-vcpus, network-get-interfaces, get-memory-blocks, fsfreeze-status, or exec-status. | info |
| proximo_target | No | Which configured Proxmox target to run this call against — a target name from your multi-target config (a specific PVE/PBS/PMG/PDM box). Omit to use the single/default target from the environment; the selection applies only to this call. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |