所选语种没有对应资源，请选择：
企业业务网站
选择区域/语言
Huawei Global - English
技术支持 文档中心
S1700, S2720, S5700, S6700 V200R019C10 NETCONF YANG API参考

本文档介绍了设备支持的NETCONF YANG API功能，包括数据模型及相关示例。

评分并提供意见反馈 :
华为采用机器翻译与人工审校相结合的方式将此文档翻译成不同语言，希望能帮助您更容易理解此文档的内容。 请注意：即使是最好的机器翻译，其准确度也不及专业翻译人员的水平。 华为对于翻译的准确性不承担任何责任，并建议您参考英文文档（已提供链接）。
路由策略

路由策略

本章节介绍路由策略的配置模型，以及配置的XML报文示例。

数据模型

路由策略对应的配置模型文件名为huawei-route-policy.yang。

表2-318 路由策略

节点

说明

取值范围

备注

/huawei-route-policy:prefix-lists/prefix-list/prefix-list-name

指定IP地址前缀列表的名称。

字符串类型，取值范围是1～169，不支持空格，区分大小写。当输入的字符串两端使用双引号时，可在字符串中输入空格。

NA

/huawei-route-policy:prefix-lists/prefix-list/prefixes/prefix/seq-nr

指定本匹配项在IP地址前缀列表中的序号。

整数形式，取值范围是1～4294967295。一个IP地址前缀列表最多支持配置65535个序号。

NA

/huawei-route-policy:prefix-lists/prefix-list/prefixes/prefix/prefix-filter/match-mode

指定IP地址前缀列表的匹配模式。
枚举型，具体取值如下：
  • permit：允许
  • deny：拒绝

NA

/huawei-route-policy:prefix-lists/prefix-list/prefixes/prefix/prefix-filter/ip-address

指定IP地址前缀列表的IP地址和掩码长度。
格式为ipv4-address/mask-length：
  • ipv4-address表示IP地址，为点分十进制形式。
  • mask-length表示掩码长度，为整数形式，取值范围是0～32。

NA

/huawei-route-policy:prefix-lists/prefix-list/prefixes/prefix/prefix-filter/greater-equal

指定掩码长度匹配范围的下限。

整数形式，取值范围为0～32。
  • 该节点的取值限制为：mask-length <= greater-equal-value <= less-equal-value <= 32。
  • 如果只配置了greater-equal，则掩码长度范围为greater-equal-value～32。

/huawei-route-policy:prefix-lists/prefix-list/prefixes/prefix/prefix-filter/less-equal

指定掩码长度匹配范围的上限。

整数形式，取值范围为0～32。
  • 该节点的取值限制为：mask-length <= greater-equal-value <= less-equal-value <= 32。
  • 如果只配置了less-equal，则掩码长度范围为mask-length～less-equal-value。

/huawei-route-policy:prefix-lists/prefix-list/prefixes/prefix/prefix-filter/match-network

指定匹配网络地址。
布尔型，具体取值如下：
  • true：匹配
  • false：不匹配
缺省值是false。

NA

/huawei-route-policy:route-policys/route-policy/name

指定路由策略名称。

字符串形式，区分大小写，不支持空格，长度范围是1～40。当输入的字符串两端使用双引号时，可在字符串中输入空格。

NA

/huawei-route-policy:route-policys/route-policy/nodes/node/node-index

指定路由策略的节点号。

整数形式，取值范围是0～65535。

NA

/huawei-route-policy:route-policys/route-policy/nodes/node/match-mode

指定路由策略节点的匹配模式。
枚举型，具体取值如下：
  • permit：允许
  • deny：拒绝

NA

/huawei-route-policy:route-policys/route-policy/nodes/node/match-condition/destination/destination-mode/prefix-name/prefix-name

指定路由策略匹配的IP地址前缀列表名称。

字符串形式，取值范围是1～169，不支持空格，区分大小写。当输入的字符串两端使用双引号时，可在字符串中输入空格。
  • 配置该节点前，必须先配置

    /huawei-route-policy:prefix-lists/prefix-list/prefix-list-name

    节点。

  • 对于同一个路由策略节点，该节点与/huawei-route-policy:route-policys/route-policy/nodes/node/match-condition/destination/destination-mode/acl-name-or-num/acl-name-or-num节点同时配置时，后配置的会覆盖先配置的。

/huawei-route-policy:route-policys/route-policy/nodes/node/match-condition/destination/destination-mode/acl-name-or-num/acl-name-or-num

指定路由策略匹配的ACL编号或名称。
  • ACL编号：整数形式，取值范围是2000～2999。
  • ACL名称：字符串形式，不支持空格，区分大小写，长度范围是1～64，以英文字母开始。

对于同一个路由策略节点，该节点与/huawei-route-policy:route-policys/route-policy/nodes/node/match-condition/destination/destination-mode/prefix-name/prefix-name节点同时配置时，后配置的会覆盖先配置的。

/huawei-route-policy:route-policys/route-policy/nodes/node/apply-action/apply-cost/cost-value

指定路由策略中改变路由的开销值。

整数形式，取值范围是0～4294967295。

NA

/huawei-route-policy:route-policys/route-policy/nodes/node/apply-action/applay-tag-value

指定路由策略中改变路由信息的标记值。

整数形式，取值范围是0～4294967295。

NA

/huawei-route-policy:route-policys/route-policy/nodes/node/apply-action/preference

指定路由策略中改变路由的优先级。

整数形式，取值范围1～255。

NA

配置路由策略示例

本章节主要介绍通过edit-config:merge方法配置路由策略。

表2-319 配置路由策略

操作

XPATH

edit-config:merge
  • /huawei-route-policy:prefix-lists/prefix-list/prefix-list-name
  • /huawei-route-policy:prefix-lists/prefix-list/prefixes/prefix/seq-nr
  • /huawei-route-policy:prefix-lists/prefix-list/prefixes/prefix/prefix-filter/match-mode
  • /huawei-route-policy:prefix-lists/prefix-list/prefixes/prefix/prefix-filter/ip-address
  • /huawei-route-policy:prefix-lists/prefix-list/prefixes/prefix/prefix-filter/greater-equal
  • /huawei-route-policy:prefix-lists/prefix-list/prefixes/prefix/prefix-filter/less-equal
  • /huawei-route-policy:prefix-lists/prefix-list/prefixes/prefix/prefix-filter/match-network
  • /huawei-route-policy:route-policys/route-policy/name
  • /huawei-route-policy:route-policys/route-policy/nodes/node/node-index
  • /huawei-route-policy:route-policys/route-policy/nodes/node/match-mode
  • /huawei-route-policy:route-policys/route-policy/nodes/node/match-condition/destination/destination-mode/prefix-name/prefix-name
  • /huawei-route-policy:route-policys/route-policy/nodes/node/match-condition/destination/destination-mode/acl-name-or-num/acl-name-or-num
  • /huawei-route-policy:route-policys/route-policy/nodes/node/apply-action/apply-cost/cost-value
  • /huawei-route-policy:route-policys/route-policy/nodes/node/apply-action/applay-tag-value
  • /huawei-route-policy:route-policys/route-policy/nodes/node/apply-action/preference

数据需求1：配置IP地址前缀列表

项目

数据

 描述

指定IP地址前缀列表的名称

test

-

指定本匹配项在IP地址前缀列表中的序号

10

-

指定IP地址前缀列表的匹配模式

permit

-

指定IP地址前缀列表的IP地址和掩码长度

0.0.0.0/16

-

指定掩码长度匹配范围的下限

18

-

指定掩码长度匹配范围的上限

25

-

指定匹配网络地址

true

-

请求示例

<?xml version="1.0" encoding="utf-8"?>
<rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="1">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
      <hw-route-policy:prefix-lists xmlns:hw-route-policy="urn:huawei:params:xml:ns:yang:huawei-route-policy">
        <hw-route-policy:prefix-list>
          <hw-route-policy:prefix-list-name>test</hw-route-policy:prefix-list-name>
          <hw-route-policy:prefixes>
            <hw-route-policy:prefix>
              <hw-route-policy:seq-nr>10</hw-route-policy:seq-nr>
              <hw-route-policy:prefix-filter>
                <hw-route-policy:match-mode>permit</hw-route-policy:match-mode>
                <hw-route-policy:ip-address>0.0.0.0/16</hw-route-policy:ip-address>
                <hw-route-policy:greater-equal>18</hw-route-policy:greater-equal>
                <hw-route-policy:less-equal>25</hw-route-policy:less-equal>
                <hw-route-policy:match-network>true</hw-route-policy:match-network>
              </hw-route-policy:prefix-filter>
            </hw-route-policy:prefix>
          </hw-route-policy:prefixes>
        </hw-route-policy:prefix-list>
      </hw-route-policy:prefix-lists>
    </config>
  </edit-config>
</rpc>

响应示例

# 配置成功响应示例

##### Ok Reply or Operation Successful #####
<?xml version="1.0" encoding="UTF-8"?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="1">
  <ok/>
</rpc-reply>

# 配置失败响应示例

##### Error Reply or Operation Failed #####
<?xml version="1.0" encoding="utf-8"?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="1">
  <rpc-error>
    <error-app-tag>-1</error-app-tag>
    <error-message> The specified IP address must be zero.</error-message>
    <error-info>Error on node /huawei-route-policy:prefix-lists/prefix-list[prefix-list-name="test"]/prefixes/prefix[seq-nr="10"]</error-info>
  </rpc-error>
</rpc-reply>

数据需求2：配置路由策略基于IP地址前缀列表的匹配规则

项目

数据

 描述

指定路由策略名称

policy

-

指定路由策略的节点号

5

-

指定路由策略节点的匹配模式

permit

-

指定路由策略匹配的IP地址前缀列表名称

test

-

请求示例

<?xml version="1.0" encoding="utf-8"?>
<rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="2">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
      <hw-route-policy:route-policys xmlns:hw-route-policy="urn:huawei:params:xml:ns:yang:huawei-route-policy">
        <hw-route-policy:route-policy>
          <hw-route-policy:name>policy</hw-route-policy:name>
          <hw-route-policy:nodes>
            <hw-route-policy:node>
              <hw-route-policy:node-index>5</hw-route-policy:node-index>
               <hw-route-policy:match-mode>permit</hw-route-policy:match-mode>
              <hw-route-policy:match-condition>
                <hw-route-policy:destination>
                  <hw-route-policy:prefix-name>test</hw-route-policy:prefix-name>
                </hw-route-policy:destination>
              </hw-route-policy:match-condition>
            </hw-route-policy:node>
          </hw-route-policy:nodes>
        </hw-route-policy:route-policy>
      </hw-route-policy:route-policys>
    </config>
  </edit-config>
</rpc>

响应示例

# 配置成功响应示例

##### Ok Reply or Operation Successful #####
<?xml version="1.0" encoding="UTF-8"?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="2">
  <ok/>
</rpc-reply>

# 配置失败响应示例

##### Error Reply or Operation Failed #####
<?xml version="1.0" encoding="utf-8"?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="2">
  <rpc-error>
    <error-app-tag>-1</error-app-tag>
    <error-message> The specified ip-prefix does not exist.</error-message>
    <error-info>Error on node /huawei-route-policy:route-policys/route-policy[name="policy"]/nodes/node[node-index="5"]/match-condition/destination</error-info>
  </rpc-error>
</rpc-reply>

数据需求3：配置路由策略基于ACL的匹配规则

项目

数据

 描述

指定路由策略名称

policy

-

指定路由策略的节点号

10

-

指定路由策略节点的匹配模式

permit

-

指定路由策略匹配的ACL的编号

2000

-

请求示例

<?xml version="1.0" encoding="utf-8"?>
<rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="3">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
      <hw-route-policy:route-policys xmlns:hw-route-policy="urn:huawei:params:xml:ns:yang:huawei-route-policy">
        <hw-route-policy:route-policy>
          <hw-route-policy:name>policy</hw-route-policy:name>
          <hw-route-policy:nodes>
            <hw-route-policy:node>
              <hw-route-policy:node-index>10</hw-route-policy:node-index>
              <hw-route-policy:match-mode>permit</hw-route-policy:match-mode>
              <hw-route-policy:match-condition>
                <hw-route-policy:destination>
                  <hw-route-policy:acl-name-or-num>2000</hw-route-policy:acl-name-or-num>
                </hw-route-policy:destination>
              </hw-route-policy:match-condition>
            </hw-route-policy:node>
          </hw-route-policy:nodes>
        </hw-route-policy:route-policy>
      </hw-route-policy:route-policys>
    </config>
  </edit-config>
</rpc>

响应示例

# 配置成功响应示例

##### Ok Reply or Operation Successful #####
<?xml version="1.0" encoding="UTF-8"?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="3">
  <ok/>
</rpc-reply>

# 配置失败响应示例

##### Error Reply or Operation Failed #####
<?xml version="1.0" encoding="utf-8"?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="3">
  <rpc-error>
    <error-app-tag>-1</error-app-tag>
    <error-message>The configuration/operation does not support.</error-message>
    <error-info>Error on node /huawei-route-policy:route-policys/route-policy[name="policy"]/nodes/node[node-index="10"]/match-condition/destination</error-info>
  </rpc-error>
</rpc-reply>

数据需求4：改变匹配路由策略的路由的属性

项目

数据

 描述

指定路由策略名称

policy

-

指定路由策略的节点号

5

-

指定路由策略中改变路由的开销值

4

-

指定路由策略中改变路由信息的标记值

5

-

指定路由策略中改变路由的优先级

6

-

请求示例

<?xml version="1.0" encoding="utf-8"?>
<rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="4">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
      <hw-route-policy:route-policys xmlns:hw-route-policy="urn:huawei:params:xml:ns:yang:huawei-route-policy">
        <hw-route-policy:route-policy>
          <hw-route-policy:name>policy</hw-route-policy:name>
          <hw-route-policy:nodes>
            <hw-route-policy:node>
              <hw-route-policy:node-index>5</hw-route-policy:node-index>
              <hw-route-policy:match-mode>permit</hw-route-policy:match-mode>
              <hw-route-policy:apply-action>
                <hw-route-policy:apply-cost>
                  <hw-route-policy:cost-value>4</hw-route-policy:cost-value>
                </hw-route-policy:apply-cost>
                <hw-route-policy:apply-tag-value>5</hw-route-policy:apply-tag-value>
                <hw-route-policy:preference>6</hw-route-policy:preference>
              </hw-route-policy:apply-action>
            </hw-route-policy:node>
          </hw-route-policy:nodes>
        </hw-route-policy:route-policy>
      </hw-route-policy:route-policys>
    </config>
  </edit-config>
</rpc>

响应示例

# 配置成功响应示例

##### Ok Reply or Operation Successful #####
<?xml version="1.0" encoding="UTF-8"?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="4">
  <ok/>
</rpc-reply>

# 配置失败响应示例

##### Error Reply or Operation Failed #####
<?xml version="1.0" encoding="utf-8"?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="4">
  <rpc-error>
    <error-type>application</error-type>
    <error-tag>operation-failed</error-tag>
    <error-severity>error</error-severity>
    <error-path>/huawei-route-policy:route-policys/route-policy[name="policy"]/nodes/node[node-index="5"]/apply-action/preference</error-path>
    <error-message>parse rpc config error.(Value "256" does not satisfy the constraint "1..255" (range, length, or pattern).).</error-message>
  </rpc-error>
</rpc-reply>
翻译
English
下载文档
更新时间：2022-05-25

文档编号：EDOC1100127118

浏览量：14943

下载量：1050

平均得分:
本文档适用于这些产品

相关版本

相关文档

数字签名

数字签名验证工具
分享
上一页 下一页
华为亿家APP下载 华为亿家APP下载

版权所有 © 华为技术有限公司 1998-2022。 保留一切权利。粤A2-20044005号

您正离开华为站点，前往：