pve_sdn_fabric_create
Create a new SDN fabric as a staged mutation, pending until applied. Dry-run returns a plan; confirm executes the creation.
Instructions
MUTATION: create an SDN fabric (PENDING — inert until pve_sdn_apply).
To update an existing fabric use pve_sdn_fabric_update; to remove one use pve_sdn_fabric_delete. Dry-run by default (returns a PLAN); confirm=True creates the pending fabric, 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 (one of three exceptions on this SDN plane to the 'digest never on create' convention). | |
| fabric | Yes | New SDN fabric id to create (2-8 chars, alnum + hyphen). | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the staged mutation. | |
| options | No | Protocol-conditional fields (area, csnp_interval, hello_interval, ip_prefix, ip6_prefix, persistent_keepalive, redistribute, route_filter); PVE validates per protocol server-side. redistribute is schema-required for every protocol but only meaningful for ospf/bgp — omitting it for openfabric/wireguard is UNTESTED, Smoke-confirm. | |
| protocol | Yes | Fabric routing protocol: openfabric, ospf, wireguard, or bgp. | |
| lock_token | No | SDN cluster lock token to use for this write, if one is held. | |
| 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 |