Skip to content

VLAN Policy

A VLAN Policy defines the set of Virtual LANs available on a Cisco UCS Fabric Interconnect, including native VLAN designation, private VLAN sharing, and auto-allow behavior on uplinks. It is assigned to domain profiles or domain templates.

Each entry in vlans can represent a single VLAN or a comma-separated list/range of VLAN IDs via vlan_list (e.g. '1-5', '1,3,5', '1-5,10-16', or '1').

Location in Intersight GUI: Policies » VLAN

Diagram
NameTypeConstraintMandatoryDefault Value
intersightClassintersightNo

NameTypeConstraintMandatoryDefault Value
organizationsListorganizationsNo

NameTypeConstraintMandatoryDefault Value
policiesClasspoliciesNo

policies (compute.intersight.organizations)

Section titled “policies (compute.intersight.organizations)”
NameTypeConstraintMandatoryDefault Value
vlanListvlanNo

vlan (compute.intersight.organizations.policies)

Section titled “vlan (compute.intersight.organizations.policies)”
NameTypeConstraintMandatoryDefault Value
nameStringRegex: ^[a-zA-Z0-9_.:-]{1,64}$Yes
descriptionStringNo
managedBooleantrue, falseNotrue
tagsListtagsNo
vlansListvlansYes

tags (compute.intersight.organizations.policies.vlan)

Section titled “tags (compute.intersight.organizations.policies.vlan)”
NameTypeConstraintMandatoryDefault Value
keyStringYes
valueStringNo
typeChoiceKeyValue, PathTagNo

vlans (compute.intersight.organizations.policies.vlan)

Section titled “vlans (compute.intersight.organizations.policies.vlan)”
NameTypeConstraintMandatoryDefault Value
nameStringRegex: ^[a-zA-Z0-9_.:-]{1,64}$Yes
vlan_listStringYes
native_vlanBooleantrue, falseNofalse
auto_allow_on_uplinksBooleantrue, falseNotrue
sharing_typeChoiceNone, Primary, Isolated, CommunityNoNone
primary_vlan_idIntegermin: 0, max: 4093No0
multicast_policyStringNo

Example-1: Configure a VLAN policy with a native VLAN and a range of allowed VLANs, with environment tags.

compute:
intersight:
organizations:
- name: MyOrg
policies:
vlan:
- name: MyVlanPolicy
tags:
- key: env
value: prod
vlans:
- name: Native
vlan_list: '1'
native_vlan: true
- name: Data
vlan_list: '100-110'

Example-2: Configure a VLAN policy with a private VLAN pair — a primary VLAN and an isolated secondary VLAN.

compute:
intersight:
organizations:
- name: MyOrg
policies:
vlan:
- name: MyPrivateVlanPolicy
vlans:
- name: Primary
vlan_list: '200'
sharing_type: Primary
- name: Isolated
vlan_list: '201'
sharing_type: Isolated
primary_vlan_id: 200