pve_agent_info
Query a QEMU guest agent to retrieve OS info, hostname, users, network interfaces, and status. Read-only, no confirmation required.
Instructions
READ-ONLY: query the qemu-agent on a guest (ping, osinfo, hostname, users, exec-status, …).
Requires PROXIMO_ENABLE_AGENT=1 and the VMID in PROXIMO_AGENT_ALLOWLIST. No confirm needed — read-only.
command: one of 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, exec-status. pid: required when command='exec-status' (the pid returned by pve_agent_exec).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pid | No | ||
| node | No | ||
| vmid | Yes | ||
| command | No | 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 |