No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade
RESTful API Reference
CloudEngine 12800 and 12800E V200R003C00

This document describes the OPS APIs supported by the device, including OPS-supported operations, request examples, elements in the requests, response examples, elements in the responses, and response status codes.

Rate and give feedback:
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 Trace

IPv6 Trace

Start an IPv6 Trace Test

Operation

URI

Description

POST

/dgntl/ipv6/startIpTrace

Start an IPv6 trace test.

  • Request example
    <?xml version="1.0" encoding="UTF-8"?>              
              <startIpTrace>  
                <testName>trace</testName> 
                <destAddr>2001:db8::2</destAddr>
                <sourceAddr>2001:db8::1</sourceAddr> 
              </startIpTrace> 

    Table 3-632 describes elements in requests.

    Table 3-632  Elements

    Element

    Description

    destAddr

    Specifies the destination IP address of trace test packets. This element is mandatory.

    sourceAddr

    Specifies the source IP address of trace test packets.

    packetSize

    Specifies the number of bytes in sent test packets.

    packetCount

    Specifies the number of sent test packets.

    udpPortNum

    Specifies a destination port number.

    timeout

    Specifies a timeout period for test packets.

    initTtl

    Specifies the TTL of the first packet sent during the test.

    maxTtl

    Specifies the maximum TTL of test packets.

    vrfName

    Specifies a VPN instance name.

    testName

    Specifies a trace test name. This element is mandatory.

    showMplsLabelFlag

    Specifies whether to display label information.

    showHostNameFlag

    Specifies whether to perform reverse domain name parsing.

    showHostNameFlag

    Specifies whether to perform reverse domain name parsing.

  • Response example (XML format)
    <?xml version="1.0" encoding="UTF-8"?>   
    <rpc-reply message-id="801" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">   
      <ok/>   
    </rpc-reply>

    Table 3-633 describes status codes in responses.

    Table 3-633  Status codes in responses

    Status Code

    Description

    200 OK

    The operation succeeded.

    400 Bad Request

    The request operation failed because the request is incorrect in syntax or the information attribute in the request is incorrect.

    500 Internal Server Error

    The request operation failed because of internal errors in services or unidentified processing errors.

Stop an IPv6 Trace Test

Operation

URI

Description

POST

/dgntl/ipv6/stopIpTrace

Stop an IPv6 trace test.

  • Request example
    <?xml version="1.0" encoding="UTF-8"?>                
              <stopIpTrace>  
                <testName>trace</testName>
              </stopIpTrace>

    Table 3-634 describes elements in requests.

    Table 3-634  Elements

    Element

    Description

    testName

    Specifies a trace test name. This element is mandatory.

  • Response example (XML format)
    <?xml version="1.0" encoding="UTF-8"?>   
    <rpc-reply message-id="801" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">  
      <ok/>   
    </rpc-reply>

    Table 3-635 describes status codes in responses.

    Table 3-635  Status codes in responses

    Status Code

    Description

    200 OK

    The operation succeeded.

    400 Bad Request

    The request operation failed because the request is incorrect in syntax or the information attribute in the request is incorrect.

    500 Internal Server Error

    The request operation failed because of internal errors in services or unidentified processing errors.

Delete an IPv4 Trace Test

Operation

URI

Description

Delete

/dgntl/ipv4/deleteIpTrace

Delete an IPv4 trace test.

  • Request example
    <?xml version="1.0" encoding="UTF-8"?>         
              <deleteIpTrace>
                <testName>trace</testName>
               </deleteIpTrace>     

    Table 3-636 describes elements in requests.

    Table 3-636  Elements

    Element

    Description

    testName

    Specifies a trace test name. This element is mandatory.

  • Response example (XML format)
    <?xml version="1.0" encoding="UTF-8"?>
    <rpc-reply message-id="801" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
      <ok/>
    </rpc-reply>

    Table 3-637 describes status codes in responses.

    Table 3-637  Status codes in responses

    Status Code

    Description

    200 OK

    The operation succeeded.

    400 Bad Request

    The request operation failed because the request is incorrect in syntax or the information attribute in the request is incorrect.

    500 Internal Server Error

    The request operation failed because of internal errors in services or unidentified processing errors.

Query an IPv6 Trace Test

Operation

URI

Description

GET

/dgntl/ipv6/ipv6TraceResults

Query all IPv6 trace results.

GET

/dgntl/ipv6/ipv6TraceResults

Query a single IPv6 trace result.

  • Request example

    Query all results.

    <?xml version="1.0" encoding="UTF-8"?>
              <ipv6TraceResults> 
              </ipv6TraceResults>
    Query a single result.
    <?xml version="1.0" encoding="UTF-8"?>
              <ipv6TraceResults>               
              <ipv6TraceResult> 
                <testName>trace</testName> 
                  <status/>
                  <errorType/>
                </ipv6TraceResult> 
              </ipv6TraceResults>

    Table 3-638 describes elements in requests.

    Table 3-638  Elements

    Element

    Description

    testName

    Specifies a trace test name.

    status

    Specifies the test status.

    • finished
    • processing

    errorType

    Specifies a test result.

    • success
    • failed
  • Response example (XML format)
    <?xml version="1.0" encoding="UTF-8"?> 
            <ipv6TraceResults>             
              <ipv6TraceResult>
                <testName>trace</testName>
                <status>finished</status>
                <errorType>success</errorType>
              </ipv6TraceResult>
            </ipv6TraceResults>

    Table 3-639 describes elements in responses.

    Table 3-639  Elements

    Element

    Description

    testName

    Specifies a test name.

    status

    Specifies the test status.

    • finished
    • processing

    errorType

    Specifies a test result.

    • success
    • failed

    Table 3-640 describes status codes in responses.

    Table 3-640  Status codes in responses

    Status Code

    Description

    200 OK

    The operation succeeded.

    400 Bad Request

    The request operation failed because the request is incorrect in syntax or the information attribute in the request is incorrect.

    500 Internal Server Error

    The request operation failed because of internal errors in services or unidentified processing errors.

Query Detailed IPv6 Trace Test Results

Operation

URI

Description

GET

/dgntl/ipv6/ipv6TraceResults/ipv6TraceResult/traceResultDetails

Query detailed IPv6 trace test results.

  • Request example
    <?xml version="1.0" encoding="UTF-8"?>  
                  <traceResultDetails>
                  </traceResultDetails> 

    Table 3-641 describes elements in requests.

    Table 3-641  Elements

    Element

    Description

    testName

    Specifies a trace test name. This element is mandatory.

    status

    Specifies the test status.

    • finished
    • processing

    errorType

    Specifies a test result.

    • success
    • timeout
    • failed
  • Response example (XML format)
    <?xml version="1.0" encoding="UTF-8"?>  
                <traceResultDetails>
                  <traceResultDetail>
                    <vrId>0</vrId> 
                    <testName>trace</testName>  
                    <hopIndex>1</hopIndex>
                    <ttl>1</ttl> 
                    <rtt>2</rtt>    
                    <destIpAddr>2001:db8:::2</destIpAddr>
                    <isDelete>false</isDelete> 
                    <hostName></hostName>
                  </traceResultDetail>
                  <traceResultDetail>
                    <vrId>0</vrId> 
                    <testName>trace</testName>    
                    <hopIndex>2</hopIndex> 
                    <ttl>1</ttl>  
                    <rtt>2</rtt>  
                    <destIpAddr>2001:db8:::2</destIpAddr> 
                    <isDelete>false</isDelete> 
                    <hostName></hostName> 
                  </traceResultDetail>
                  <traceResultDetail>  
                    <vrId>0</vrId>  
                    <testName>trace</testName>   
                    <hopIndex>3</hopIndex>  
                    <ttl>1</ttl>    
                    <rtt>2</rtt>  
                    <destIpAddr>2001:db8:::2</destIpAddr>  
                    <isDelete>false</isDelete>
                    <hostName></hostName>    
                  </traceResultDetail>  
                </traceResultDetails>  
              </ipv6TraceResult>    
            </ipv6TraceResults>  
          </ipv6>       
        </dgntl>     
      </data>   
    </rpc-reply>]]>]]>

    describes elements in responses.

    Table 3-642  Elements

    Element

    Description

    testName

    Specifies a test name.

    status

    Specifies the test status.

    errorType

    Specifies a test result.

    hopIndex

    Specifies the serial number of a hop on the test path.

    ttl

    Specifies the TTL of the received response.

    type

    Specifies the type of a node.

    rtt

    Specifies the round trip time of test packets, in milliseconds.

    dsIpAddr

    Specifies the destination address corresponding to a specified hop.

    isDelete

    Indicates whether query results are deleted.

    hostName

    Specifies a domain name.

    mplsLabelInfo

    Specifies MPLS label information.

    labelCountIndex

    Specifies an MPLS label index.

    mplsLabel

    Specifies an MPLS label.

    mplsExp

    Specifies an MPLS priority.

    mplsStackBottom

    Specifies the MPLS stack bottom.

    mplsTtl

    Specifies an MPLS TTL.

    Table 3-643 describes status codes in responses.

    Table 3-643  Status codes in responses

    Status Code

    Description

    200 OK

    The operation succeeded.

    400 Bad Request

    The request operation failed because the request is incorrect in syntax or the information attribute in the request is incorrect.

    500 Internal Server Error

    The request operation failed because of internal errors in services or unidentified processing errors.

Translation
Download
Updated: 2019-05-05

Document ID: EDOC1100004147

Views: 59600

Downloads: 28

Average rating:
This Document Applies to these Products

Related Version

Related Documents

Share
Previous Next