目  录

1 策略路由

1.1 策略路由配置命令

1.1.1 apply continue

1.1.2 apply default-next-hop

1.1.3 apply default-output-interface

1.1.4 apply ip-df

1.1.5 apply loadshare

1.1.6 apply next-hop

1.1.7 apply output-interface

1.1.8 apply precedence

1.1.9 description

1.1.10 display ip policy-based-route

1.1.11 display ip policy-based-route apply

1.1.12 display ip policy-based-route global

1.1.13 display ip policy-based-route interface

1.1.14 display ip policy-based-route local

1.1.15 display ip policy-based-route setup

1.1.16 if-match acl

1.1.17 if-match object-group

1.1.18 if-match packet-length

1.1.19 if-match qos-local-id

1.1.20 ip global policy-based-route

1.1.21 ip local policy-based-route

1.1.22 ip policy-based-route

1.1.23 ip policy-based-route apply

1.1.24 policy-based-route

1.1.25 reset ip policy-based-route statistics

1.1.26 snmp-agent trap enable policy-based-route

 

1 策略路由

1.1  策略路由配置命令

1.1.1  apply continue

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

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

【命令】

apply continue

undo apply continue

【缺省情况】

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

【视图】

策略节点视图

【缺省用户角色】

network-admin

【使用指导】

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

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

【举例】

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

<Sysname> system-view

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

[Sysname-pbr-aa-11] apply continue

1.1.2  apply default-next-hop

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

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

【命令】

apply default-next-hop { ip-address [ direct ] }&<1-4>

undo apply default-next-hop [ ip-address&<1-4> ]

【缺省情况】

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

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

ip-address：缺省下一跳的IP地址。

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

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

【使用指导】

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

配置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.3  apply default-output-interface

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

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

【命令】

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

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

【缺省情况】

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

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

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

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

【使用指导】

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

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

配置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.4  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.5  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.6  apply next-hop

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

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

【命令】

apply next-hop  { ip-address [ direct ] [ weight weight-value ] }&<1-4>

undo apply next-hop [  ip-address&<1-4> ]

【缺省情况】

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

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

ip-address：下一跳IP地址。

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

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

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

【使用指导】

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

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

【举例】

# 设置报文的直连下一跳为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.7  apply output-interface

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

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

【命令】

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

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

【缺省情况】

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

【视图】

策略节点视图

【缺省用户角色】

network-admin

【参数】

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

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

【使用指导】

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

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

配置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.8  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.9  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.10  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.11  display ip policy-based-route apply

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

【命令】

display ip policy-based-route apply vlan-interface interface-number

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

【使用指导】

本命令显示的是通过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.12  display ip policy-based-route global

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

【命令】

display ip policy-based-route global

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

【举例】

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

<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	为匹配的报文指定出接口 如果显示信息中存在(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.13  display ip policy-based-route interface

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

【命令】

display ip policy-based-route interface interface-type interface-number

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

【举例】

# 显示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

  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	接口下转发策略路由的配置信息和统计信息
Policy name	策略名
node 0 deny node 2 permit	节点的匹配模式为允许（permit）/拒绝（deny）
if-match acl	满足ACL的报文被匹配
apply next-hop	为匹配的报文指定下一跳
apply output-interface	为匹配的报文指定出接口。括号中显示接口的状态：up、down、inactive。接口不在位时，显示inactive；接口网络层down时，显示down
Matches	节点匹配成功的次数，取值为“N/A”表示设备不支持统计匹配次数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段
bytes	节点匹配成功的字节数，取值为“N/A”表示设备不支持统计匹配字节数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段
Total matches	策略所有节点匹配成功的次数，取值为“N/A”表示设备不支持统计匹配次数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段
total bytes	策略所有节点匹配成功的字节数，取值为“N/A”表示设备不支持统计匹配字节数；如果策略节点统计匹配成功的次数和字节数的功能被关闭，则不显示此字段

‌

【相关命令】

·     ip policy-based-route

1.1.14  display ip policy-based-route local

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

【命令】

display ip policy-based-route local

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

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

<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.15  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                      Egress   Tunnel1

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.16  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中，ACL规则是否支持vpn-instance参数，以及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.17  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.18  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.19  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.20  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.21  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.22  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.23  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-type interface-number1 [ to interface-type interface-number2 ] }&<1-8>。其中，interface-type为接口类型，interface-number为接口编号。接口类型是VLAN接口。&<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.24  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.25  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

1.1.26  snmp-agent trap enable policy-based-route

snmp-agent trap enable policy-based-route命令用来开启下一跳失效告警功能。

undo snmp-agent trap enable policy-based-route命令用来关闭下一跳失效告警功能。

【命令】

snmp-agent trap enable policy-based-route

undo snmp-agent trap enable policy-based-route

【缺省情况】

下一跳失效告警功能处于开启状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

开启策略路由模块的告警功能后，当下一跳的状态由有效变为无效时，该模块会生成包含下一跳地址的告警信息，用于报告该模块的重要事件。生成的告警信息将发送到设备的SNMP模块，通过设置SNMP中告警信息的发送参数，来决定告警信息输出的相关属性。

有关告警信息的详细介绍，请参见“网络管理和监控配置指导”中的“SNMP”。

【举例】

# 开启下一跳失效告警功能。

<Sysname> system-view

[Sysname] snmp-agent trap enable policy-based-route