pve_sdn_vnet_ip_create
Creates an IP-to-MAC mapping in a Proxmox SDN vnet. Use to reserve an IP address for a MAC address in IPAM. Dry-run by default; set confirm=true to execute.
Instructions
MUTATION: create an IP-to-MAC mapping in a vnet (IPAM record). Dry-run by default — the PLAN cannot show a 'current' preview (this endpoint has NO GET at all — declared honestly, not fabricated). RISK_LOW: reserves a mapping; no live traffic effect until a guest's NIC resolves through it. Synchronous — confirm=True returns {"status": "ok", "result": None}; no task UPID to poll.
NO digest support on this endpoint at all (schema-verified) — no optimistic lock possible for this family. No UNDO — revert by deleting the mapping with pve_sdn_vnet_ip_delete.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ip | Yes | IP address to associate with the given MAC address. | |
| mac | No | Unicast MAC address, XX:XX:XX:XX:XX:XX. | |
| 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
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |