netbox/docs/models/ipam/vlan.md
Jeremy Stretch 8767fd8186
Closes #13428: Q-in-Q VLANs (#17822)
* Initial work on #13428 (QinQ)

* Misc cleanup; add tests for Q-in-Q fields

* Address PR feedback
2024-10-31 14:17:06 -04:00

1.1 KiB

VLANs

A Virtual LAN (VLAN) represents an isolated layer two domain, identified by a name and a numeric ID (1-4094) as defined in IEEE 802.1Q. VLANs are arranged into VLAN groups to define scope and to enforce uniqueness.

Fields

ID

A 12-bit numeric ID for the VLAN, 1-4094 (inclusive).

Name

The configured VLAN name.

Status

The VLAN's operational status.

!!! tip Additional statuses may be defined by setting VLAN.status under the FIELD_CHOICES configuration parameter.

Role

The user-defined functional role assigned to the VLAN.

VLAN Group or Site

The VLAN group or site to which the VLAN is assigned.

Q-in-Q Role

For VLANs which comprise a Q-in-Q/IEEE 802.1ad topology, this field indicates whether the VLAN is treated as a service or customer VLAN.

Q-in-Q Service VLAN

The designated parent service VLAN for a Q-in-Q customer VLAN. This may be set only for Q-in-Q custom VLANs.