目  录

1 策略路由

1.1 策略路由配置命令

1.1.1 apply access-vpn

1.1.2 apply continue

1.1.3 apply default-gateway

1.1.4 apply default-next-hop

1.1.5 apply default-output-interface

1.1.6 apply fail-action-drop next-hop

1.1.7 apply gateway

1.1.8 apply ip-df

1.1.9 apply loadshare

1.1.10 apply next-hop

1.1.11 apply output-interface

1.1.12 apply precedence

1.1.13 apply remark-vpn

1.1.14 apply srv6-policy

1.1.15 description

1.1.16 display ip policy-based-route

1.1.17 display ip policy-based-route global

1.1.18 display ip policy-based-route interface

1.1.19 display ip policy-based-route local

1.1.20 display ip policy-based-route setup

1.1.21 if-match acl

1.1.22 if-match object-group

1.1.23 if-match packet-length

1.1.24 if-match source-ip

1.1.25 ip global policy-based-route

1.1.26 ip local policy-based-route

1.1.27 ip policy-based-route

1.1.28 ip policy-based-route vxlan-mode enable

1.1.29 policy-based-route

1.1.30 reset ip policy-based-route statistics

 

1 策略路由

1.1  策略路由配置命令

1.1.1  apply access-vpn

apply access-vpn命令用来设置报文在公网或指定的VPN实例中转发。

undo apply access-vpn命令用来取消报文在公网或指定的VPN实例中转发的设置。

【命令】

apply access-vpn { public | vpn-instance vpn-instance-name&<1-4> }

undo apply access-vpn { public | vpn-instance [ vpn-instance-name&<1-4> ] }

【缺省情况】

未设置报文在指定的VPN实例中转发。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

public：设置报文在公网中进行转发。

vpn-instance：设置报文在指定VPN实例中进行转发。

vpn-instance-name：表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。指定的VPN实例必须已经存在。

&<1-4>：表示前面的参数最多可以输入4次。

【使用指导】

应用场景

在策略路由节点配置本命令，可以将满足策略路由节点匹配条件的报文引流到指定的VPN实例。本命令用于在某些特殊组网中在不同网络间转发报文，例如将公网接收到的报文发送到某个VPN中，或者在VPN之间转发报文。

用户可通过重复执行本命令来指定公网和VPN实例。设备将根据配置顺序查找公网或第一个可用的VPN实例中的转发表进行转发。

注意事项

执行undo apply access-vpn vpn-instance [ vpn-instance-name&<1-4> ]命令时，如果仅指定了vpn-instance关键字，那么节点上的所有VPN实例配置会被删除。

当节点上所有的VPN实例配置和公网配置均被删除后，设备恢复缺省转发方式，根据路由表在公网或VPN内转发报文。

【举例】

# 在策略节点中设置报文在名为vpn1的VPN实例中转发（VPN实例vpn1已存在）。

<Sysname> system-view

[Sysname] policy-based-route policy1 permit node 10

[Sysname-pbr-policy1-10] apply access-vpn vpn-instance vpn1

【相关命令】

·     apply remark-vpn

1.1.2  apply continue

apply continue命令用来设置报文从当前节点指定的路径转发失败时，继续进行后续节点的处理。

undo apply continue命令用来恢复缺省情况。

【命令】

apply continue

undo apply continue

【缺省情况】

报文从当前节点指定的路径转发失败时后，不再进入下一节点的匹配。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【使用指导】

满足如下任意一种条件，并且策略节点的匹配模式为permit，本命令即可生效：

·     当前节点中未配置影响报文转发路径的apply子句（apply access-vpn 、apply next-hop、apply output-interface、apply default-next-hop和apply default-output-interface）。

·     当前节点中配置了一个或多个影响报文转发路径的apply子句，但都失效（下一跳不可达、出接口down或者报文在指定VPN内转发失败）且查找普通路由表也转发失败。

【举例】

# 设置报文从当前节点指定的路径转发失败时，继续进行后续节点的处理。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply continue

1.1.3  apply default-gateway

apply default-gateway命令用来设置指导报文转发的缺省下一跳地址为网关地址。

undo apply default-gateway命令用来取消指导报文转发的缺省下一跳地址为网关地址。

【命令】

apply default-gateway interface-type interface-number [ track track-entry-number ]

undo apply default-gateway [ interface-type interface-number ]

【缺省情况】

未设置指导报文转发的缺省下一跳地址为网关地址。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

interface-type interface-number：指定获取网关地址的接口，interface-type interface-number为接口类型和接口编号。

track track-entry-number：指定Track项的序号，track-entry-number取值范围为1～1024。

【使用指导】

配置本命令后，策略路由会使用接口获取的网关地址作为指导报文转发的缺省下一跳地址。当网关地址发生变化时，设备自动将报文转发的缺省下一跳地址修改为变化后的网关地址。如果接口没有获取到网关地址或者网关地址失效，则本命令不生效。

用户可以同时配置多个接口获取的网关地址作为缺省下一跳地址（通过多次配置本命令实现），不同接口获取的网关地址之间形成主备备份。当满足匹配规则后，策略路由将按照配置顺序选择第一个可达的网关下一跳地址转发报文。

配置undo命令时，如果指定了接口，将取消指导报文转发的缺省下一跳地址为该接口获取的网关地址的配置；如果未指定接口，将取消所有指导报文转发的缺省下一跳地址为网关地址的配置。

【举例】

# 设置报文的缺省下一跳地址为GigabitEthernet0/0/1接口获取的网关地址。‌

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply default-gateway gigabitethernet 0/0/1

1.1.4  apply default-next-hop

apply default-next-hop命令用来设置指导报文转发的缺省下一跳。

undo apply default-next-hop命令用来取消指导报文转发的缺省下一跳的设置。

【命令】

apply default-next-hop [ vpn-instance vpn-instance-name | inbound-vpn ] { ip-address [ direct ] [ track track-entry-number ] }&<1-4>

undo apply default-next-hop [ [ vpn-instance vpn-instance-name | inbound-vpn ] ip-address&<1-4> ]

【缺省情况】

未设置指导报文转发的缺省下一跳。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

vpn-instance vpn-instance-name：缺省下一跳所在的VPN实例。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。指定的VPN实例必须已经存在。

inbound-vpn：报文入接口所在的VPN实例。

ip-address：缺省下一跳的IP地址。如果未指定vpn-instance或inbound-vpn参数，表示指定的是公网下一跳。

direct：指定当前缺省下一跳生效的条件为直连下一跳。

track track-entry-number：指定Track项的序号，track-entry-number取值范围为1～1024。

 

&<1-4>：表示单条命令前面的参数一次最多可以输入4次。

【使用指导】

应用场景

用户可以同时配置多个缺省下一跳（通过一次或多次配置本命令实现），多个缺省下一跳工作在主备或负载分担模式：

·     如果策略节点未配置apply loadshare default-next-hop命令，则多个缺省下一跳工作在主备模式。策略路由按照配置顺序选择第一个可用的缺省下一跳作为指导报文转发的主用下一跳。

·     如果策略节点配置了apply loadshare default-next-hop命令，则多个缺省下一跳工作在负载分担模式。如果报文未匹配快速转发表，则策略路由按照配置顺序逐包轮流选择有效的缺省下一跳指导报文转发；如果匹配快速转发表，则策略路由按照配置顺序逐流轮流选择有效的缺省下一跳指导报文转发。

注意事项

配置undo命令时，如果指定了缺省下一跳IP地址，将取消已配置的该缺省下一跳；如果未指定缺省下一跳IP地址，将取消已配置的所有缺省下一跳。

【举例】

# 设置指导报文转发的缺省直连下一跳为1.1.1.1。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply default-next-hop 1.1.1.1 direct

【相关命令】

·     apply loadshare

1.1.5  apply default-output-interface

apply default-output-interface命令用来设置指导报文转发的缺省出接口。

undo apply default-output-interface命令用来取消指导报文转发的缺省出接口的设置。

【命令】

apply default-output-interface { interface-type interface-number [ track track-entry-number ] }&<1-4>

undo apply default-output-interface [ { interface-type interface-number }&<1-4> ]

【缺省情况】

未设置指导报文转发的缺省出接口。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

interface-type interface-number：指定接口类型和接口编号。

track track-entry-number：指定Track项的序号，track-entry-number取值范围为1～1024。

&<1-4>：表示单条命令前面的参数一次最多可以输入4次。

【使用指导】

应用场景

用户可以同时配置多个缺省出接口（通过一次或多次配置本命令实现），多个缺省出接口工作在主备或负载分担模式：

·     如果策略节点未配置apply loadshare default-output-interface命令，则多个缺省出接口工作在主备模式。策略路由按照配置顺序选择第一个可用的缺省出接口作为指导报文转发的主用出接口。

·     如果策略节点配置了apply loadshare default-output-interface命令，则多个缺省出接口工作在负载分担模式。如果报文未匹配快速转发表，则策略路由按照配置顺序逐包轮流选择有效的缺省出接口指导报文转发；如果匹配快速转发表，则策略路由按照配置顺序逐流轮流选择有效的缺省出接口指导报文转发。

注意事项

指定缺省出接口类型需配置为P2P（Point-to-Point，点到点）接口，对于非P2P接口（广播类型的接口和NBMA类型的接口），比如以太网接口、Virtual-Template接口，由于有多个可能的下一跳，可能会造成报文转发不成功的现象。NBMA（Non Broadcast MultiAccess，非广播多路访问）指全连通、非广播、多点可达的网络，这种网络采用单播方式发送报文。

建议不要使用EVPN动态创建的VXLAN隧道接口作为报文转发的缺省出接口。否则当配置重新恢复后，EVPN会重新创建隧道，隧道接口的编号可能发生变化，导致报文转发失败。关于EVPN VXLAN的详细介绍，请参见“EVPN配置指导”中的“EVPN VXLAN”。

配置undo命令时，如果指定了接口，将取消已配置的该缺省出接口；如果未指定接口，将取消已配置的所有缺省出接口。

【举例】

# 设置报文的缺省出接口为GigabitEthernet0/0/1。‌

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply default-output-interface gigabitethernet 0/0/1

【相关命令】

·     apply loadshare

1.1.6  apply fail-action-drop next-hop

apply fail-action-drop next-hop命令用来设置策略路由配置的下一跳失效时，设备直接丢弃该报文。

undo apply fail-action-drop next-hop命令用来恢复缺省情况。

【命令】

apply fail-action-drop next-hop

undo apply fail-action-drop next-hop

【缺省情况】

策略路由配置的下一跳失效时，设备继续查找路由表进行报文转发。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【使用指导】

应用场景

用户在策略路由中指定的下一跳可能因为链路中断、接口shutdown等事件变成失效下一跳。未执行本命令时策略路由指定的下一跳失效后，设备会继续查找路由表进行报文转发。在某些组网环境中，报文需要严格按照策略路由指定的下一跳地址转发。配置本功能后，策略路由配置的下一跳失效时，设备就会直接丢弃报文，便于管理员快速发现问题并处理问题。

注意事项

策略路由支持配置多个下一跳地址，当配置的所有下一跳地址都失效后，本功能才生效。这时，需要转发到任意一个下一跳地址的报文都会被直接丢弃。

如果只配置了本功能，未指定任何一个下一跳地址，则报文都会被丢弃。

本配置对软件转发的报文不生效。

【举例】

# 设置报文转发的下一跳为1.1.1.1，并设置策略路由配置的下一跳失效时，设备直接丢弃该报文。

<Sysname> system-view

[Sysname] policy-based-route policy1 permit node 10

[Sysname-pbr-policy1-10] apply next-hop 1.1.1.1

[Sysname-pbr-policy1-10] apply fail-action-drop next-hop

1.1.7  apply gateway

apply gateway命令用来设置指导报文转发的下一跳地址为网关地址。

undo apply gateway命令用来取消指导报文转发的下一跳地址为网关地址的配置。

【命令】

apply gateway interface-type interface-number [ track track-entry-number ]

undo apply gateway [ interface-type interface-number ]

【缺省情况】

未设置指导报文转发的下一跳地址为网关地址。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

interface-type interface-number：指定获取网关地址的接口，interface-type interface-number为接口类型和接口编号。

track track-entry-number：指定Track项的序号，track-entry-number取值范围为1～1024。

【使用指导】

配置本命令后，策略路由会使用接口获取的网关地址作为指导报文转发的下一跳地址。当网关地址发生变化时，设备自动将报文转发的下一跳地址修改为变化后的网关地址。如果接口没有获取到网关地址或者网关地址失效，则本命令不生效。

用户可以同时配置多个接口获取的网关地址作为下一跳地址（通过多次配置本命令实现），不同接口获取的网关地址之间形成主备备份。当满足匹配规则后，策略路由将按照配置顺序选择第一个可达的网关下一跳地址转发报文。

配置undo命令时，如果指定了接口，将取消指导报文转发的下一跳地址为该接口获取的网关地址的配置；如果未指定接口，将取消所有指导报文转发的下一跳地址为网关地址的配置。

【举例】

# 设置报文的下一跳地址为GigabitEthernet0/0/1接口获取的网关地址。‌

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply gateway gigabitethernet 0/0/1

1.1.8  apply ip-df

apply ip-df命令用来设置IP报文头中的DF（Don’t Fragment，不分片）标志。

undo apply ip-df命令用来恢复缺省情况。

【命令】

apply ip-df df-value

undo apply ip-df

【缺省情况】

未设置IP报文头中的DF标志。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

df-value：设置IP报文头中的DF标志，取值0或1。

【使用指导】

报文中DF标志位置为0，表示可以对报文进行分片处理。

报文中DF标志位置为1，表示不可对报文进行分片处理。

【举例】

# 将报文IP首部的DF标志位置为0。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply ip-df 0

1.1.9  apply loadshare

apply loadshare命令用来设置多个下一跳（或缺省下一跳、缺省出接口、缺省SRV6 TE Policy、出接口、SRV6 TE Policy）工作在负载分担模式。

undo apply loadshare命令用来恢复缺省情况。

【命令】

apply loadshare { default-next-hop | default-output-interface | default-srv6-policy | next-hop | output-interface | srv6-policy }

undo apply loadshare { default-next-hop | default-output-interface | default-srv6-policy | next-hop | output-interface | srv6-policy }

【缺省情况】

多个下一跳（或缺省下一跳、缺省出接口、缺省SRV6 TE Policy、出接口、SRV6 TE Policy）工作在主备模式。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

default-next-hop：设置指导报文转发的多个缺省下一跳工作在负载分担模式。

default-output-interface：设置指导报文转发的多个缺省出接口工作在负载分担模式。

default-srv6-policy：设置指导报文转发的多个缺省SRV6 TE Policy工作在负载分担模式。next-hop：设置指导报文转发的多个下一跳工作在负载分担模式。

output-interface：设置指导报文转发的多个出接口工作在负载分担模式。

srv6-policy：设置指导报文转发的多个SRV6 TE Policy工作在负载分担模式。

【使用指导】

使用场景

本命令用于设置策略路由的多个下一跳（或缺省下一跳、缺省出接口、缺省SRV6 TE Policy、出接口、SRV6 TE Policy）同时指导报文转发。

工作机制

缺省情况下，多个下一跳（或缺省下一跳、缺省出接口、缺省SRV6 TE Policy、出接口、SRV6 TE Policy）的工作在主备模式。以多个下一跳为例，在该模式下，设备按照配置顺序，以第一个配置的下一跳作为主用下一跳，指导报文转发。当主用下一跳失效时，按配置顺序选择后续的第一个可用的下一跳指导报文转发。

配置本命令后，多个下一跳（或缺省下一跳、缺省出接口、缺省SRV6 TE Policy、出接口、SRV6 TE Policy）的负载分担情况如下：

·     对于多个下一跳：

如果报文不匹配快速转发表，会按照配置顺序逐包轮流选择有效下一跳指导报文转发；如果报文匹配快速转发表，则按照配置顺序逐流轮流选择有效的下一跳指导报文转发。

对于支持配置下一跳负载分担权重的设备，下一跳的负载分担模式会按照下一跳的权重指导报文转发。缺省情况下，多个下一跳会按照缺省的权重值平均分配带宽，多个下一跳的转发流量的比例是相同的。

·     多个缺省下一跳的情况与多个下一跳相同。

·     对于多个出接口：

¡     如果不匹配快速转发表，则按照配置顺序逐包轮流选择有效的出接口指导报文转发。

¡     如果匹配快速转发表，则按照配置顺序逐流轮流选择有效的出接口指导报文转发。

·     多个缺省出接口的情况与多个出接口相同。

·     对于多个SRV6 TE Policy或缺省SRV6 TE Policy，设备会按照配置顺序轮流选择可用的SRV6 TE Policy指导报文转发。

【举例】

# 设置多个下一跳工作在负载分担模式。‌

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply next-hop 1.1.1.1 2.2.2.2

[Sysname-pbr-aa-11] apply loadshare next-hop

# 设置多个出接口工作在负载分担模式。‌

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply output-interface gigabitethernet 0/0/1 gigabitethernet 0/0/2

[Sysname-pbr-aa-11] apply loadshare output-interface

# 设置多个SRV6 TE Policy工作在负载分担模式。‌

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply srv6-policy 1000::1 10 sid 2000::2 3000::1 12 sid 4000::2

[Sysname-pbr-aa-11] apply loadshare srv6-policy

# 设置多个缺省下一跳工作在负载分担模式。‌

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply default-next-hop 1.1.1.1 2.2.2.2

[Sysname-pbr-aa-11] apply loadshare default-next-hop

# 设置多个缺省出接口工作在负载分担模式。‌

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply default-output-interface gigabitethernet 0/0/1 gigabitethernet 0/0/2

[Sysname-pbr-aa-11] apply loadshare default-output-interface

# 设置多个缺省SRV6 TE Policy工作在负载分担模式。‌

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply default-srv6-policy 1000::1 10 sid 2000::2 3000::1 12 sid 4000::2

[Sysname-pbr-aa-11] apply loadshare default-srv6-policy

【相关命令】

·     apply default-next-hop

·     apply default-output-interface

·     apply default-srv6-policy

·     apply next-hop

·     apply output-interface

·     apply srv6-policy

1.1.10  apply next-hop

apply next-hop命令用来设置报文转发的下一跳。

undo apply next-hop命令用来取消报文转发下一跳的设置。

【命令】

apply next-hop [ vpn-instance vpn-instance-name | inbound-vpn ] { ip-address [ direct ] [ track track-entry-number ] [ weight weight-value ] }&<1-4>

undo apply next-hop [ [ vpn-instance vpn-instance-name | inbound-vpn ] ip-address&<1-4> ]

【缺省情况】

未设置报文转发的下一跳。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

vpn-instance vpn-instance-name：下一跳所在的VPN实例。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。指定的VPN实例必须已经存在。

inbound-vpn：报文入接口所在的VPN实例。

ip-address：下一跳IP地址。如果未指定vpn-instance或inbound-vpn参数，表示指定的是公网下一跳。

direct：指定当前下一跳生效的条件为直连下一跳。

track track-entry-number：指定Track项的序号，track-entry-number取值范围为1～1024。

weight weight-value：指定下一跳负载分担的权重。设备根据权重确定该下一跳转发流量的比例。例如，三个下一跳配置的负载分担权重分别为1、1和2，则它们的负载分担的比例分别为1/4、1/4和1/2。weight-value取值范围为1～100，缺省值为10。

 

&<1-4>：表示单条命令前面的参数一次最多可以输入4次。

【使用指导】

应用场景

用户可以同时配置多个下一跳（通过一次或多次配置本命令实现），多个下一跳工作在主备或负载分担模式：

·     如果策略节点未配置apply loadshare next-hop命令，则多个下一跳工作在主备模式。策略路由按照配置顺序选择第一个可用的下一跳作为指导报文转发的主用下一跳。

·     如果策略节点配置了apply loadshare next-hop命令，则多个下一跳工作在负载分担模式。如果报文未匹配快速转发表，则策略路由按照配置顺序逐包轮流选择有效的下一跳指导报文转发；如果匹配快速转发表，则策略路由按照配置顺序逐流轮流选择有效的下一跳指导报文转发。

注意事项

配置undo命令时，如果指定了下一跳IP地址，将取消已配置的该下一跳；如果未指定下一跳IP地址，将取消已配置的所有下一跳。

执行某些操作导致apply next-hop命令指定的下一跳变为不可达时（例如删除对端接口的IP地址），设备上可能仍然存在该下一跳IP地址对应的ARP表项。此时，策略路由依然生效，导致报文被错误引流。为了避免上述问题，建议配合使用Track功能检测下一跳是否可达。当Track功能检测到下一跳不可达时，对应的策略路由不再生效。

【举例】

# 设置报文的直连下一跳为1.1.1.1。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply next-hop 1.1.1.1 direct

【相关命令】

·     apply loadshare

1.1.11  apply output-interface

apply output-interface命令用来设置指导报文转发的出接口。

undo apply output-interface命令用来取消指导报文转发的出接口的设置。

【命令】

apply output-interface { interface-type interface-number [ track track-entry-number ] }&<1-4>

undo apply output-interface [ { interface-type interface-number }&<1-4> ]

【缺省情况】

未设置指导报文转发的出接口。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

interface-type interface-number：指定接口类型和接口编号。

track track-entry-number：指定Track项的序号，track-entry-number取值范围为1～1024。

&<1-4>：表示单条命令前面的参数一次最多可以输入4次。

【使用指导】

应用场景

用户可以同时配置多个出接口（通过一次或多次配置本命令实现），多个出接口工作在主备或负载分担模式：

·     如果策略节点未配置apply loadshare output-interface命令，则多个出接口工作在主备模式。策略路由按照配置顺序选择第一个可用的出接口作为指导报文转发的主用出接口。

·     如果策略节点配置了apply loadshare output-interface命令，则多个出接口工作在负载分担模式。如果报文未匹配快速转发表，则策略路由按照配置顺序逐包轮流选择有效的出接口指导报文转发；如果匹配快速转发表，则策略路由按照配置顺序逐流轮流选择有效的出接口指导报文转发。

注意事项

指定出接口类型需配置为P2P接口，对于非P2P接口（广播类型的接口和NBMA类型的接口），比如以太网接口、Virtual-Template接口，由于有多个可能的下一跳，可能会造成报文转发不成功的现象。

建议不要使用EVPN动态创建的VXLAN隧道接口作为报文转发的出接口。否则当配置重新恢复后，EVPN会重新创建隧道，隧道接口的编号可能发生变化，导致报文转发失败。关于EVPN VXLAN的详细介绍，请参见“EVPN配置指导”中的“EVPN VXLAN”。

配置undo命令时，如果指定了接口，将取消已配置的该出接口；如果未指定接口，将取消已配置的所有出接口。

【举例】

# 对已经匹配的IP报文指定出接口为GigabitEthernet0/0/1。‌

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply output-interface gigabitethernet 0/0/1

【相关命令】

·     apply loadshare

1.1.12  apply precedence

apply precedence 命令用来设置IP报文的优先级。

undo apply precedence命令用来恢复缺省情况。

【命令】

apply precedence { type | value }

undo apply precedence

【缺省情况】

未设置IP报文的优先级。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

type：IP报文的优先级类型。

value：IP报文的优先级值，IP报文共有8（0～7）个优先级，每个数值对应一个优先级类型。在输入参数的时候可以输入数值，也可以输入优先级类型。对应关系如表1-1所示。

表1-1 IP优先级值与优先级类型对应表

优先级值	优先级类型
0	routine
1	priority
2	immediate
3	flash
4	flash-override
5	critical
6	internet
7	network

 

【举例】

# 设置IP报文的优先级为5（critical）。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply precedence critical

1.1.13  apply remark-vpn

apply remark-vpn命令用来重标记报文所属的VPN。

undo apply remark-vpn命令用来恢复缺省情况。

【命令】

apply remark-vpn

undo apply remark-vpn

【缺省情况】

未重标记报文所属的VPN。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【使用指导】

一般情况下，配置apply access-vpn命令后，设备仅在指定的VPN实例内转发报文，但不会重标记报文所属的VPN，后续业务模块学到的还是报文中之前的VPN实例。如果需要重标记报文所属的VPN信息，则需要配置本命令。

本命令必须和apply access-vpn命令同时使用。只有配置了apply access-vpn命令成功指导报文转发时，本命令才能重标记报文所属的VPN信息，标记的VPN例是生效的apply access-vpn命令配置的VPN实例。

对于硬件转发的设备，本命令不生效。

【举例】

# 重标记匹配ACL 3000的报文所属的VPN实例为vpn1。

<Sysname> system-view

[Sysname] policy-based-route aaa permit node 10

[Sysname-pbr-aaa-10] if-match acl 3000

[Sysname-pbr-aaa-10] apply access-vpn vpn-instance vpn1

[Sysname-pbr-aaa-10] apply remark-vpn

【相关命令】

·     apply access-vpn

1.1.14  apply srv6-policy

apply srv6-policy命令用来配置指导报文转发的SRV6 TE Policy。

undo apply srv6-policy命令用来取消指导报文转发的SRV6 TE Policy的配置。

【命令】

apply srv6-policy { endpoint color [ { sid | vpnsid } sid ] }&<1-2>

undo apply srv6-policy [ { endpoint color }&<1-2> ]

【缺省情况】

未配置指导报文转发的SRV6 TE Policy。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

endpoint：SRV6 TE Policy目的节点的IPv6地址。

color：SRV6 TE Policy的Color属性，取值范围为0～4294967295。

sid：指定目的节点的SRv6 SID为公网SID。

vpnsid：指定目的节点的SRv6 SID为私网SID。

sid：指定IPv6地址形式的目的节点的SRv6 SID。

&<1-2>：表示前面的参数最多可以输入2次。

【使用指导】

用户可以同时配置多个SRV6 TE Policy（通过一次或多次配置本命令实现），这些SRV6 TE Policy形成备份。当满足匹配规则后，将按照配置顺序选择第一个可用的SRV6 TE Policy指导报文转发。

在执行undo命令时，如果未指定SRV6 TE Policy，将取消该策略节点已配置的所有SRV6 TE Policy。

配置本命令中的sid时请注意，该值在报文中携带时并不区分公网与私网，仅用于在首节点标识该sid属于公网或私网，因此{ sid | vpnsid }并不影响报文的转发。

在配置报文使用指定的SRV6 TE Policy进行转发时，支持配置目的节点的SRv6 SID，首节点在为报文封装的SRH中添加该SID，该SID位于SRV6 TE Policy的SID列表之后。报文经SRV6 TE Policy转发到目的节点后，目的节点再依据该SRv6 SID查找本地的Local SID转发表项进行转发。

【举例】

# 配置指导报文转发的SRV6 TE Policy，其目的节点的IPv6地址为1000::1、color属性为10、目的节点的公网SRv6 SID为2000::2。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 1

[Sysname-pbr-aa-1] apply srv6-policy 1000::1 10 sid 2000::2

【相关命令】

·     apply loadshare

1.1.15  description

description命令用来配置当前策略节点的描述信息。

undo description命令用来恢复缺省情况。

【命令】

description text

undo description

【缺省情况】

未配置策略节点的描述信息。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

text：策略节点的描述信息，为1～127个字符的字符串，区分大小写。

【举例】

# 配置策略节点的描述信息为“Officeuse”。

<Sysname> system-view

[Sysname] policy-based-route 1 permit node 1

[Sysname-pbr-1-1] description Officeuse

1.1.16  display ip policy-based-route

display ip policy-based-route命令用来显示已经配置的策略。

【命令】

display ip policy-based-route [ policy policy-name ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

policy policy-name：显示指定的策略。policy-name表示策略名，唯一标识一个策略，为1～19个字符的字符串，区分大小写。如果未指定本参数，则显示所有已经配置的策略。

【举例】

# 显示所有已经配置的策略。

<Sysname> display ip policy-based-route

Policy name: aaa

  node 1 permit:

    if-match acl 2000

    apply next-hop 1.1.1.1

  node 10 permit:

    if-match acl 3000

    apply srv6-policy 1000::1 10 sid 2000::2(NID: 2150629377)

    apply default-srv6-policy 3000::3 20 vpnsid 4000::4(NID: 2149580801)

表1-2 display ip policy-based-route命令显示信息描述表

字段	描述
Policy name	策略名
node 1 permit	节点1的匹配模式为允许
if-match acl	满足ACL的报文被匹配
apply next-hop	为匹配的报文指定下一跳
apply srv6-policy 1000::1 10 sid 2000::2(NID: 2150629377)	为匹配的报文指定目的节点IPv6地址为1000::1、color属性为10、目的节点SRv6 SID为2000::2的SRV6 TE Policy，该SRV6 TE Policy的NHLFE（Next Hop Label Forwarding Entry，下一跳标签转发项）表项索引为2150629377
apply default-srv6-policy 3000::3 20 vpnsid 4000::4(NID: 2149580801)	为匹配的报文指定目的节点IPv6地址为3000::3、color属性为20、目的节点SRv6 SID为4000::4的缺省SRV6 TE Policy，该缺省SRV6 TE Policy的NHLFE表项索引为2149580801

 

【相关命令】

·     policy-based-route

1.1.17  display ip policy-based-route global

display ip policy-based-route global命令用来显示全局策略路由的配置信息和统计信息。

【命令】

display ip policy-based-route global [ slot slot-number ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number：显示指定单板上全局策略路由的配置信息和统计信息。slot-number表示单板所在的槽位号。如果未指定本参数，将显示主用主控板上全局策略路由的配置信息和统计信息。‌

【举例】

# 显示全局策略路由的配置信息和统计信息。

<Sysname> display ip policy-based-route global

Global policy-based routing information:

Policy name: aaa

  node 0 deny:

  Matches: 0, bytes: 0

  node 1 permit:

    if-match acl 3999

  Matches: 0, bytes: 0

  node 2 permit:

    if-match acl 2000

    apply next-hop 2.2.2.2

  Matches: 0, bytes: 0

  node 5 permit:

    if-match acl 3101

    apply next-hop 1.1.1.1

  Matches: 0, bytes: 0

Total matches: 0, total bytes: 0

表1-3 display ip policy-based-route global命令显示信息描述表

字段	描述
Global policy-based routing information	全局策略路由的配置信息和统计信息 如果显示信息中存在(failed)，则表示策略下发驱动失败。只有先取消全局策略路由的应用，再重新应用全局策略路由，下发才可能成功
Policy name	策略名
node 0 deny node 2 permit	节点的匹配模式为允许（permit）/拒绝（deny） 如果显示信息中存在(not support)，则表示设备不支持该节点设置的规则；如果显示信息中存在(no resource)，则表示设备的ACL等资源不足，为该节点分配ACL等资源失败
if-match acl	满足ACL的报文被匹配
apply next-hop	为匹配的报文指定下一跳
apply output-interface XXXX track 1	为匹配的报文指定出接口 如果显示信息中存在(down)，则表示接口网络层down 如果显示信息中存在(inactive)，则表示接口不在位
Matches	节点匹配成功的次数，取值为“N/A”表示设备不支持统计匹配次数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段 如果显示信息中存在(no statistics resource)，则表示统计资源不足
bytes	节点匹配成功的字节数，取值为“N/A”表示设备不支持统计匹配字节数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段
Total matches	策略所有节点匹配成功的次数，取值为“N/A”表示设备不支持统计匹配次数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段
total bytes	策略所有节点匹配成功的字节数，取值为“N/A”表示设备不支持统计匹配字节数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段

 

【相关命令】

·     ip global policy-based-route

1.1.18  display ip policy-based-route interface

display ip policy-based-route interface命令用来显示接口下转发策略路由的配置信息和统计信息。

【命令】

display ip policy-based-route interface interface-type interface-number [ slot slot-number ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

interface-type interface-number：用来指定接口的类型和编号。

slot slot-number：显示指定单板上的信息。slot-number表示单板所在的槽位号。如果未指定本参数，将显示主用主控板上的信息。‌

【举例】

# 显示接口GigabitEthernet0/0/1下转发策略路由的配置信息和统计信息。‌

<Sysname> display ip policy-based-route interface gigabitethernet 0/0/1

Policy based routing information for interface GigabitEthernet0/0/1:

Policy name: aaa

  node 0 deny:

  Matches: 0, bytes: 0

  node 1 permit:

    if-match acl 3999

  Matches: 0, bytes: 0

  node 2 permit:

    if-match acl 2000

    apply next-hop 2.2.2.2

  Matches: 0, bytes: 0

  node 5 permit:

    if-match acl 3101

    apply next-hop 1.1.1.1

    apply output-interface GigabitEthernet0/0/2 track 1

    apply output-interface GigabitEthernet0/0/3 track 2

  Matches: 0, bytes: 0

  node 8 permit:

   if-match acl 3200

    apply srv6-policy 1000::1 10 sid 2000::2(NID: 2150629377)

    apply default-srv6-policy 3000::3 20 vpnsid 4000::4(NID: 2149580801)

  Matches: 0, bytes: 0

Total matches: 0, total bytes: 0

表1-4 display ip policy-based-route interface命令显示信息描述表

字段	描述
Policy based routing information for interface XXXX	接口下转发策略路由的配置信息和统计信息 在指定slot时，如果策略下发驱动失败，设备会显示(failed)。此时，所有节点都下发失败
Policy name	策略名
node 0 deny node 2 permit	节点的匹配模式为允许（permit）/拒绝（deny） 在指定slot时，如果节点上不生效，会用括号说明不生效原因：not support表示设备不支持该节点设置的规则；no resource表示设备的ACL等资源不足，为该节点分配ACL等资源失败
if-match acl	满足ACL的报文被匹配
apply next-hop	为匹配的报文指定下一跳
apply output-interface track 1	为匹配的报文指定出接口。括号中显示接口的状态：up、down、inactive。接口不在位时，显示inactive；接口网络层down时，显示down
apply srv6-policy 1000::1 10 sid 2000::2(NID: 2150629377)	为匹配的报文指定目的节点IPv6地址为1000::1、color属性为10、目的节点SRv6 SID为2000::2的SRV6 TE Policy，该SRV6 TE Policy的NHLFE（Next Hop Label Forwarding Entry，下一跳标签转发项）表项索引为2150629377
apply default-srv6-policy 3000::3 20 vpnsid 4000::4(NID: 2149580801)	为匹配的报文指定目的节点IPv6地址为3000::3、color属性为20、目的节点SRv6 SID为4000::4的缺省SRV6 TE Policy，该缺省SRV6 TE Policy的NHLFE（Next Hop Label Forwarding Entry，下一跳标签转发项）表项索引为2149580801
Matches	节点匹配成功的次数，取值为“N/A”表示设备不支持统计匹配次数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段 在指定slot的情况下，如果设备在指定槽位上统计资源不足时，则显示“(no statistics resource)”
bytes	节点匹配成功的字节数，取值为“N/A”表示设备不支持统计匹配字节数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段
Total matches	策略所有节点匹配成功的次数，取值为“N/A”表示设备不支持统计匹配次数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段
total bytes	策略所有节点匹配成功的字节数，取值为“N/A”表示设备不支持统计匹配字节数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段

‌

【相关命令】

·     ip policy-based-route

1.1.19  display ip policy-based-route local

display ip policy-based-route local命令用来显示本地策略路由的配置信息和统计信息。

【命令】

display ip policy-based-route local [ slot slot-number ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number：显示指定单板上本地策略路由的配置信息和统计信息。slot-number表示单板所在的槽位号。如果未指定本参数，将显示主用主控板上本地策略路由的配置信息和统计信息。‌

【举例】

# 显示本地策略路由的配置信息和统计信息。

<Sysname> display ip policy-based-route local

Policy based routing information for local:

Policy name: aaa

  node 0 deny:

  Matches: 0, bytes: 0

  node 1 permit:

    if-match acl 3999

  Matches: 0, bytes: 0

  node 2 permit:

    if-match acl 2000

    apply next-hop 2.2.2.2

  Matches: 0, bytes: 0

  node 5 permit:

    if-match acl 3101

    apply next-hop 1.1.1.1

  Matches: 0, bytes: 0

  node 8 permit:

   if-match acl 3200

    apply srv6-policy 1000::1 10 sid 2000::2(NID: 2150629377)

    apply default-srv6-policy 3000::3 20 vpnsid 4000::4(NID: 2149580801)

  Matches: 0, bytes: 0

Total matches: 0, total bytes: 0

表1-5 display ip policy-based-route local命令显示信息描述表

字段	描述
Policy based routing information for local	本地策略路由的配置信息和统计信息
Policy name	策略名
node 0 deny/node 2 permit	节点的匹配模式为允许（permit）/拒绝（deny）
if-match acl	满足ACL的报文被匹配
apply next-hop	为匹配的报文指定下一跳
apply srv6-policy 1000::1 10 sid 2000::2(NID: 2150629377)	为匹配的报文指定目的节点IPv6地址为1000::1、color属性为10、目的节点SRv6 SID为2000::2的SRV6 TE Policy，该SRV6 TE Policy的NHLFE（Next Hop Label Forwarding Entry，下一跳标签转发项）表项索引为2150629377
apply default-srv6-policy 3000::3 20 vpnsid 4000::4(NID: 2149580801)	为匹配的报文指定目的节点IPv6地址为3000::3、color属性为20、目的节点SRv6 SID为4000::4的缺省SRV6 TE Policy，该缺省SRV6 TE Policy的NHLFE（Next Hop Label Forwarding Entry，下一跳标签转发项）表项索引为2149580801
Matches	节点匹配成功的次数，取值为“N/A”表示设备不支持统计匹配次数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段
bytes	节点匹配成功的字节数，取值为“N/A”表示设备不支持统计匹配字节数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段
Total matches	策略所有节点匹配成功的次数，取值为“N/A”表示设备不支持统计匹配次数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段
total bytes	策略所有节点匹配成功的字节数，取值为“N/A”表示设备不支持统计匹配字节数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段

 

【相关命令】

·     ip local policy-based-route

1.1.20  display ip policy-based-route setup

display ip policy-based-route setup命令用来显示已经应用的策略路由信息。

【命令】

display ip policy-based-route setup

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 显示已经应用的策略路由信息。‌

<Sysname> display ip policy-based-route setup

Policy name              Type     Interface

aaa                      Forward  GigabitEthernet0/0/1

aaa                      Forward  GigabitEthernet0/0/2

aaa                      Local    N/A

abc                      Global   N/A

表1-6 display ip policy-based-route setup命令显示信息描述表

字段	描述
Policy name	策略名
Type	开启策略路由类型，取值为 ·     Forward：转发策略类型 ·     Egress：接口出方向策略类型 ·     Local：本地策略路由类型 ·     Global：全局策略路由类型
Interface	应用策略的接口 对于本地策略路由和全局策略路由，则显示为N/A

 

1.1.21  if-match acl

if-match acl命令用来设置ACL匹配规则。

undo if-match acl命令用来恢复缺省情况。

【命令】

if-match acl { acl-number | name acl-name }

undo if-match acl

【缺省情况】

未设置ACL匹配规则。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

acl-number：访问控制列表号，取值范围为2000～3999。其中：

·     基本ACL，acl-number取值范围为2000～2999；

·     高级ACL，acl-number取值范围为3000～3999。

name acl-name：指定ACL的名称。acl-name表示ACL的名称，为1～63个字符的字符串，不区分大小写，必须以英文字母a～z或A～Z开头。为避免混淆，ACL的名称不允许使用英文单词all。只有指定基本ACL或高级ACL的acl-name才生效。

【使用指导】

引用ACL时，需要注意的是：

·     若引用的ACL不存在，或者引用的ACL中没有配置规则，则表示所有的报文都能通过该ACL规则的过滤。

【举例】

# 设置满足ACL 2011的报文被匹配。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] if-match acl 2011

# 设置满足ACL名称为aaa的报文被匹配。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] if-match acl name aaa

1.1.22  if-match object-group

if-match object-group命令用来设置服务对象组匹配规则。

undo if-match object-group命令用来删除服务对象组匹配规则。

【命令】

if-match object-group service object-group-name&<1-6>

undo if-match object-group service [ object-group-name&<1-6> ]

【缺省情况】

未设置服务对象组匹配规则。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

service object-group-name：服务对象组名，为1～31个字符的字符串，不区分大小写。

&<1-6>：表示前面的参数最多可以输入6次。

【使用指导】

应用场景

对象组分为IPv4地址对象组、IPv6地址对象组、服务对象组和端口对象组。通过本命令，策略路由可以识别出属于指定对象组的报文。

关于对象组的详细介绍，请参见“安全配置指导”中的“对象组”。

注意事项

执行undo命令时，如果指定了参数，则表示删除和参数对应的服务对象组匹配规则；如果未指定任何参数，则表示删除所有的服务对象组匹配规则。

【举例】

# 设置服务对象组匹配规则test。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] if-match object-group service test

1.1.23  if-match packet-length

if-match packet-length命令用来设置IP报文长度匹配规则。

undo if-match packet-length命令用来恢复缺省情况。

【命令】

if-match packet-length min-len max-len

undo if-match packet-length

【缺省情况】

未设置IP报文长度匹配规则。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

min-len：最短IP报文长度，取值范围为1～65535，单位为字节。

max-len：最长IP报文长度，取值范围为1～65535，单位为字节。max-len应该不小于min-len。

【使用指导】

IP报文长度是指从IP报文头开始到报文末尾的总长度，IP报文长度匹配含边界值，如指定min-len为100，max-len为200，则报文长度为100与200的报文都是匹配报文。

【举例】

# 设置IP报文长度在100～200字节之间的报文被匹配。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] if-match packet-length 100 200

1.1.24  if-match source-ip

if-match source-ip命令用来设置报文源地址匹配规则。

undo if-match source-ip命令用来删除源地址匹配规则。

【命令】

if-match source-ip { interface interface-type interface-number | [ vpn-instance vpn-instance-name ] ip-address }

undo if-match source-ip

【缺省情况】

未设置报文源地址匹配规则。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

interface interface-type interface-number：指定接口的主IP地址。

vpn-instance vpn-instance-name：表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则指定的源地址在公网。

ip-address：IP地址，为点分十进制格式。

【使用指导】

应用场景

某些企业或机构的网关设备的出口可能是双上行或多上行，每条上行链路连接不同运营商的ISP设备。网关设备向运营商的ISP设备发送业务报文时，可能发送到错误的运营商的ISP设备，这些设备收到未通过自身认证授权的业务报文后，会直接丢弃该报文。这就会发生网关发送给运营商的ISP设备的报文被错误丢弃的问题。可通过本命令匹配业务报文的源IP地址，再执行apply next-hop或apply output-interface命令指定正确运营商的ISP设备，就可将业务报文转发到准确的运营商ISP设备。

一般情况下，网关设备需要先将业务报文封装（比如IPsec封装）后，再转发给运营商的ISP设备，所以，在配置本地策略路由时，才需要配置本匹配规则。

注意事项

如果本命令使用interface interface-type interface-number参数设置报文源地址匹配规则，则建议指定报文的出接口。

建议不要使用EVPN动态创建的隧道接口地址作为匹配规则的源地址。否则当配置重新恢复后，EVPN会重新创建隧道，隧道接口的编号可能发生变化，隧道接口的地址也会随之变化，导致源地址匹配规则无法生效。关于EVPN的介绍，请参见“EVPN配置指导”中的“EVPN概述”。

在同一个策略节点中多次执行本命令，最后一次执行的命令生效。

【举例】

# 在策略节点aa中，设置匹配报文源IP地址为1.1.1.1的匹配规则。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] if-match source-ip 1.1.1.1

1.1.25  ip global policy-based-route

ip global policy-based-route命令用来对所有接口转发的报文应用策略。

undo ip global policy-based-route命令用来恢复缺省情况。

【命令】

ip global policy-based-route policy-name

undo ip global policy-based-route

【缺省情况】

未对所有接口转发的报文应用策略。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

policy-name：策略名，唯一标识一个策略，为1～19个字符的字符串，区分大小写。该策略必须已经存在。

【使用指导】

应用场景

本命令用于对设备上的所有接口转发的报文应用策略路由。

注意事项

一台设备只能应用一条全局策略，应用新的全局策略前必须通过执行undo ip global policy-based-route命令取消应用的全局策略。

如果设备上同时应用了全局策略和转发策略，则接口优先使用接口的转发策略处理报文；如果接口上的报文不匹配转发策略，则使用全局策略处理报文。

【举例】

# 对所有接口转发的报文应用策略aaa。

<Sysname> system-view

[Sysname] ip global policy-based-route aaa

【相关命令】

·     display ip policy-based-route global

1.1.26  ip local policy-based-route

ip local policy-based-route命令用来对本地报文应用策略。

undo ip local policy-based-route命令用来恢复缺省情况。

【命令】

ip local policy-based-route policy-name

undo ip local policy-based-route

【缺省情况】

未对本地报文应用策略。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

policy-name：策略名，唯一标识一个策略，为1～19个字符的字符串，区分大小写。该策略必须已经存在。

【使用指导】

应用场景

本命令用于指导转发设备本身产生的报文。

注意事项

配置本命令前，指定的策略路由必须已存在，否则本命令不生效。

对本地报文只能应用一个策略，应用新的策略前必须删除本地原来已经应用的策略。

对本地报文应用的策略将对本地产生的所有报文（除了本地发送给自己的报文）进行匹配。若无特殊需求，建议用户不要配置本地策略路由。

【举例】

# 对本地报文应用策略aaa。

<Sysname> system-view

[Sysname] ip local policy-based-route aaa

【相关命令】

·     display ip policy-based-route local

1.1.27  ip policy-based-route

ip policy-based-route命令用来对接口转发的报文应用策略。

undo ip policy-based-route命令用来恢复缺省情况。

【命令】

ip policy-based-route policy-name

undo ip policy-based-route

【缺省情况】

未对接口转发的报文应用策略。

【视图】

接口视图

【缺省用户角色】

network-admin

【参数】

policy-name：策略名，唯一标识一个策略，为1～19个字符的字符串，区分大小写。该策略必须已经存在。

【使用指导】

应用场景

本命令用于指导接口转发的报文。

注意事项

对接口转发的报文应用策略时，一个接口只能应用一个策略，应用新的策略前必须删除接口上原来已经应用的策略。

在某些组网中，需要在设备同一块单板上的多个接口上配置相同的策略路由，这时，每个接口上的策略路由会分别占用一份硬件资源，造成设备资源占用过大。为了解决这个问题，可以开启资源共享模式使应用同一策略路由的多个接口共享使用一份硬件资源。同一接口的相同方向只能配置一种共享QoS和ACL资源模式的应用，目前设备支持的应用包括报文过滤、QoS策略和策略路由。报文过滤和QoS策略的详细介绍，请分别参见“ACL和QoS命令参考”中的“ACL”和“QoS”。

对接口转发的报文应用策略时，一个接口只能配置一种模式的策略路由。如果需要配置其他模式的策略路由模式，需要先删除接口上已配置的策略路由。

【举例】

# 对接口GigabitEthernet0/0/1转发的报文应用策略aaa。‌

<Sysname> system-view

[Sysname] interface gigabitethernet 0/0/1

[Sysname-GigabitEthernet0/0/1] ip policy-based-route aaa

【相关命令】

·     display ip policy-based-route interface

1.1.28  ip policy-based-route vxlan-mode enable

ip policy-based-route vxlan-mode enable命令用来开启VXLAN模式的策略路由功能。

undo ip policy-based-route vxlan-mode enable命令用来关闭VXLAN模式的策略路由功能。

【命令】

ip policy-based-route vxlan-mode enable

undo ip policy-based-route vxlan-mode enable

【缺省情况】

VXLAN模式的策略路由功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

应用场景

缺省情况下，对VTEP设备连接本地站点的接口转发的报文应用策略路由时，无法指导报文进入VXLAN隧道。为了解决这个问题，用户需要在VTEP设备开启VXLAN模式的策略路由功能。

注意事项

建议用户需要在接口上应用策略前执行本功能，避免设备重复刷新接口表项，原因如下：

·     执行本命令切换模式会导致重复刷新所有接口表项，表项很多的情况下耗时较长。

·     重复刷新接口的顺序和配置顺序可能不相同，会导致命令执行前资源充足，执行后出现资源不足的情况。

【举例】

# 开启VXLAN模式的策略路由功能。

<Sysname> system-view

[Sysname] ip policy-based-route vxlan-mode enable

1.1.29  policy-based-route

policy-based-route命令用来创建策略节点，并进入策略节点视图。如果指定的策略节点已创建，则该命令直接用来进入该策略节点的视图。

undo policy-based-route命令用来删除已创建的策略或策略节点。

【命令】

policy-based-route policy-name [ deny | permit ] node node-number

undo policy-based-route policy-name [ deny | node node-number | permit ]

【缺省情况】

不存在策略节点。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

policy-name：策略名，唯一标识一个策略，为1～19个字符的字符串，区分大小写。

deny：指定策略节点的匹配模式为拒绝模式。

permit：指定策略节点的匹配模式为允许模式。缺省匹配模式为permit。

node node-number：策略节点编号。节点编号越小优先级越高，先对优先级高的节点进行匹配操作。取值范围为0～65535。

【使用指导】

删除策略之前，必须先取消该策略在所有接口或者本地上的应用，否则删除失败。

配置undo命令时，如果指定了策略节点，将删除指定的节点；如果指定了节点模式，将按模式删除策略内所有与该模式匹配的所有节点；如果两者都未指定，将删除整个策略。

【举例】

# 创建一个策略policy1，其节点序列号为10，匹配模式为permit，并进入策略节点视图。

<Sysname> system-view

[Sysname] policy-based-route policy1 permit node 10

[Sysname-pbr-policy1-10]

【相关命令】

·     display ip policy-based-route

1.1.30  reset ip policy-based-route statistics

reset ip policy-based-route statistics命令用来清除策略路由的统计信息。

【命令】

reset ip policy-based-route statistics [ policy policy-name ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

policy policy-name：清除指定策略的统计信息。policy-name表示策略名，唯一标识一个策略，为1～19个字符的字符串，区分大小写。如果未指定本参数，则清除所有策略路由的统计信息。

【举例】

# 清除所有配置策略的统计信息。

<Sysname> reset ip policy-based-route statistics