Skip to content

proxmox_node

!proxmox_node

Category: proxmox

Passive/read-only query of Proxmox node status (uptime, load, memory, CPU), optionally with cluster quorum and VM/LXC lists. Saves a JSON blob into a host variable.

Parameters

NameTypeRequiredDescription
api_hoststringyesProxmox API host.
api_token_idstringyesProxmox API token ID.
api_token_secretstringyesProxmox API token secret.
nodestringyesNode name to query.
save_tostringnoVariable name to store the resulting JSON info string into.
include_clusterboolnoAlso fetch /cluster/status (adds cluster list + quorate bool).
include_vmsboolnoAlso list QEMU VMs on the node (adds vms + vm_count).
include_lxcboolnoAlso list LXCs on the node (adds lxc + lxc_count).

Examples

- !proxmox_node
  api_host: '{{ proxmox_host }}'
  api_token_id: '{{ proxmox_token_id }}'
  api_token_secret: '{{ proxmox_token_secret }}'
  node: bee
  save_to: node_info
  include_cluster: true
  include_vms: true