No relevant resource is found in the selected language.
Enterprise
Worldwide
Search
Support Documentation
S12700 and S12700E V200R020C00 NETCONF YANG API Reference

This document describes the NETCONF YANG API functions supported by the switch, including the data model and samples.

Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
IPv6 Static Route Management

IPv6 Static Route Management

This section describes the configuration model of IPv6 static route management and provides examples of XML packets.

Data Model

The configuration file matching IPv6 static route management is ietf-routing.yang, huawei-ipv6-static-route.yang, and ietf-ipv6-unicast-routing.yang.

Table 2-284 IPv6 static route management

Object

Description

Value

Remarks

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/huawei-ipv6-static-route:ipv6/route/destination-prefix

Indicates the destination IPv6 address and prefix length.

The value is in the dest-ipv6-address/prefix-length format:

  • dest-ipv6-address: indicates the destination IPv6 address, which is a 32-digit hexadecimal number, in the X:X:X:X:X:X:X:X format.
  • prefix-length: indicates the prefix length, which is an integer in the range from 0 to 128.

N/A

/ietf-ipv6-unicast-routing:ipv6/route/next-hop/next-hop-options/simple-next-hop

Indicates a next-hop outbound interface.

The value is a character string in the interface-typeinterface-number format, where interface-type indicates the interface type and interface-number indicates the interface number.

N/A

/ietf-ipv6-unicast-routing:ipv6/route/next-hop/next-hop-options/special-next-hop

Indicates a special next hop.

Currently, only the blackhole next hop is supported.

N/A

/ietf-ipv6-unicast-routing:ipv6/route/next-hop/next-hop-options/next-hop-address

Indicates a next-hop IPv6 address.

The value is in dotted decimal notation.

N/A

/ietf-ipv6-unicast-routing:ipv6/route/next-hop/next-hop-options/description

Configures a description for an IPv6 static route.

The value is a string of 1 to 80 characters without question marks. It can contain spaces.

N/A

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/huawei-ipv6-static-route:ipv6/route/next-hop-options/multiple-path/ipv6-address-nexthop
Indicates the next-hop IPv6 address information of an IPv6 static route, which is configured through the following child objects:
  • next-hop-address: indicates a next-hop IPv6 address.
  • preference: indicates the priority of an IPv6 static route.
  • tag: indicates the tag value of an IPv6 static route.
  • description: indicates the description of an IPv6 static route.
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-admin-name: specifies the administrator name of the NQA test instance bound to a static route.
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-test-name: specifies the name of the NQA test instance bound to a static route.
The value ranges of the child objects are as follows:
  • next-hop-address: is a 32-digit hexadecimal number, in the X:X:X:X:X:X:X:X format.
  • preference: is an integer in the range from 1 to 255. The default value is 60.
  • tag: is an integer in the range from 1 to 4294967295. The default value is 0.
  • description: is a string of 1 to 80 characters that can contain spaces.
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-admin-name: is a string of 1 to 32 case-sensitive characters that cannot contain spaces.
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-test-name: is a string of 1 to 32 case-sensitive characters that cannot contain spaces.

N/A

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/huawei-ipv6-static-route:ipv6/route/next-hop-options/multiple-path/egress-interface-ipv6-nexthop
Indicates the next-hop outbound interface and next-hop IPv6 address information of an IPv6 static route, which is configured through the following child objects:
  • outgoing-interface: indicates a next-hop outbound interface.
  • next-hop-address: indicates a next-hop IPv6 address.
  • preference: indicates the priority of an IPv6 static route.
  • tag: indicates the tag value of an IPv6 static route.
  • description: indicates the description of an IPv6 static route.
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-admin-name: specifies the administrator name of the NQA test instance bound to a static route.
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-test-name: specifies the name of the NQA test instance bound to a static route.
The value ranges of the child objects are as follows:
  • outgoing-interface: is a character string in the interface-typeinterface-number format, where interface-type indicates the interface type and interface-number indicates the interface number.
  • next-hop-address: is a 32-digit hexadecimal number in the X:X:X:X:X:X:X:X format.
  • preference: is an integer in the range from 1 to 255. The default value is 60.
  • tag: is an integer in the range from 1 to 4294967295. The default value is 0.
  • description: is a string of 1 to 80 characters that can contain spaces.
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-admin-name: is a string of 1 to 32 case-sensitive characters that cannot contain spaces.
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-test-name: is a string of 1 to 32 case-sensitive characters that cannot contain spaces.

N/A

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/huawei-ipv6-static-route:ipv6/route/next-hop-options/multiple-path/egress-routing-instance-ipv6-nexthop
Indicates the destination VPN and next-hop IPv6 address information of an IPv6 static route, which is configured through the following child objects:
  • dest-routing-instance: indicates the destination VPN instance.
  • next-hop-address: indicates a next-hop IPv6 address.
  • preference: indicates the priority of an IPv6 static route.
  • tag: indicates the tag value of an IPv6 static route.
  • description: indicates the description of an IPv6 static route.
  • //route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-admin-name: specifies the administrator name of the NQA test instance bound to a static route.
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-test-name: specifies the name of the NQA test instance bound to a static route.
The value ranges of the child objects are as follows:
  • dest-routing-instance: is a string of 1 to 31 case-sensitive characters with spaces. If the string is enclosed in double quotation marks (" "), the string can contain spaces. The value must be an existing VPN instance name.
  • next-hop-address: is a 32-digit hexadecimal number in the X:X:X:X:X:X:X:X format.
  • preference: is an integer in the range from 1 to 255. The default value is 60.
  • tag: is an integer in the range from 1 to 4294967295. The default value is 0.
  • description: is a string of 1 to 80 characters that can contain spaces.
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-admin-name: is a string of 1 to 32 case-sensitive characters that cannot contain spaces.
  • /route-track-parameters/route-track-type/huawei-route-protection:track-nqa/nqa-test-name: is a string of 1 to 32 case-sensitive characters that cannot contain spaces.

N/A

/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/huawei-ipv6-static-route:ipv6/route/next-hop-options/multiple-path/egress-routing-instance-nexthop
Indicates the destination VPN information of an IPv6 static route, with no next-hop IPv6 address specified. This object is configured through the following child objects:
  • dest-routing-instance: indicates the destination VPN instance.
  • preference: indicates the priority of an IPv6 static route.
  • tag: indicates the tag value of an IPv6 static route.
  • description: indicates the description of an IPv6 static route.
The value ranges of the child objects are as follows:
  • dest-routing-instance: is a string of 1 to 31 case-sensitive characters with spaces. If the string is enclosed in double quotation marks (" "), the string can contain spaces. The value must be an existing VPN instance name.
  • preference: is an integer in the range from 1 to 255. The default value is 60.
  • tag: is an integer in the range from 1 to 4294967295. The default value is 0.
  • description: is a string of 1 to 80 characters that can contain spaces.

N/A

Configuring an IPv6 Static Route

This section provides a sample of configuring an IPv6 static route using the edit-config method.

Table 2-285 Configuring an IPv6 static route

Operation

XPATH

edit-config
  • /ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/hw-v6sr:ipv6/route/destination-prefix
  • /ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/hw-v6sr:ipv6/route/next-hop-options/multiple-path/egress-routing-instance-ipv6-nexthop/dest-routing-instance
  • /ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/hw-v6sr:ipv6/route/next-hop-options/multiple-path/egress-routing-instance-ipv6-nexthop/next-hop-address
  • /ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/hw-v6sr:ipv6/route/next-hop-options/multiple-path/egress-routing-instance-ipv6-nexthop/preference
  • /ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/hw-v6sr:ipv6/route/next-hop-options/multiple-path/egress-routing-instance-ipv6-nexthop/tag
  • /ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/static-routes/hw-v6sr:ipv6/route/next-hop-options/multiple-path/egress-routing-instance-ipv6-nexthop/description

Data Requirements

Item

Data

 Description

Destination IPv6 address and prefix length

fc00:0:0:2001::1/64

-

Destination VPN instance

test2

-

Next-hop IPv6 address

fc00:0:0:2002::2

-

Priority of an IPv6 static route

100

-

Tag value of an IPv6 static route

100

-

Request Example

<?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="create">
          <rt:name>default-routing-instance</rt:name>
          <rt:routing-protocols>
            <rt:routing-protocol>
              <rt:type>static</rt:type>
              <rt:name>test1</rt:name>
              <rt:static-routes>
                <hw-v6sr:ipv6 xmlns:hw-v6sr="urn:huawei:params:xml:ns:yang:hw-ipv6-static-route">
                  <hw-v6sr:route>
                    <hw-v6sr:destination-prefix>fc00:0:0:2001::1/64</hw-v6sr:destination-prefix>
                    <hw-v6sr:egress-routing-instance-ipv6-nexthop>
                      <hw-v6sr:dest-routing-instance>test2</hw-v6sr:dest-routing-instance>
                      <hw-v6sr:next-hop-address>fc00:0:0:2002::2</hw-v6sr:next-hop-address>
                      <hw-v6sr:preference>100</hw-v6sr:preference>
                      <hw-v6sr:tag>100</hw-v6sr:tag>
                    </hw-v6sr:egress-routing-instance-ipv6-nexthop>
                  </hw-v6sr:route>
                </hw-v6sr:ipv6>
              </rt:static-routes>
            </rt:routing-protocol>
          </rt:routing-protocols>
        </rt:routing-instance>
      </rt:routing>
    </config>
  </edit-config>
</rpc>

Deletion Example

<?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>test1</rt:name>
              <rt:static-routes>
                <hw-v6sr:ipv6 xmlns:hw-v6sr="urn:huawei:params:xml:ns:yang:hw-ipv6-static-route">
                  <hw-v6sr:route>
                    <hw-v6sr:destination-prefix>fc00:0:0:2001::1/64</hw-v6sr:destination-prefix>
                    <hw-v6sr:egress-routing-instance-ipv6-nexthop>
                      <hw-v6sr:dest-routing-instance>test2</hw-v6sr:dest-routing-instance>
                      <hw-v6sr:next-hop-address>fc00:0:0:2002::2</hw-v6sr:next-hop-address>
                      <hw-v6sr:preference>100</hw-v6sr:preference>
                      <hw-v6sr:tag>100</hw-v6sr:tag>
                    </hw-v6sr:egress-routing-instance-ipv6-nexthop>
                  </hw-v6sr:route>
                </hw-v6sr:ipv6>
              </rt:static-routes>
            </rt:routing-protocol>
          </rt:routing-protocols>
        </rt:routing-instance>
      </rt:routing>
    </config>
  </edit-config>
</rpc>

Response Example

# Sample of successful response

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

# Sample of failed response

##### 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 IPv6 VPN instance does not exist.</error-message>
    <error-info>Error on node /ietf-routing:routing/routing-instance[name="default-routing-insta"]/routing-protocols/routing-protocol[type="ietf-routing:static",name="test1"]/static-routes/huawei-ipv6-static-route:ipv6/route[destination-prefix="fc00:0:0:2001::1/64"]/egress-routing-instance-ipv6-nexthop[dest-routing-instance="test2",next-hop-address="fc00:0:0:2002::2"]</error-info>
  </rpc-error>
Translation
简体中文
Download
Updated: 2022-06-24

Document ID: EDOC1100176413

Views: 43777

Downloads: 17

Average rating:
This Document Applies to these Products

Related Version

Related Documents

Digital Signature File

Digital Signature Authentication Mode
Share
Previous Next

Copyright © 2023 Huawei Technologies Co., Ltd. All rights reserved.

You are going to visit :