目  录

1 策略路由

1.1 策略路由配置命令

1.1.1 apply access-vpn vpn-instance

1.1.2 apply continue

1.1.3 apply default-next-hop

1.1.4 apply default-output-interface

1.1.5 apply ip-df

1.1.6 apply loadshare

1.1.7 apply next-hop

1.1.8 apply output-interface

1.1.9 apply precedence

1.1.10 apply service-chain

1.1.11 apply statistics

1.1.12 description

1.1.13 display ip policy-based-route

1.1.14 display ip policy-based-route apply

1.1.15 display ip policy-based-route global

1.1.16 display ip policy-based-route interface

1.1.17 display ip policy-based-route local

1.1.18 display ip policy-based-route setup

1.1.19 if-match acl

1.1.20 if-match app-group

1.1.21 if-match object-group

1.1.22 if-match packet-length

1.1.23 if-match qos-local-id

1.1.24 if-match service-chain

1.1.25 ip global policy-based-route

1.1.26 ip ignore policy-based-route dest-local enable

1.1.27 ip local policy-based-route

1.1.28 ip policy-based-route

1.1.29 ip policy-based-route apply

1.1.30 policy-based-route

1.1.31 reset ip policy-based-route statistics

 

1 策略路由

1.1  策略路由配置命令

1.1.1  apply access-vpn vpn-instance

apply access-vpn vpn-instance命令用来设置报文在指定VPN实例中进行转发。

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

【命令】

apply access-vpn vpn-instance vpn-instance-name&<1-4>

undo apply access-vpn vpn-instance [ vpn-instance-name&<1-4> ]

【缺省情况】

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

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

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

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

【使用指导】

每个节点最多可以配置6个VPN实例。当满足匹配规则后，将根据第一个可用的VPN实例转发表进行转发。

配置undo命令时，如果指定了VPN实例名，将取消报文在该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

1.1.2  apply continue

apply continue命令用来设置匹配成功的当前节点指定转发路径失败后，继续进行后续节点的处理。

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

【命令】

apply continue

undo apply continue

【缺省情况】

匹配成功的当前节点指定转发路径失败后，不再进行下一节点的匹配。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【使用指导】

本命令仅在策略节点的匹配模式为permit时生效。

在配置了该命令后，如果当前节点中未配置影响报文转发路径的apply子句（apply access-vpn vpn-instance、apply next-hop、apply output-interface、apply default-next-hop和apply default-output-interface），或者配置了这些子句中的一个或多个，但配置的子句都失效（下一跳不可达、出接口down或者报文在指定VPN内转发失败）且查找普通路由表也转发失败时，会进行下一节点的处理。

【举例】

# 设置匹配成功的当前节点转发失败后继续进行后续节点的处理。

<Sysname> system-view

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

[Sysname-pbr-aa-11] apply continue

1.1.3  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次。但每个节点最多可以配置16个缺省下一跳。

【使用指导】

用户可以同时配置多个缺省下一跳（通过一次或多次配置本命令实现），起到主备或负载分担的作用。

配置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.4  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次。但每个节点最多可以配置16个缺省出接口。

【使用指导】

用户可以同时配置多个缺省出接口（通过一次或多次配置本命令实现），起到主备或负载分担的作用。

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

【举例】

# 设置报文的缺省出接口为VLAN接口2。

<Sysname> system-view

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

[Sysname-pbr-aa-11] apply default-output-interface vlan-interface 2

【相关命令】

·     apply loadshare

1.1.5  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.6  apply loadshare

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

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

【命令】

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

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

【缺省情况】

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

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

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

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

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

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

【使用指导】

使用场景

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

工作机制

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

【举例】

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

<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 vlan-interface 1 vlan-interface 2

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

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

<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 vlan-interface 1 vlan-interface 2

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

【相关命令】

·     apply default-next-hop

·     apply default-output-interface

·     apply next-hop

·     apply output-interface

1.1.7  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 [ 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次。但每个节点最多可以配置16个下一跳。

【使用指导】

用户可以同时配置多个下一跳（通过一次或多次配置本命令实现），起到主备或负载分担的作用。

配置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.8  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次。但每个节点最多可以配置16个出接口。

【使用指导】

用户可以同时配置多个出接口（通过一次或多次配置本命令实现），起到主备或负载分担的作用。

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

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

【举例】

# 对已经匹配的IP报文指定出接口为VLAN接口2。

<Sysname> system-view

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

[Sysname-pbr-aa-11] apply output-interface vlan-interface 2

【相关命令】

·     apply loadshare

1.1.9  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.10  apply service-chain

apply service-chain命令用来设置报文的服务链规则。

undo apply service-chain命令用来恢复缺省情况。

【命令】

apply service-chain path-id service-path-id [ path-index service-path-index ]

undo apply service-chain

【缺省情况】

未设置报文的服务链规则。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

path-id service-path-id：服务链编号，取值范围为1～16777215。服务链编号用来唯一确定一条服务链。

path-index service-path-index：服务链节点索引，取值范围1～255。本参数用来区分一个服务链节点收到来自不同设备的报文。如果只有一台设备向某个服务链节点发送报文，则不需要配置本参数。

【举例】

# 设置报文中的服务链编号为1，服务链节点索引为10。

<Sysname> system-view

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

[Sysname-pbr-aa-5] apply service-chain path-id 1 path-index 10

1.1.11  apply statistics

apply statistics命令用来配置策略节点统计匹配成功的次数和字节数。

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

【命令】

apply statistics

undo apply statistics

【缺省情况】

未配置策略节点统计匹配成功的次数。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【使用指导】

开启本功能后，管理员可以通过display命令查看当前匹配成功的总次数和字节总数。在某些配置较低的设备上，为了节省设备的硬件资源，建议执行undo apply statistics命令关闭策略节点统计的统计功能。

策略节点中只要配置了此动作，就一定会执行。

【举例】

# 配置策略节点统计匹配成功的次数和字节数。

<Sysname> system-view

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

[Sysname-pbr-aa-11] apply statistics

1.1.12  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.13  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

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

字段	描述
Policy name	策略名
node 1 permit	节点1的匹配模式为允许
if-match acl	满足ACL的报文被匹配
apply next-hop	为匹配的报文指定下一跳

 

【相关命令】

·     policy-based-route

1.1.14  display ip policy-based-route apply

display ip policy-based-route apply命令用来显示VLAN接口上应用的策略路由及其统计信息。

【命令】

display ip policy-based-route apply vlan-interface interface-number [ slot slot-number ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

vlan-interface interface-number：显示指定VLAN接口上应用的策略路由及其统计信息。

slot slot-number：显示指定成员设备上应用的策略路由及其统计信息。slot-number表示设备在IRF中的成员编号。如果未指定本参数，将显示主设备上应用的策略路由及其统计信息。

cpu cpu-number：显示指定CPU上应用的策略路由及其统计信息，cpu-number表示CPU的编号。只有指定的slot支持多CPU时，才能配置该参数。

【使用指导】

本命令显示的是通过ip policy-based-route apply命令配置的策略路由及其统计信息。VLAN接口视图下配置的策略路由信息是通过命令行display ip policy-based-route interface查看。

【举例】

# 显示VLAN接口100上应用的策略路由及其统计信息。

<Sysname> display ip policy-based-route apply vlan-interface 100

Policy-based routing information for Vlan-interface 100:

Policy name: aaa

  node 2 permit:

    if-match acl 3000

    apply next-hop 2.2.2.2

  Matches: 0, bytes: 0

Total matches: 0, total bytes: 0

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

字段	描述
Policy-based routing information for Vlan-interface	VLAN接口的策略路由配置信息和统计信息
Policy name	策略名
node 2 permit	节点的匹配模式为允许（permit）
if-match acl	满足ACL的报文被匹配
apply next-hop	为匹配的报文指定下一跳
Matches	节点匹配成功的次数，取值为“N/A”表示设备不支持统计匹配次数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段
bytes	节点匹配成功的字节数，取值为“N/A”表示设备不支持统计匹配字节数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段
Total matches	策略所有节点匹配成功的次数，取值为“N/A”表示设备不支持统计匹配次数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段
total bytes	策略所有节点匹配成功的字节数，取值为“N/A”表示设备不支持统计匹配字节数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段

 

【相关命令】

·     ip policy-based-route apply

1.1.15  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表示设备在IRF中的成员编号。如果未指定本参数，将显示主设备上全局策略路由的配置信息和统计信息。

【举例】

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

<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.16  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表示设备在IRF中的成员编号。如果未指定本参数，将显示主设备上的信息。

【举例】

# 显示VLAN接口2下转发策略路由的配置信息和统计信息。

<Sysname> display ip policy-based-route interface vlan-interface 2

Policy based routing information for interface Vlan-interface2:

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 Vlan-interface3 track 1

    apply output-interface Vlan-interface4 track 2

  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	接口下转发策略路由的配置信息和统计信息 如果显示信息中存在(failed)，则表示策略下发驱动失败。只有在接口上删除转发策略路由，再重新创建转发策略路由，下发才可能成功 对于设备上的全局口（如VLAN接口）和物理口，只有指定slot后，才会显示括号内的信息
Policy name	策略名
node 0 deny node 2 permit	节点的匹配模式为允许（permit）/拒绝（deny） 如果显示信息中存在(not support)，则表示设备不支持该节点设置的规则 如果显示信息中存在(no resource)，则表示设备的ACL等资源不足，为该节点分配ACL等资源失败 对于设备上的全局口（如VLAN接口）和物理口，只有指定slot后，才会显示括号内的信息
if-match acl	满足ACL的报文被匹配
apply next-hop	为匹配的报文指定下一跳
apply output-interface XXXX	为匹配的报文指定出接口。括号中显示接口的状态：up、down、inactive。接口不在位时，显示inactive；接口网络层down时，显示down
Matches	节点匹配成功的次数，取值为“N/A”表示设备不支持统计匹配次数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段 如果显示信息中存在(no statistics resource)，则表示统计资源不足 对于设备上的全局口（如VLAN接口）和物理口，只有指定slot后，才会显示括号内的信息
bytes	节点匹配成功的字节数，取值为“N/A”表示设备不支持统计匹配字节数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段
Total matches	策略所有节点匹配成功的次数，取值为“N/A”表示设备不支持统计匹配次数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段
total bytes	策略所有节点匹配成功的字节数，取值为“N/A”表示设备不支持统计匹配字节数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段

‌

【相关命令】

·     ip policy-based-route

1.1.17  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表示设备在IRF中的成员编号。如果未指定本参数，将显示主设备上本地策略路由的配置信息和统计信息。

【举例】

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

<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

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	为匹配的报文指定下一跳
Matches	节点匹配成功的次数，取值为“N/A”表示设备不支持统计匹配次数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段
bytes	节点匹配成功的字节数，取值为“N/A”表示设备不支持统计匹配字节数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段
Total matches	策略所有节点匹配成功的次数，取值为“N/A”表示设备不支持统计匹配次数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段
total bytes	策略所有节点匹配成功的字节数，取值为“N/A”表示设备不支持统计匹配字节数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段

 

【相关命令】

·     ip local policy-based-route

1.1.18  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

pr01                     Forward  Vlan-interface2

aaa                      Local    N/A

pr01                     Global   N/A

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

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

 

1.1.19  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：访问控制列表号，acl-number的取值范围及其代表的ACL类型如下：

·     2000～2999：表示基本ACL。

·     3000～3999：表示高级ACL。

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

【使用指导】

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

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

·     策略路由引用ACL时，若某条rule规则中指定了vpn-instance，则该ACL不生效。不指定vpn-instance参数，表示该条规则对公网和私网报文都有效。

【举例】

# 设置满足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.20  if-match app-group

if-match app-group命令用来设置应用组匹配规则。

undo if-match app-group命令用来删除应用组匹配规则。

【命令】

if-match app-group app-group-name&<1-6>

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

【缺省情况】

未设置应用组匹配规则。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

app-group-name：应用组名，为1～63个字符的字符串，不区分大小写，可以为数字、字母、连字符和下划线，不允许为“Invalid”、“other”或系统预定义应用组的名称。

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

【使用指导】

应用组匹配规则只对转发策略路由生效，对本地策略路由不生效。

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

【举例】

# 设置应用组匹配规则test。

<Sysname> system-view

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

[Sysname-pbr-aa-11] if-match app-group test

1.1.21  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次。

【使用指导】

执行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.22  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.23  if-match qos-local-id

if-match qos-local-id命令用来设置IP报文QoS本地ID值匹配规则。

undo if-match qos-local-id命令用来恢复缺省情况。

【命令】

if-match qos-local-id local-id-value

undo if-match qos-local-id

【缺省情况】

未设置IP报文QoS本地ID匹配规则。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

local-id-value：QoS本地ID值，取值范围为1～4095。

【举例】

# 设置QoS本地ID值为200的报文被匹配。

<Sysname> system-view

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

[Sysname-pbr-aa-11] if-match qos-local-id 200

1.1.24  if-match service-chain

if-match service-chain命令用来设置服务链匹配规则。

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

【命令】

if-match service-chain { path-id service-path-id [ path-index service-path-index ] }&<1-2>

undo if-match service-chain [ [ path-id service-path-id ]&<1-2> ]

【缺省情况】

未配置服务链匹配规则。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

path-id service-path-id：服务链编号，取值范围为1～16777215。服务链编号用来唯一确定一条服务链。

path-index service-path-index：服务链节点索引，取值范围1～255。本参数用来区分一个服务链节点收到的来自不同设备的报文。如果只有一台设备向某个服务链节点发送报文，则不需要配置本参数。

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

【举例】

# 设置服务链匹配规则，匹配服务链编号为1，服务链节点索引为10的报文。

<Sysname> system-view

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

[Sysname-pbr-aa-5] if-match service-chain path-id 1 path-index 10

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 ignore policy-based-route dest-local enable

ip ignore policy-based-route dest-local enable命令用来配置策略路由忽略目的地址为当前接口IPv4地址的报文。

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

【命令】

ip ignore policy-based-route dest-local enable

undo ip ignore policy-based-route dest-local enable

【缺省情况】

未配置策略路由忽略目的地址为当前接口IPv4地址的报文。

【视图】

接口视图

【缺省用户角色】

network-admin

【使用指导】

对于硬件转发的设备，当设备收到某些目的地址为本设备的IP地址的报文后，如果策略路由匹配该报文，则会在报文上送CPU前先执行策略节点的动作。在接口视图下配置本命令后，如果设备接收报文的目的地址为该接口的任意一个IPv4地址（主地址或从地址），则会忽略策略路由的配置，直接上送CPU处理。通过配置本命令，可以避免策略路由将发送给本地的报文错误地转发给其他设备。

【举例】

# 配置策略路由忽略目的地址为VLAN接口2的IPv4地址的报文。

<Sysname> system-view

[Sysname] interface vlan-interface 2

[Sysname-Vlan-interface2] ip ignore policy-based-route dest-local enable

1.1.27  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.28  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个字符的字符串，区分大小写。该策略必须已经存在。

【举例】

# 对VLAN接口2转发的报文应用策略aaa。

<Sysname> system-view

[Sysname] interface vlan-interface 2

[Sysname-Vlan-interface2] ip policy-based-route aaa

【相关命令】

·     display ip policy-based-route interface

1.1.29  ip policy-based-route apply

ip policy-based-route apply命令用来为设备上指定范围的VLAN接口应用策略路由。

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

【命令】

ip policy-based-route policy-name apply vlan-interface interface-list

undo ip policy-based-route policy-name apply [ vlan-interface interface-list ]

【缺省情况】

VLAN接口上未应用策略路由。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

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

vlan-interface interface-list：VLAN接口列表，表示方式为interface-list = { interface-number1 [ to interface-number2 ] }&<1-8>。其中interface-number为接口编号。&<1-8>表示前面的参数最多可以输入8次。

【使用指导】

可以在不同范围的VLAN接口上多次配置策略路由命令。

不能为同一个接口指定不同的策略，且同一VLAN接口只能选择在VLAN接口视图指定或者通过指定范围的VLAN接口上配置策略路由的方式指定，两种方式不能同时配置。

本命令与接口批量配置视图下应用策略路由的区别是：

·     接口批量配置视图下的配置是逐个在接口视图下发配置，系统会为每个接口分配独立的硬件表项；

·     使用本命令配置时会把配置了同一策略的VLAN接口一次下发硬件，可以减少硬件表项的数目，从而节省系统资源。

·     在VLAN或VLAN接口未创建时，可以通过本命令在该接口上应用策略路由。

【举例】

# 为VLAN接口100到VLAN接口200范围的所有VLAN接口配置策略路由。

<Sysname> system-view

[Sysname] ip policy-based-route aaa apply vlan-interface 100 to 200

【相关命令】

·     display ip policy-based-route apply

1.1.30  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～255。

【使用指导】

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

配置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.31  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