display ip vpn-instance

Function

The display ip vpn-instance command displays VPN instance information.

Format

display ip vpn-instance [ vpn-instance-name ]

display ip vpn-instance verbose

display ip vpn-instance interface

display ip vpn-instance verbose vpn-instance-name

display ip vpn-instance vpn-instance-name interface

display ip vpn-instance [ vpn-instance-name ] tunnel-info

display ip vpn-instance vpn-instance-name tunnel-info nexthop nexthopIpv6Addr

display ip vpn-instance vpn-instance-name tunnel-info nexthop nexthopIpv4Addr

Parameters

Parameter	Description	Value
vpn-instance-name	Specifies the name of a VPN instance.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.
verbose	Displays detailed information about VPN instances.	-
interface	Displays information about the interfaces bound to the VPN instance.	-
tunnel-info	Displays information about the LSP associated with the VPN instance.	-
nexthop	Specifies the next hop address.	-
nexthopIpv6Addr	Specifies an IPv6 nexthop address.	The value is in the format of X:X:X:X:X:X:X:X.
nexthopIpv4Addr	Specifies an IPv4 nexthop address.	It is in dotted decimal notation.

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
l3vpn	read

Usage Guidelines

Usage Scenario

To view the configurations of VPN instances, interfaces bound to them, and LSPs associated with them, run the display ip vpn-instance command. Since VPN instances support IPv4 and IPv6 address families, the display ip vpn-instance command displays the information of different address families separately.

If vpn-instance-name is not specified, the command displays information about all configured VPN instances.

If interface is specified, the command displays all interfaces bound to the specified VPN instance.

If tunnel-info is specified, the command displays information about the LSPs to which the routes of the VPN instance address families recurse (in other words, information about the LSPs between PEs). If the tunnels between PEs are not LSPs, the tunnel information is not displayed.

If tunnel-info and nexthop are specified, you can view information about the tunnels to which the routes that match the nexthop in each address family of the current VPN instance recurse.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display brief information about all VPN instances.

<HUAWEI> display ip vpn-instance
 Total VPN-Instances configured : 5                                             
 Total IPv4 VPN-Instances configured : 3 
 Total IPv6 VPN-Instances configured : 1

  VPN-Instance Name               RD                             Address family
  vrf1                            1:1                            IPv4
  vrf2                            2:2                            IPv4
  vrf3
  vrf4                                                           IPv4
  vrf5                                                           IPv6

# Display detailed information about all VPN instances.

<HUAWEI> display ip vpn-instance verbose
Total VPN-Instances configured : 1  
Total IPv4 VPN-Instances configured : 1 
Total IPv6 VPN-Instances configured : 1

VPN-Instance Name and ID : vpn1, 1
  Description : vrf1
  Interfaces : LoopBack1 
Address family ipv4  
  Create date : 2010/03/05 16:26:27
  Up time : 0 days, 00 hours, 09 minutes and 12 seconds
  Vrf Status : UP
  Route Distinguisher : 100:1
  Export VPN Targets :  1:1
  Import VPN Targets :  1:1
  Label Policy : label per instance
  Per-Instance Label : 1029  
  IP FRR Enable
  Import Route Policy : rp1
  The diffserv-mode Information is : uniform
  The ttl-mode Information is : uniform
  Export Route Policy : rp2
  Tunnel Policy : tp1
  Maximum Routes Limit : 200
  Threshold Routes Limit : 80%
Address family ipv6
  Create date : 2010/03/05 16:26:31
  Up time : 0 days, 00 hours, 09 minutes and 08 seconds 
  Vrf Status : UP
  Route Distinguisher : 100:1
  Export VPN Targets :  1:1
  Import VPN Targets :  1:1
  Label Policy : label per instance
  Per-Instance Label : 123
  Import Route Policy : p1
  Export Route Policy : p2
  Tunnel Policy : tnlpolicy1
  Maximum Routes Limit : 300
  Threshold Routes Limit : 80%

# Display information about the interface bound to the VPN instance named vrf1.

<HUAWEI> display ip vpn-instance vrf1 interface
 VPN-Instance Name and ID : vrf1, 1
  Interface Number : 4
  Interface list : GigabitEthernet0/1/0,
                   LoopBack1,
                   LoopBack2,
                   LoopBack3

# Display information about the LSPs associated with all VPN instances.

<HUAWEI> display ip vpn-instance tunnel-info
Total VPN-Instances configured : 4
 VPN-Instance Name and ID : vrf1, 1
 Address family ipv4
  Nexthop Address                         Tunnel ID             
  192.168.1.102                           65536                 
  Tunnel Name                             Tunnel Type           
  MPLS LOCAL IFNET                        12                    
  IID                                     
  16777469                                
 Address family ipv6
  Nexthop Address                         Tunnel ID             
  ::FFFF:192.168.1.102                    65536                 
  Tunnel Name                             Tunnel Type           
  MPLS LOCAL IFNET                        12                    
  IID                                     
  16777468                                

 VPN-Instance Name and ID : vrf2, 2
 Address family ipv4
  Nexthop Address                         Tunnel ID             
  2001:db8::1                             1                     
  Tunnel Name                             Tunnel Type           
  SRv6-TE Policy                          52                    
  IID                                     Color                 
  16777421                                100                   
 Address family ipv6
  Nexthop Address                         Tunnel ID             
  2.2.2.2                                 65536                 
  Tunnel Name                             Tunnel Type           
  SR-TE Policy                            50                    
  IID                                     Color                 
  16777468                                100                   

 VPN-Instance Name and ID : vrf3, 3
 Address family ipv4
 Address family ipv6

 VPN-Instance Name and ID : vrf4, 4
 Address family ipv4
 Address family ipv6

**Table 1** Description of the **display ip vpn-instance** command output
Item	Description
Total VPN-Instances configured	Total number of VPN instances locally configured.
Total IPv4 VPN-Instances configured	Total number of locally configured VPN instances for which IPv4 address families are enabled.
Total IPv6 VPN-Instances configured	Total number of locally configured VPN instances for which IPv6 address families are enabled.
VPN-Instance Name	VPN instance name.
VPN-Instance Name and ID	Name and ID of the VPN instance. The ID is assigned by the system, which facilitates indexing.
Address family	Address family enabled for the VPN instance: No information is displayed if no address family is enabled. ipv4 is displayed if only the IPv4 address family is enabled. ipv6 is displayed if only the IPv6 address family is enabled. ipv4 ipv6 is displayed if both the IPv4 and IPv6 address families are enabled.
Address family ipv4	Information about the IPv4 address family enabled for the VPN instance.
Address family ipv6	Information about the IPv6 address family enabled for the VPN instance.
RD	RD of the VPN instance IPv4 or IPv6 address family.
ID	Tunnel's ID.
Description	Description of the VPN instance. This field is displayed in the command output only when the description (VPN instance view) command is used.
Interfaces	Interface bound to the VPN instance. This field is displayed only after the ip binding vpn-instance command is configured on the interface.
Create date	Time when the VPN instance is created.
Up time	Period during which the VPN instance maintains in the up state.
Route Distinguisher	RD of the VPN instance IPv4 address family or IPv6 address family.
Export VPN Targets	List of export route targets (ERTs).
Export Route Policy	Export route-policy applied to the VPN instance. This field is displayed only after the export route-policy command is run in the VPN instance IPv4 or IPv6 address family view.
Import VPN Targets	List of import route targets (IRTs).
Import Route Policy	Import route-policy applied to the VPN instance. This field is displayed only after the import route-policy command is run in the VPN instance IPv4 or IPv6 address family view.
Label Policy	Label policy: label per instance: The same label is allocated to all the routes of a VPN instance. This item is displayed in the command output only when the apply-label per-instance command is run in the VPN instance view. label per route: Each route of a VPN instance is assigned a label. Label allocation for routes of a VPN instance is implemented in this mode. label per route pop-go: Each route of a VPN instance is assigned a label. After a device receives a data packet that carries the assigned label, the device removes the label and forwards the packet through an outbound interface based on the ILM. This information is displayed if the apply-label per-route pop-go (VPN instance IPv4 address family view) or apply-label per-route pop-go (VPN instance IPv6 address family view) command is configured.
Label	Label value used when all BGP routes of the same address family share one label.
Per-Instance Label	Label value used when all VPN routes of the VPN instance IPv4 address family or IPv6 address family share the same label. This field is displayed only after the apply-label per-instance command is run in the VPN instance IPv4 or IPv6 address family view.
IP FRR Enable	IP FRR is enabled for the address family.
The diffserv-mode Information is	DiffServ mode, in which resources such as bandwidth are allocated in real time. The DiffServ mode can be: uniform. pipe.
The ttl-mode Information is	TTL processing mode: uniform. pipe.
Tunnel Policy	Tunnel policy applied to the VPN instance. This field is displayed only after the tnl-policy command is run in the VPN instance IPv4 address family view or VPN instance IPv6 address family view.
Tunnel ID	ID of the LSP corresponding to the next-hop address of the route learned by the VPN instance from the peer PE.
Tunnel Name	Name of a tunnel.
Tunnel Type	Tunnel type: 1: LDP. 2: BGP LSP. 3: TE. 12: MPLS LOCAL IFNET. 23: VXLAN. 41: SRBE LSP. 50: SRTE POLICY. 52: SRV6TE POLICY.
Maximum Routes Limit	Maximum number of prefixes supported by the current address family. This field is displayed only after the prefix limit command is run in the VPN instance IPv4 or IPv6 address family view.
Threshold Routes Limit	Percentage of the maximum number of prefixes specified for the current address family. When the maximum number of prefixes reaches the percentage threshold, an alarm is generated. This field is displayed only after the prefix limit command is run in the VPN instance IPv4 or IPv6 address family view.
Vrf Status	Status of the VPN: UP. DOWN.
Interface Number	Number of interfaces bound to the VPN instance.
Interface list	List of interfaces bound to the VPN instance.
Nexthop Address	Next-hop address of the route learned by the VPN instance from the peer PE.
IID	IID value.
Color	Color.