Skip to content

MAC Address Table

MAC address table configuration controls how NX-OS devices learn and age out MAC addresses. It covers the aging time, system and user-defined MAC address limits, MAC move and threshold notifications, and static MAC address entries that forward to an interface or drop traffic for a given VLAN.

Diagram
NameTypeConstraintMandatoryDefault Value
devicesListdevicesNo
device_groupsListdevice_groupsNo
globalClassglobalNo
templatesListtemplatesNo

NameTypeConstraintMandatoryDefault Value
configurationClassconfigurationNo

NameTypeConstraintMandatoryDefault Value
configurationClassconfigurationNo

NameTypeConstraintMandatoryDefault Value
configurationClassconfigurationNo

NameTypeConstraintMandatoryDefault Value
configurationClassconfigurationNo

NameTypeConstraintMandatoryDefault Value
systemClasssystemNo

NameTypeConstraintMandatoryDefault Value
mac_address_tableClassmac_address_tableNo

mac_address_table (nxos.devices.configuration.system)

Section titled “mac_address_table (nxos.devices.configuration.system)”
NameTypeConstraintMandatoryDefault Value
aging_timeIntegermin: 0, max: 4294967295No
limit_systemIntegermin: 100, max: 384000No
limit_user_definedIntegermin: 16, max: 1256No
notification_mac_moveBooleantrue, falseNo
notification_threshold_limitIntegermin: 1, max: 100No
notification_threshold_intervalIntegermin: 10, max: 10000No
static_clearBooleantrue, falseNo
staticsListstaticsNo

statics (nxos.devices.configuration.system.mac_address_table)

Section titled “statics (nxos.devices.configuration.system.mac_address_table)”
NameTypeConstraintMandatoryDefault Value
macMACYes
vlanIntegermin: 1, max: 4094Yes
interface_typeChoiceethernet, loopback, mgmt, port-channel, vlan, vniNo
interface_idAnyString or Integer[min: 0]No
dropBooleantrue, falseNo

Example 1: MAC address table aging, limits and static entries (mac address-table aging-time <seconds>, mac address-table limit <value> user-defined, mac address-table notification mac-move, mac address-table static <mac> vlan <id> {interface <intf> | drop})

nxos:
devices:
- name: LEAF1
configuration:
vlan:
vlans:
- id: 100
system:
mac_address_table:
aging_time: 600
limit_user_defined: 32
notification_mac_move: true
statics:
- mac: "00:00:11:11:22:22"
vlan: 100
interface_type: ethernet
interface_id: "1/9"
- mac: "00:00:11:11:33:33"
vlan: 100
drop: true