pve_sdn_vnet_ip_update
Update an IP-to-MAC mapping in a Proxmox SDN vnet. Optionally associate a VMID. Use confirm=true to apply; dry-run by default.
Instructions
MUTATION: update an IP-to-MAC mapping in a vnet. Dry-run by default — no 'current' preview possible (no GET on this endpoint at all). RISK_LOW. Synchronous — confirm=True returns {"status": "ok", "result": None}; no task UPID to poll.
vmid is accepted on THIS verb only (not create/delete — schema-verified). NO digest
support on this endpoint at all. No UNDO — revert by updating it back to its prior
mac/vmid.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ip | Yes | IP address of the mapping to update. | |
| mac | No | New unicast MAC address, XX:XX:XX:XX:XX:XX. | |
| vmid | No | Guest VMID/CTID to associate with the mapping for tracking/audit purposes (PUT-only — not accepted on create/delete). | |
| vnet | Yes | SDN vnet name. | |
| zone | Yes | SDN zone the vnet belongs to. | |
| confirm | No | Set True to execute the mutation; False (default) only returns a dry-run PLAN. | |
| 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
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |