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

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

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

IPv4静态路由管理

本章节介绍IPv4静态路由管理的配置模型，以及配置的XML报文举例说明。

数据模型

IPv4静态路由管理的对应配置模型文件名为ietf-routing.yang、ietf-ipv4-unicast-routing、huawei-ipv4-static-route、huawei-route-protection。

表2-294 IPv4静态路由管理

节点

说明

取值范围

备注

/ietf-routing:routing/routing-instance/name

指定路由实例名称。
字符串形式，不支持空格，区分大小写，长度范围是1～31。当输入的字符串两端使用双引号时，可在字符串中输入空格。
  • 在公网上配置静态路由时：该节点取值只能是default-routing-instance。
  • 在VPN实例中配置静态路由时：必须是已存在的VPN实例名称。

NA

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/type

指定路由类型。

当前仅支持静态路由类型：static。

NA

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/name

指定路由协议实例名称。

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

NA

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/ietf-ipv4-unicast-routing:ipv4/route/destination-prefix

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

NA

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/ietf-ipv4-unicast-routing:ipv4/route/description

指定IPv4静态路由描述信息。

字符串格式，支持空格，不支持符号“？”，区分大小写，长度范围是1～80。

NA

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/ietf-ipv4-unicast-routing:ipv4/route/next-hop/next-hop-address

指定下一跳IPv4地址。

点分十进制格式。

NA

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/ietf-ipv4-unicast-routing:ipv4/route/next-hop/outgoing-interface

指定下一跳出接口。

字符串形式，格式为interface-typeinterface-number，其中interface-type表示接口类型，interface-number表示接口编号。

NA

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/ietf-ipv4-unicast-routing:ipv4/route/next-hop/special-next-hop

指定特殊下一跳。

当前仅支持黑洞类型：blackhole。

NA

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/ietf-ipv4-unicast-routing:ipv4/route/next-hop/next-hop-options/huawei-ipv4-static-route:multiple-path/egress-interface-nexthop

指定IPv4静态路由的下一跳出接口信息。

  • outgoing-interface：指定下一跳出接口。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-admin-name：指定静态路由绑定的NQA测试例的管理者名称。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-test-name：指定静态路由绑定的NQA测试例的测试例名称。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-route-monitor-group/group-name：指定静态路由绑定的路由监控组名称。
  • /route-track-parameters/route-track-type/hw-route-protection:track-bfd/session-name：指定静态路由绑定的BFD会话名称。

各子节点取值如下：

  • outgoing-interface：字符串形式，格式为interface-typeinterface-number，其中interface-type表示接口类型，interface-number表示接口编号。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-admin-name：字符串形式，不支持空格，区分大小写，长度范围是1～32。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-test-name：字符串形式，不支持空格，区分大小写，长度范围是1～32。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-route-monitor-group/group-name：字符串形式，不支持空格，区分大小写，长度范围是1～31。
  • /route-track-parameters/route-track-type/hw-route-protection:track-bfd/session-name：字符串形式，不支持空格，不区分大小写，长度范围是1～15。

NA

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/ietf-ipv4-unicast-routing:ipv4/route/next-hop/next-hop-options/huawei-ipv4-static-route:multiple-path/ipv4-address-nexthop
指定IPv4静态路由的下一跳IPv4地址信息，通过该节点的子节点进行相应配置：
  • next-hop-address：指定下一跳IPv4地址。
  • preference：指定IPv4静态路由的优先级。
  • description：指定IPv4静态路由的描述信息。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-admin-name：指定静态路由绑定的NQA测试例的管理者名称。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-test-name：指定静态路由绑定的NQA测试例的测试例名称。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-route-monitor-group/group-name：指定静态路由绑定的路由监控组名称。
  • /route-track-parameters/route-track-type/hw-route-protection:track-bfd/session-name：指定静态路由绑定的BFD会话名称。
各子节点取值如下：
  • next-hop-address：点分十进制格式。
  • preference：整数形式，取值范围是1～255。
  • description：字符串格式，支持空格，不支持符号“？”，区分大小写，长度范围是1～80。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-admin-name：字符串形式，不支持空格，区分大小写，长度范围是1～32。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-test-name：字符串形式，不支持空格，区分大小写，长度范围是1～32。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-route-monitor-group/group-name：字符串形式，不支持空格，区分大小写，长度范围是1～31。
  • /route-track-parameters/route-track-type/hw-route-protection:track-bfd/session-name：字符串形式，不支持空格，不区分大小写，长度范围是1～15。

NA

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/ietf-ipv4-unicast-routing:ipv4/route/next-hop/next-hop-options/huawei-ipv4-static-route:multiple-path/egress-interface-ipv4-nexthop
指定IPv4静态路由的下一跳出接口和下一跳IPv4地址信息，通过该节点的子节点进行相应配置：
  • outgoing-interface：指定下一跳出接口。
  • next-hop-address：指定下一跳IPv4地址。
  • preference：指定IPv4静态路由的优先级。
  • description：指定IPv4静态路由的描述信息。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-admin-name：指定静态路由绑定的NQA测试例的管理者名称。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-test-name：指定静态路由绑定的NQA测试例的测试例名称。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-route-monitor-group/group-name：指定静态路由绑定的路由监控组名称。
  • /route-track-parameters/route-track-type/hw-route-protection:track-bfd/session-name：指定静态路由绑定的BFD会话名称。
各子节点取值如下：
  • outgoing-interface：字符串形式，格式为interface-typeinterface-number，其中interface-type表示接口类型，interface-number表示接口编号。
  • next-hop-address：点分十进制格式。
  • preference：整数形式，取值范围是1～255。
  • description：字符串格式，支持空格，不支持符号“？”，区分大小写，长度范围是1～80。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-admin-name：字符串形式，不支持空格，区分大小写，长度范围是1～32。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-test-name：字符串形式，不支持空格，区分大小写，长度范围是1～32。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-route-monitor-group/group-name：字符串形式，不支持空格，区分大小写，长度范围是1～31。
  • /route-track-parameters/route-track-type/hw-route-protection:track-bfd/session-name：字符串形式，不支持空格，不区分大小写，长度范围是1～15。

NA

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/ietf-ipv4-unicast-routing:ipv4/route/next-hop/next-hop-options/huawei-ipv4-static-route:multiple-path/egress-routing-instance-ipv4-nexthop
指定IPv4静态路由的目的VPN和下一跳IPv4地址信息，通过该节点的子节点进行相应配置：
  • dest-routing-instance：指定目的VPN实例。
  • next-hop-address：指定下一跳IPv4地址。
  • preference：指定IPv4静态路由的优先级。
  • description：指定IPv4静态路由的描述信息。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-admin-name：指定静态路由绑定的NQA测试例的管理者名称。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-test-name：指定静态路由绑定的NQA测试例的测试例名称。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-route-monitor-group/group-name：指定静态路由绑定的路由监控组名称。
  • /route-track-parameters/route-track-type/hw-route-protection:track-bfd/session-name：指定静态路由绑定的BFD会话名称。
各子节点取值如下：
  • dest-routing-instance：字符串形式，不支持空格，区分大小写，长度范围是1～31。当输入的字符串两端使用双引号时，可在字符串中输入空格。
  • next-hop-address：点分十进制格式。
  • preference：整数形式，取值范围是1～255。
  • description：字符串格式，支持空格，不支持符号“？”，区分大小写，长度范围是1～80。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-admin-name：字符串形式，不支持空格，区分大小写，长度范围是1～32。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-test-name：字符串形式，不支持空格，区分大小写，长度范围是1～32。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-route-monitor-group/group-name：字符串形式，不支持空格，区分大小写，长度范围是1～31。
  • /route-track-parameters/route-track-type/hw-route-protection:track-bfd/session-name：字符串形式，不支持空格，不区分大小写，长度范围是1～15。

NA

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/ietf-ipv4-unicast-routing:ipv4/route/next-hop/next-hop-options/huawei-ipv4-static-route:multiple-path/egress-routing-instance-nexthop
指定IPv4静态路由的目的VPN信息，且不指定下一跳IPv4地址，通过该节点的子节点进行相应配置：
  • dest-routing-instance：指定目的VPN实例。
  • preference：指定IPv4静态路由的优先级。
  • tag：指定IPv4静态路由的tag属性值。
  • description：指定IPv4静态路由的描述信息。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-admin-name：指定静态路由绑定的NQA测试例的管理者名称。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-test-name：指定静态路由绑定的NQA测试例的测试例名称。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-route-monitor-group/group-name：指定静态路由绑定的路由监控组名称。
各子节点取值如下：
  • dest-routing-instance：字符串形式，不支持空格，区分大小写，长度范围是1～31。当输入的字符串两端使用双引号时，可在字符串中输入空格。preference：整数形式，取值范围是1～255。
  • tag：整数形式，取值范围是1～4294967295。缺省值是0。
  • description：字符串格式，支持空格，不支持符号“？”，区分大小写，长度范围是1～80。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-admin-name：字符串形式，不支持空格，区分大小写，长度范围是1～32。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-test-name：字符串形式，不支持空格，区分大小写，长度范围是1～32。
  • /route-track-parameters/route-track-type/huawei-route-protection:track-route-monitor-group/group-name：字符串形式，不支持空格，区分大小写，长度范围是1～31。

NA

配置IPv4静态路由示例

本章节主要介绍通过edit-config方法配置IPv4静态路由。

表2-295 配置IPv4静态路由

操作

XPATH

edit-config

/ietf-routing:routing/routing-instance/name

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/type

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/name

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/ietf-ipv4-unicast-routing:ipv4/route/destination-prefix

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/ietf-ipv4-unicast-routing:ipv4/route/next-hop/next-hop-options/huawei-ipv4-static-route:multiple-path/ipv4-address-nexthop/next-hop-address

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/ietf-ipv4-unicast-routing:ipv4/route/next-hop/next-hop-options/huawei-ipv4-static-route:multiple-path/ipv4-address-nexthop/preference

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/ietf-ipv4-unicast-routing:ipv4/route/next-hop/next-hop-options/huawei-ipv4-static-route:multiple-path/ipv4-address-nexthop/description

数据需求

项目

数据

 描述

指定路由实例名

default-routing-instance

在公网上配置静态路由。

指定路由类型

static

-

指定路由协议实例名称

default-routing-instance

-

指定目的IPv4地址和掩码长度

10.1.1.1/24

-

指定下一跳IPv4地址

192.168.10.1

-

指定IPv4静态路由的优先级

100

-

指定IPv4静态路由的描述信息

default-routing-instance

-

请求示例

<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="1" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
  <rt:routing xmlns:rt="urn:ietf:params:xml:ns:yang:ietf-routing">
        <rt:routing-instance>
          <rt:name>default-routing-instance</rt:name>
          <rt:routing-protocols>
            <rt:routing-protocol>
              <rt:type>static</rt:type>
              <rt:name>default-routing-instance</rt:name>
              <rt:static-routes>
                <v4ur:ipv4 xmlns:v4ur="urn:ietf:params:xml:ns:yang:ietf-ipv4-unicast-routing">
                  <v4ur:route>
                    <v4ur:destination-prefix>10.1.1.1/24</v4ur:destination-prefix>
                    <v4ur:next-hop>
                      <hw-v4sr:ipv4-address-nexthop xmlns:hw-v4sr="urn:huawei:params:xml:ns:yang:hw-ipv4-static-route">
                        <hw-v4sr:next-hop-address>192.168.10.1</hw-v4sr:next-hop-address>
                        <hw-v4sr:preference>100</hw-v4sr:preference>
                        <hw-v4sr:description>default-routing-instance</hw-v4sr:description>
                      </hw-v4sr:ipv4-address-nexthop>
                    </v4ur:next-hop>
                  </v4ur:route>
                </v4ur:ipv4>
              </rt:static-routes>
            </rt:routing-protocol>
          </rt:routing-protocols>
        </rt:routing-instance>
      </rt:routing>
	</config>
  </edit-config>
</rpc>

删除示例

<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="1" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
  <rt:routing xmlns:rt="urn:ietf:params:xml:ns:yang:ietf-routing">
        <rt:routing-instance xmlns:xc="urn:ietf:params:xml:ns:netconf:base:1.0" xc:operation="delete">
          <rt:name>default-routing-instance</rt:name>
          <rt:routing-protocols>
            <rt:routing-protocol>
              <rt:type>static</rt:type>
              <rt:name>default-routing-instance</rt:name>
              <rt:static-routes>
                <v4ur:ipv4 xmlns:v4ur="urn:ietf:params:xml:ns:yang:ietf-ipv4-unicast-routing">
                  <v4ur:route>
                    <v4ur:destination-prefix>10.1.1.1/24</v4ur:destination-prefix>
                    <v4ur:next-hop>
                      <hw-v4sr:ipv4-address-nexthop xmlns:hw-v4sr="urn:huawei:params:xml:ns:yang:hw-ipv4-static-route">
                        <hw-v4sr:next-hop-address>192.168.10.1</hw-v4sr:next-hop-address>
                        <hw-v4sr:preference>100</hw-v4sr:preference>
                        <hw-v4sr:description>default-routing-instance</hw-v4sr:description>
                      </hw-v4sr:ipv4-address-nexthop>
                    </v4ur:next-hop>
                  </v4ur:route>
                </v4ur:ipv4>
              </rt:static-routes>
            </rt:routing-protocol>
          </rt:routing-protocols>
        </rt:routing-instance>
      </rt:routing>
	</config>
  </edit-config>
</rpc>

响应示例

# 配置成功响应示例。
<?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>
# 配置失败响应示例。
<?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>Service process failed.</error-message>
    <error-info>Error on node /ietf-routing:routing/routing-instance[name="default-routing-instance"]/routing-protocols/routing-protocol[type="static",name="default-routing-instance"]/static-routes/ietf-ipv4-unicast-routing:ipv4/route[destination-prefix="10.1.1.1/24"]/next-hop/huawei-ipv4-static-route:ipv4-address-nexthop[next-hop-address="192.168.10.1"]</error-info>
  </rpc-error>
</rpc-reply>
翻译
English
下载文档
更新时间：2022-05-25

文档编号：EDOC1100127118

浏览量：14812

下载量：1049

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

相关版本

相关文档

数字签名

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

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

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