mirror of https://github.com/bpg/terraform-provider-proxmox.git synced 2025-08-22 19:38:35 +00:00

feat(sdn): add support for zone resources and datasources (#2046 )

Signed-off-by: Pavel Boldyrev <627562+bpg@users.noreply.github.com>

2025-07-31 20:30:18 -04:00

2.7 KiB

Raw Blame History

layout	title	parent	subcategory	description
page	proxmox_virtual_environment_sdn_zone_vxlan	Data Sources	Virtual Environment	Retrieves information about a VXLAN Zone in Proxmox SDN. It establishes a tunnel (overlay) on top of an existing network (underlay). This encapsulates layer 2 Ethernet frames within layer 4 UDP datagrams using the default destination port 4789. You have to configure the underlay network yourself to enable UDP connectivity between all peers. Because VXLAN encapsulation uses 50 bytes, the MTU needs to be 50 bytes lower than the outgoing physical interface.

Data Source: proxmox_virtual_environment_sdn_zone_vxlan

Retrieves information about a VXLAN Zone in Proxmox SDN. It establishes a tunnel (overlay) on top of an existing network (underlay). This encapsulates layer 2 Ethernet frames within layer 4 UDP datagrams using the default destination port 4789. You have to configure the underlay network yourself to enable UDP connectivity between all peers. Because VXLAN encapsulation uses 50 bytes, the MTU needs to be 50 bytes lower than the outgoing physical interface.

Example Usage

data "proxmox_virtual_environment_sdn_zone_vxlan" "example" {
  id = "vxlan1"
}

output "data_proxmox_virtual_environment_sdn_zone_vxlan" {
  value = {
    id          = data.proxmox_virtual_environment_sdn_zone_vxlan.example.id
    nodes       = data.proxmox_virtual_environment_sdn_zone_vxlan.example.nodes
    peers       = data.proxmox_virtual_environment_sdn_zone_vxlan.example.peers
    mtu         = data.proxmox_virtual_environment_sdn_zone_vxlan.example.mtu
    dns         = data.proxmox_virtual_environment_sdn_zone_vxlan.example.dns
    dns_zone    = data.proxmox_virtual_environment_sdn_zone_vxlan.example.dns_zone
    ipam        = data.proxmox_virtual_environment_sdn_zone_vxlan.example.ipam
    reverse_dns = data.proxmox_virtual_environment_sdn_zone_vxlan.example.reverse_dns
  }
}

Schema

Required

id (String) The unique identifier of the SDN zone.

Read-Only

dns (String) DNS API server address.
dns_zone (String) DNS domain name. Used to register hostnames, such as <hostname>.<domain>. The DNS zone must already exist on the DNS server.
ipam (String) IP Address Management system.
mtu (Number) MTU value for the zone.
nodes (Set of String) The Proxmox nodes which the zone and associated VNets are deployed on
peers (Set of String) A list of IP addresses of each node in the VXLAN zone. This can be external nodes reachable at this IP address. All nodes in the cluster need to be mentioned here
reverse_dns (String) Reverse DNS API server address.

2.7 KiB Raw Blame History