< Home

Data Model

The configuration model file matching MAC address table query is huawei-mac.yang.

Table 1 Querying the MAC address table

Object

Description

Value Range

Remarks

/huawei-mac: mac-address-table-get/get-num

Indicates the maximum number of MAC address entries queried at one time.

The value is an integer. A maximum of 1024 MAC address entries can be queried at a time. Even when the value is larger than 1024, a maximum of 1024 entries can be queried.

N/A

/huawei-mac: mac-address-table-get / destination-address/mac-address

Indicates the MAC address.

The value is in HH:HH:HH:HH:HH:HH format. An H is a hexadecimal number of 1 digit. The MAC address cannot be FF:FF:FF:FF:FF:FF, 00:00:00:00:00:00, or a multicast MAC address.

N/A

/huawei-mac: mac-address-table-get / destination-address/id-type

Indicates the MAC address type.

The value is of the enumerated type:
  • vlan
  • vsi
  • bd

N/A

/huawei-mac: mac-address-table-get / destination-address/id

Indicates the VLAN ID, BD ID, or VSI name of the MAC address.

  • When the value of id-type is VLAN, id is a VLAN ID. The value is an integer that ranges from 1 to 4096.
  • When the value of id-type is VSI, id is a VSI name. The value is a string of 1 to 31 case-sensitive characters without spaces. If the string is enclosed in double quotation marks (" "), the string can contain spaces.
  • When the value of id-type is BD, id is a BD ID. The value is an integer that ranges from 1 to 16777215.

N/A

/huawei-mac: mac-address-table-get / destination-address/interface

Indicates the interface name.

The value is a string of 1 to 64 characters. It consists of the interface type and interface number.

N/A

/huawei-mac: mac-address-table-get / destination-address/search-type

Indicates the MAC address search criteria.

The value is of the enumerated type:
  • interface: MAC address entries are queried based on the interface.
  • vlan: MAC address entries are queried based on the VLAN ID.
  • mac: MAC address entries are queried based on the specified MAC address.
  • all: All MAC address entries are queried.

N/A

/huawei-mac: mac-address-table-get / last-mac-address-details/last-mac-address

Indicates that MAC addresses with a specified range are queried.

The value is in HH:HH:HH:HH:HH:HH format. An H is a hexadecimal number of 1 digit. The MAC address cannot be FF:FF:FF:FF:FF:FF, 00:00:00:00:00:00, or a multicast MAC address.

N/A

/huawei-mac: mac-address-table-get / last-mac-address-details/last-id-type

Indicates the type of MAC addresses with a specified range to be queried.

The value is of the enumerated type:
  • vlan
  • vsi
  • bd

N/A

/huawei-mac: mac-address-table-get / last-mac-address-details/last-id

Indicates the VLAN ID, BD ID, or VSI name of MAC addresses with a specified range to be queried.

  • When the value of last-id-type is VLAN, last-id is a VLAN ID. The value is an integer that ranges from 1 to 4096.
  • When the value of last-id-type is VSI, last-id is a VSI name. The value is a string of 1 to 31 case-sensitive characters without spaces. If the string is enclosed in double quotation marks (" "), the string can contain spaces.
  • When the value of last-id-type is BD, last-id is a BD ID. The value is an integer that ranges from 1 to 16777215.

N/A

/huawei-mac: mac-address-table-get / last-mac-address-details/interface

Indicates the name of an interface where detailed MAC address entry information is queried.

The value is a string of 1 to 64 characters. It consists of the interface type and interface number.

N/A

/huawei-mac: mac-address-table-get / last-mac-address-details/search-type

Indicates the search criteria for querying MAC address entry information.

The value is of the enumerated type:
  • interface: MAC address entries are queried based on the interface.
  • vlan: MAC address entries are queried based on the VLAN ID.
  • mac: MAC address entries are queried based on the specified MAC address.
  • all: All MAC address entries are queried.

N/A

/huawei-mac: mac-address-table-get/ mac-address-details/mac-address

Indicates the MAC address of which MAC address entry information is queried.

The value is in HH:HH:HH:HH:HH:HH format. An H is a hexadecimal number of 1 digit. The MAC address cannot be FF:FF:FF:FF:FF:FF, 00:00:00:00:00:00, or a multicast MAC address.

N/A

/huawei-mac: mac-address-table-get/ mac-address-details/id-type

Indicates the type of the MAC address of which MAC address entry information is queried.

The value is of the enumerated type:
  • vlan
  • vsi
  • bd

N/A

/huawei-mac: mac-address-table-get/ mac-address-details/id

Indicates the VLAN ID, BD ID, or VSI name of the MAC address of which MAC address entry information is queried.

  • When the value of id-type is VLAN, id is a VLAN ID. The value is an integer that ranges from 1 to 4096.
  • When the value of id-type is VSI, id is a VSI name. The value is a string of 1 to 31 case-sensitive characters without spaces. If the string is enclosed in double quotation marks (" "), the string can contain spaces.
  • When the value of id-type is BD, id is a BD ID. The value is an integer that ranges from 1 to 16777215.

N/A

/huawei-mac: mac-address-table-get/ mac-address-details/mac-type

Indicates the type of MAC address entries.

The value is of the enumerated type:
  • static: indicates a static MAC address entry, which is manually configured and will not be aged out.
  • blackhole: indicates a blackhole MAC address entry, which is manually configured and will not be aged out.
  • dynamic: indicates a MAC address entry learned by the device. Dynamic MAC address entries can be aged.
  • security: indicates a MAC address entry that an interface learns after port security is enabled.
  • sec-config: indicates a static secure MAC address entry configured by using the port-security mac-address command.
  • sticky: indicates a MAC address entry that an interface learns after the sticky MAC function is enabled.
  • mux: indicates a MAC address entry learned by an interface enabled with MUX VLAN.
  • snooping: indicates a static MAC address entry that is generated based on the DHCP snooping binding table.
  • authen: indicates a MAC address entry corresponding to the NAC authentication user that obtains an IP address (excluding the Layer 3 authentication user of which the MAC address cannot be generated and wireless user in direct forwarding mode).
  • pre-authen: indicates a MAC address entry corresponding to a user that is in pre-connection state and does not obtain an IP address after NAC authentication is enabled.

N/A

/huawei-mac: mac-address-table-get/ mac-address-details/forwarding-interface

Indicates the queried interface information.

The value is a string of 1 to 64 characters. It consists of the interface type and interface number.

N/A

/huawei-mac: mac-address-table-get/has-more

Query status.

The value is of the Boolean type:
  • true: MAC address information can still be queried.
  • false: Query ends.

N/A

/huawei-mac:mac-address-table-get/total-num

Displays the number of MAC address entries of a specified type.

The value is an integer.

N/A

/huawei-mac:mac-address-table/static-mac/mac-address

Indicates the MAC address in a static MAC address entry.

The value is in HH:HH:HH:HH:HH:HH format. An H is a hexadecimal number of 1 digit. The MAC address cannot be FF:FF:FF:FF:FF:FF, 00:00:00:00:00:00, or a multicast MAC address.

N/A

/huawei-mac:mac-address-table/static-mac/id-type

Indicates the type of a static MAC address.

The value is of the enumerated type:
  • vlan: The static MAC address is of the VLAN type.
  • vsi: The static MAC address is of the VSI type.

Currently, only static MAC addresses of the VLAN type are supported.

/huawei-mac:mac-address-table/static-mac/id

Indicates the ID of the VLAN that the outbound interface belongs to.

The value is an integer in the range from 1 to 4096.

N/A

/huawei-mac:mac-address-table/static-mac/interface

Indicates that the outbound interface in the static MAC address entry is a specified interface.

The value is a string of 1 to 64 characters. It consists of the interface type and interface number.

N/A

/ietf-interfaces:interfaces/interface/huawei-mac:mac-security/mac-limit/maxinum

Indicates the maximum number of MAC addresses that can be learned.

The value is an integer in the range from 0 to 4096. The value 0 indicates that the maximum number of MAC addresses that can be learned is not limited.

This object is mandatory.

/ietf-interfaces:interfaces/interface/huawei-mac:mac-security/mac-limit/action

Indicates the action performed when the number of learned MAC address entries reaches the limit.

The value is of the Boolean type:
  • discard: Discard packets with new source MAC addresses.
  • forward: Forward packets with new source MAC addresses but do not add the new MAC addresses to the MAC address table.

The default action is discard.

Before configuring this object, you must configure maxinum.

/ietf-interfaces:interfaces/interface/huawei-mac:mac-security/mac-limit/alarm-enable

Indicates whether the system generates an alarm when the number of learned MAC address entries reaches the limit.

The value is of the Boolean type:
  • disable: Do not generate an alarm.
  • enable: Generate an alarm.

By default, an alarm is generated when the number of MAC address entries reaches the maximum.

Before configuring this object, you must configure maxinum.

Copyright © Huawei Technologies Co., Ltd.
Copyright © Huawei Technologies Co., Ltd.
Next topic >