terraform-provider-proxmox/docs/resources/virtual_environment_sdn_zone.md

layout	title	parent	subcategory	description
page	proxmox_virtual_environment_sdn_zone	Resources	Virtual Environment	Manages SDN Zones in Proxmox VE.

Resource: proxmox_virtual_environment_sdn_zone

Manages SDN Zones in Proxmox VE. Some attributes in the proxmox_virtual_environment_sdn_zone resource or data source are only applicable to certain zone types. For example:

bridge is relevant only for vlan zones.

peers, controller, vrf_vxlan, and related attributes are specific to vxlan and evpn zone types.

service_vlan and vlan_protocol apply to qinq zones.

While the Proxmox API does not explicitly document these constraints, they are enforced by the Proxmox backend and have been validated manually through API experimentation.

The Terraform provider implements field-level validation to ensure that only compatible attributes are used with each zone type. If incompatible attributes are set, Terraform will raise a configuration error during plan or apply to prevent invalid requests to the Proxmox API.

This design helps ensure correctness and avoids unexpected API failures when managing SDN zones across different zone types.

Schema

Required

• name (String) The unique ID of the SDN zone.
• type (String) Zone type (e.g. simple, vlan, qinq, vxlan, evpn).

Optional

• advertise_subnets (Boolean) Enable subnet advertisement for EVPN.
• bridge (String) Bridge interface for VLAN/QinQ.
• controller (String) EVPN controller address.
• disable_arp_nd_suppression (Boolean) Disable ARP/ND suppression for EVPN.
• dns (String) DNS server address.
• dns_zone (String) DNS zone name.
• exit_nodes (String) Comma-separated list of exit nodes for EVPN.
• exit_nodes_local_routing (Boolean) Enable local routing for EVPN exit nodes.
• ipam (String) IP Address Management system.
• mtu (Number) MTU value for the zone.
• nodes (String) Comma-separated list of Proxmox node names.
• peers (String) Peers list for VXLAN.
• primary_exit_node (String) Primary exit node for EVPN.
• reversedns (String) Reverse DNS settings.
• rt_import (String) Route target import for EVPN.
• tag (Number) Service VLAN tag for QinQ.
• vlan_protocol (String) Service VLAN protocol for QinQ.
• vrf_vxlan (Number) EVPN VRF VXLAN ID.

Read-Only

• id (String) The unique identifier of this resource.