pve_sdn_prefix_list_create
Create a new SDN prefix list in Proxmox VE, optionally seeding it with entries in bulk. Uses a dry-run plan by default; confirm to execute the staged mutation.
Instructions
MUTATION: create an SDN prefix list (PENDING — inert until pve_sdn_apply).
The more granular path is create empty, then add entries one at a time via
pve_sdn_prefix_list_entry_create; entries here seeds them in bulk instead. To update an
existing list use pve_sdn_prefix_list_update; to remove one use
pve_sdn_prefix_list_delete. Dry-run by default (returns a PLAN); confirm=True creates the
pending list, returning {status, result}. RISK_LOW (staging, no live network effect).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| digest | No | Expected config digest for optimistic-concurrency checking — accepted on CREATE for this endpoint (a real exception to the plane-wide 'digest never on create' convention). | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the staged mutation. | |
| entries | No | Optional bulk seed: a list of {action, prefix, ge?, le?, seq?} entry objects, created in the SAME call. PVE validates each item server-side. | |
| lock_token | No | SDN cluster lock token to use for this write, if one is held. | |
| prefix_list | Yes | New SDN prefix list id to 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 |