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 V200R005C10

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).
DNS

DNS

Parsing the Domain Name

Operation

URI

Description

GET

/dns/dnsNameResolution

Obtains the IP address of a host.

  • Request example:
    <?xml version='1.0' encoding='UTF-8'?> 
     <dnsNameResolution operation="merge"> 
        <host>hostname.domain.com</host> 
        <addrType>1</addrType> 
     </dnsNameResolution>

    Table 28-10 shows the description of elements in request.

    Table 28-10 The description of elements in request

    Element

    Description

    host

    Name of the host to be parsed (mandatory)

    addrType

    Type of a host address. 1 indicates an IPv4 address. (mandatory)

  • Response example (XML format):
    <?xml version='1.0' encoding='UTF-8'?> 
     <dnsNameResolution operation="merge"> 
        <host>hostname.domain.com</host> 
        <addrType>1</addrType> 
        <ipv4Addr>10.0.0.2</ipv4Addr> 
     </dnsNameResolution>

    Table 28-11 shows the description of elements in response.

    Table 28-11 The description of elements in response

    Element

    Description

    host

    Name of the host to be parsed (mandatory)

    addrType

    Type of a host address. 1 indicates an IPv4 address.

    ipv4Addr

    IPv4 address corresponding to the domain name

    Table 28-12 shows the description of status codes in response.

    Table 28-12 The description of status codes in response

    Status Code

    Description

    200 OK

    The operation succeeds.

    400 Bad Request

    The request cannot be implemented because the request is incorrect in syntax or the information attribute in the request is incorrect.

    500 Internal Server Error

    Internal errors in services cause a request failure or an unidentified request.

Configuring an IPv4 DNS Server

Operation

URI

Description

POST

/dns/dnsIpv4Servers

Configures an IPv4 DNS server.

DELETE

/dns/dnsIpv4Servers

Deletes an IPv4 DNS server.

  • Request example:
    <?xml version='1.0' encoding='UTF-8'?> 
     <dnsIpv4Servers operation="create"> 
        <dnsIpv4Server> 
           <seqNo>1</seqNo> 
           <ipv4Addr>1.1.1.1</ipv4Addr> 
        </dnsIpv4Server> 
     </dnsIpv4Servers>

    Table 28-13 shows the description of elements in request.

    Table 28-13 The description of elements in request

    Element

    Description

    seqNo

    (Mandatory) DNS server sequence number

    ipv4Addr

    (Mandatory) IPv4 address of the DNS server

  • Response example (XML format):
    <?xml version="1.0" encoding="UTF-8"?> 
     <ok/>

    Table 28-14 shows the description of status codes in response.

    Table 28-14 The description of status codes in response

    Status Code

    Description

    200 OK

    The operation succeeds.

    400 Bad Request

    The request cannot be implemented because the request is incorrect in syntax or the information attribute in the request is incorrect.

    500 Internal Server Error

    Internal errors in services cause a request failure or an unidentified request.

Enabling DNS

Operation

URI

Description

PUT

/dns/dnsGlobalCfgs/dnsGlobalCfg

Enables or disables DNS:

  • true: DNS is enabled.
  • false: DNS is disabled.

  • Request example:
    <?xml version='1.0' encoding='UTF-8'?> 
        <dnsGlobalCfg operation="merge"> 
           <dnsEnable>true</dnsEnable> 
        </dnsGlobalCfg>

    Table 28-15 shows the description of elements in request.

    Table 28-15 The description of elements in request

    Element

    Description

    dnsEnable

    (Mandatory) Whether DNS is enabled

  • Response example (XML format):
    <?xml version="1.0" encoding="UTF-8"?> 
     <ok/>

    Table 28-16 shows the description of status codes in response.

    Table 28-16 The description of status codes in response

    Status Code

    Description

    200 OK

    The operation succeeds.

    400 Bad Request

    The request cannot be implemented because the request is incorrect in syntax or the information attribute in the request is incorrect.

    500 Internal Server Error

    Internal errors in services cause a request failure or an unidentified request.

Translation
Download
Updated: 2019-04-03

Document ID: EDOC1100075372

Views: 10552

Downloads: 16

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next