OpenStack is a cloud operating system that controls large pools of compute, storage, and networking resources throughout a data center. This command is used to display information about an interface in an OpenStack instance.

Syntax   openstack-interface-show openstack-name name-string nic nic-string ip ip-address netmask netmask [assignment none|dhcp|dhcpv6] mac mac-address vlan vlan-id vlan-type public|private [if mgmtdhcp|dhcpv6] alias-on alias-on-string vm-nic-type e1000|virtio exclusive|no-exclusive nic-enable|nic-disable nic-state down|up vrrp-id id vrrp-primary vrrp-primary-string vrrp-priority vrrp-priority-number vrrp-adv-int mseconds secondary-macs secondary-macs-string

openstack-name name-string

Specifies the name of the OpenStack instance to add the interface.

Specify the following interface arguments:

nic nic-string

Specifies the interface NIC to modify/

ip ip-address

Specifies the IP address for the interface.

netmask netmask

Specifies the netmask.

assignment none|dhcp|dhcpv6

Specifies the method of IP address assignment.

mac mac-address 

Specifies the MAC address of the interface.

vlan vlan-id

Specifies the VLAN assigned to the interface.

vlan-type public|private

Specify the type of VLAN for the interface.

public-vlan vlan-id

Specifies the public VLAN ID.

if mgmt|data|span

Specifies the type of interface.

vm-nic-type e1000|virtio

Specifies the type of virtual NIC assigned to the interface.

alias-on alias-on-string

Specifies an alias if configured.


Specifies if the interface is exclusive or not.



Specifies if the NIC is enabled or disabled.

nic-state down|up

Specifies the of the NIC as up or down.

vrrp-id id

Specifies the VRRP ID.

vrrp-primary vrrp-primary-string

Specifies the primary VRRP.

vrrp-priority vrrp-priority-number

Specifies the VRRP priority number

vrrp-adv-int msecond

Specifies the VRRP advertisement interval in milliseconds. The default value is 1000 with a range of 10 to 40950 milliseconds

secondary-macs secondary-macs-string

Specifies the secondary MAC address for the interface.

if-nat-realm internal|external

Specify the NAT interface realm.


Specify the VLAN 0 priority tag on forwarded traffic.

Formatting Options

format fields-to-display

Display output using a specific parameter. Use all to display all possible output.

parsable-delim character

Display output formatted for machine parsing using a specified delimiter.


Display output in ascending order.


Display output in descending order.

show dups

Display duplicate entries in the output.

layout vertical|horizontal

Format the output in a vertical or horizontal layout.

show-interval seconds-interval

Repeat the show command at a specified interval.


Display column headers or not.

limit-output number

Limit the display output to a specific number of entries.


Display the number of entries in the output. This is useful with vRouter show commands.


Display full values in the output instead of scaled approximate values.


Display integer values instead of mapped values


Aggregate output by specific parameters. If sum-by fields are specified, records that have the same value in sum-by fields are combined and displayed as one aggregate record. NOTE: This option is only available for show commands that collect statistics such as connection-stats-show.

Defaults   None

Access   CLI


Version 2.0

Command introduced.

Version 2.1

The parameters, exclusive, nic, and nic-state added.

Version 2.2.4

The parameter, secondary-macs, added.

Version 2.4.1

The parameter, vxlan, deprecated. The parameter, vlan-type, added.

Version 2.6.2

The parameter, if-nat-realm, added.

Version 3.1.0

The parameter, priority-tag|no-priority-tag, added.

Usage   Use this command to display an interface to an OpenStack instance.

Examples  To display an interface in the OpenStack instance, use the following command:

CLI (network-admin@pleiades25) > openstack-interface-show format all layout vertical

openstack-name: ops202

nic:            eth0.202


assignment:     static

mac:            66:0e:94:23:ac:b9

vlan:           202

vxlan:          0

if:             data


exclusive:      no

nic-config:     disable

nic-state:      up

openstack-name: ops202

nic:            eth0


assignment:     static

mac:            66:0e:94:23:d3:79

vlan:           0

vxlan:          0

if:             mgmt


exclusive:      no

nic-config:     enable

nic-state:      up

openstack-name: ops198

nic:            eth0.198


assignment:     static

mac:            66:0e:94:23:59:5f

vlan:           198

vxlan:          0

if:             data


exclusive:      no

nic-config:     disable

nic-state:      up


See Also