pve_sdn_fabric_update
Update an existing SDN fabric. Dry-run returns a plan; confirm execution to stage changes for later application.
Instructions
MUTATION: update an SDN fabric (PENDING). To create a new fabric use pve_sdn_fabric_create; to remove one use pve_sdn_fabric_delete. Dry-run by default (returns a PLAN); confirm=True stages the edit and returns {status, result}. RISK_LOW (staging; inert until pve_sdn_apply).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| delete | No | Field name(s) to unset — the valid enum is protocol-conditional (e.g. ip_prefix/ip6_prefix/hello_interval/csnp_interval/route_filter for openfabric; area/redistribute/route_filter for ospf; ip_prefix/ip6_prefix/redistribute/route_filter/route_map_in/route_map_out for bgp; persistent_keepalive for wireguard). | |
| digest | No | Expected config digest for optimistic-concurrency checking. | |
| fabric | Yes | Existing SDN fabric id to update. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the staged mutation. | |
| options | No | Protocol-conditional fields to set (area, csnp_interval, hello_interval, ip_prefix, ip6_prefix, persistent_keepalive, redistribute, route_filter). | |
| protocol | Yes | Fabric routing protocol — REQUIRED on update too (the schema requires restating it; unlike controller/dns/ipam, where type is immutable and absent from PUT). Whether passing a DIFFERENT protocol than the fabric's current one re-types it or is rejected is undocumented — forwarded verbatim. | |
| 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 |