The enable-remote-dns operation is used to disable the local DNS server, and you can use remote DNS servers.

This node is available only in Plesk for Windows 8.1 and next versions.

Request Packet Structure

A request XML packet, that enables use of remote DNS servers, includes the enable-remote-dns operation node:

<packet>
<dns>
   <enable-remote-dns/>
 </dns>
</packet>

The graphical representation of the enable-remote-dns node is as follows:

image 35064

Note: The interactive schema navigator for all request packets is available here: http://plesk.github.io/api-schemas/1.6.8.0/agent_input.svg.

Response Packet Structure

The enable-remote-dns node is presented by type DNSEnableRemoteDNS (dns_output.xsd) and is structured as follows:

image 35066

Note: The interactive schema navigator for all response packets is available here: http://plesk.github.io/api-schemas/1.6.8.0/agent_output.svg.

  • The result node is required. It wraps the information got from the server. Data type: resultType (common.xsd).
  • The status node is required. It specifies the execution status of the enable-remote-dns operation. Data type: string. Allowed values: ok | error.
  • The errcode node is optional. It is used to return the error code when the enable-remote-dns operation fails. Data type: unsignedInt.
  • The errtext node is optional. It is used to return the error message if the enable-remote-dns operation fails. Data type: string.

Samples

This request packet enables use of remote DNS servers.

<packet version="1.6.7.0">
<dns>
   <enable-remote-dns/>
 </dns>
</packet>

Response:

<packet version="1.6.7.0">
<dns>
<enable-remote-dns>
 <result>
   <status>ok</status>
 </result>
</enable-remote-dns>
 </dns>
</packet>

If the packet is sent to Plesk for Unix server, the response is as follows:

<?xml version="1.0" encoding="UTF-8"?>
<packet version="1.6.7.0">
  <dns>
    <enable-remote-dns>
      <result>
        <status>error</status>
        <errcode>1017</errcode>
        <errtext>operator enable-remote-dns is  not supported</errtext>
      </result>
    </enable-remote-dns>
  </dns>
</packet>