Skip to content

vNIC Template

A vNIC Template encapsulates a reusable set of Ethernet adapter, QoS, network, and pool references for vNIC creation. Templates standardize vNIC configuration across multiple LAN Connectivity Policies and enable centralized updates that automatically propagate to all derived vNICs when override is disabled.

FI-Attached only: Intersight requires at least one ethernet_network_group_policy on every vNIC template, making vNIC templates a FI-attached construct. For standalone servers, configure vNICs inline within a LAN Connectivity Policy using ethernet_network_policy instead.

Location in Intersight GUI: Templates » vNIC

Diagram
NameTypeConstraintMandatoryDefault Value
intersightClassintersightNo

NameTypeConstraintMandatoryDefault Value
organizationsListorganizationsNo

NameTypeConstraintMandatoryDefault Value
templatesClasstemplatesNo

templates (compute.intersight.organizations)

Section titled “templates (compute.intersight.organizations)”
NameTypeConstraintMandatoryDefault Value
vnicListvnicNo

vnic (compute.intersight.organizations.templates)

Section titled “vnic (compute.intersight.organizations.templates)”
NameTypeConstraintMandatoryDefault Value
nameStringRegex: ^[a-zA-Z0-9_.:-]{1,64}$Yes
descriptionStringNo
managedBooleantrue, falseNotrue
tagsListtagsNo
switch_idChoiceA, B, NoneNo
failoverBooleantrue, falseNofalse
allow_overrideBooleantrue, falseNofalse
pin_group_nameStringNo
peer_vnic_nameStringNo
mac_poolStringNo
ethernet_adapter_policyStringNo
ethernet_network_control_policyStringNo
ethernet_network_group_policyStringNo
ethernet_network_policyStringNo
ethernet_qos_policyStringNo
iscsi_boot_policyStringNo
cdn_sourceChoicevnic, userNovnic
cdn_valueStringNo
sriovClasssriovNo
usnicClassusnicNo
vmqClassvmqNo

tags (compute.intersight.organizations.templates.vnic)

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

sriov (compute.intersight.organizations.templates.vnic)

Section titled “sriov (compute.intersight.organizations.templates.vnic)”
NameTypeConstraintMandatoryDefault Value
enabledBooleantrue, falseNo
number_of_vfsIntegermin: 1, max: 64No
receive_queue_count_per_vfIntegermin: 1, max: 64No
transmit_queue_count_per_vfIntegermin: 1, max: 64No
completion_queue_count_per_vfIntegermin: 1, max: 64No
interrupt_count_per_vfIntegermin: 1, max: 64No

usnic (compute.intersight.organizations.templates.vnic)

Section titled “usnic (compute.intersight.organizations.templates.vnic)”
NameTypeConstraintMandatoryDefault Value
number_of_usnicsIntegermin: 0No
usnic_adapter_policyStringNo

vmq (compute.intersight.organizations.templates.vnic)

Section titled “vmq (compute.intersight.organizations.templates.vnic)”
NameTypeConstraintMandatoryDefault Value
enabledBooleantrue, falseNo
virtual_machine_multi_queueBooleantrue, falseNo
number_of_interruptsIntegermin: 1, max: 514No
number_of_virtual_machine_queuesIntegermin: 1, max: 128No
number_of_sub_vnicsIntegermin: 0, max: 64No
vmmq_adapter_policyStringNo

Example-1: FI-Attached vNIC template with all common policy and pool references, including tags.

compute:
intersight:
organizations:
- name: MyOrganization
templates:
vnic:
- name: vnic-a-template
description: Standard FI-A vNIC template for production servers
switch_id: A
failover: false
allow_override: false
mac_pool: mac-pool-a
ethernet_adapter_policy: vmware-high-trf
ethernet_qos_policy: best-effort-qos
ethernet_network_control_policy: cdp-lldp-ctrl
ethernet_network_group_policy: vlan-100-200-trunk
tags:
- key: env
value: prod

Example-2: FI-Attached vNIC template with custom CDN naming and SR-IOV enabled.

compute:
intersight:
organizations:
- name: MyOrganization
templates:
vnic:
- name: sriov-vnic-template
switch_id: A
mac_pool: mac-pool-a
ethernet_adapter_policy: sriov-adapter
ethernet_qos_policy: best-effort-qos
ethernet_network_group_policy: vlan-trunk
cdn_source: user
cdn_value: eth0
sriov:
enabled: true
number_of_vfs: 16
receive_queue_count_per_vf: 1
transmit_queue_count_per_vf: 1
interrupt_count_per_vf: 1
completion_queue_count_per_vf: 1