pbs_node_network_iface_create
Create a network interface configuration on a Proxmox PBS node. Dry-run checks for name collisions; set confirm=True to execute the plan.
Instructions
MUTATION (MEDIUM): create a network interface configuration on a PBS node (staged, written to interfaces.new — NOT live until pbs_node_network_reload). Dry-run by default (checks for a name collision). confirm=True executes (POST /nodes/{node}/network) and returns {"status": "submitted", "result": None}. Apply with pbs_node_network_reload (RISK_HIGH) or discard with pbs_node_network_revert. Needs PROXIMO_PBS_* config.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | No | PBS node name (or 'localhost'). | localhost |
| iface | Yes | New network interface name. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the creation. | |
| options | No | Additional interface fields (cidr, gateway, bridge_ports, bond_mode, mtu, autostart, comments, ...) forwarded verbatim. | |
| iface_type | No | Interface type: one of loopback, eth, bridge, bond, vlan, alias, unknown. PBS marks this OPTIONAL even on create. | |
| 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 |