pve_network_iface_update
Modify an existing network interface's configuration (e.g., address, netmask) on a Proxmox node. Review the plan with dry-run, then confirm to stage the update.
Instructions
MUTATION: update an existing network interface config (staged — not live until pve_network_apply).
options carries fields to update (address, netmask, bridge_ports, …); the interface's type
is preserved automatically and cannot be changed here — recreate via pve_network_iface_create
for a type change. Dry-run by default (returns a PLAN); confirm=True stages the update and
returns {status, result} — result is often None. RISK_MEDIUM (staged change, reversible before apply).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | No | Node the interface lives on; defaults to the configured node. | |
| iface | Yes | Existing interface name to update, e.g. vmbr1 or eth0.100. | |
| confirm | No | False (default) returns a dry-run PLAN only; True stages the update (still not live until pve_network_apply). | |
| options | No | Fields to update: address, netmask, bridge_ports, etc. | |
| 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 |