pve_sdn_prefix_list_entry_create
Create a pending SDN prefix-list entry with permit/deny action and CIDR prefix. Returns a dry-run plan by default; use confirm=True to stage the entry until applied.
Instructions
MUTATION: create a prefix-list entry (PENDING — inert until pve_sdn_apply).
NO digest on this endpoint (schema-verified) — unlike this same entry's own UPDATE,
which does accept one. To update an existing entry use
pve_sdn_prefix_list_entry_update; to remove one use pve_sdn_prefix_list_entry_delete.
Dry-run by default (returns a PLAN); confirm=True creates the pending entry, returning
{status, result}. RISK_LOW (staging, no live network effect).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ge | No | Lower bound on matched prefix length (0-128). | |
| le | No | Upper bound on matched prefix length (0-128). | |
| seq | No | Explicit sequence number (1-4294967295) — omit to let PVE assign one. | |
| action | Yes | Matching policy: 'permit' or 'deny'. | |
| prefix | Yes | CIDR network to match (e.g. 10.0.0.0/8, ::/0). | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the staged mutation. | |
| lock_token | No | SDN cluster lock token to use for this write, if one is held. | |
| prefix_list | Yes | Existing SDN prefix list id to add an entry to. | |
| 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 |