Enabling Local DNS

The enable operation is used to enable local DNS support for the current zone. With the operation, you can also enable or disable the local DNS support for the DNS zone template. All the sites or site alias zones, which were added according to the template with the enabled status, will be supported by local DNS. You can enable the local DNS support for multiple zones in a single packet.

To learn how to retrieve the status information for the local DNS server, refer to the Managing SOA Records and Zone Parameters section.

In this chapter:

Request Packet Structure

Response Packet Structure

Samples

 
Request Packet Structure

A request XML packet switching on the local DNS support includes the enable operation node:

<packet version="1.4.2.0">
<dns>
   <enable>
   ...
   </enable>
</dns>
</packet>

 

The graphical representation of the enable node is as follows:

You can enable the local DNS support for multiple zones. Add as many enable operations as the number of different filtering rules.

<dns>
   <enable>
   ...
   </enable>
...
   <enable>
   ...
   </enable>
</dns>

 

 
Response Packet Structure

The enable node of the output XML packet is structured as follows:

 

 
Samples
Enabling the local DNS for two zones

This request packet enables the local DNS for the zones specified by site ID 8 and ID 9.

<packet version="1.6.3.0">
<dns>
 <enable>
 <filter>
   <site-id>8</site-id>
   <site-id>9</site-id>
 </filter>
 </enable>
</dns>
</packet>

Response:

<packet version="1.6.3.0">
<dns>
 <enable>
 <result>
   <status>ok</status>
   <site-id>8</site-id>
 </result>
 <result>
   <status>ok</status>
   <site-id>9</site-id>
 </result>
 </enable>
</dns>
</packet>
Enabling the local DNS for the DNS zone template

This packet enables the local DNS for the DNS zone template .

<packet version="1.4.2.0">
<dns>
<enable/>
</dns>
</packet>

Response:

<?xml version="1.0" encoding="UTF-8"?>
<packet version="1.4.2.0">
  <dns>
    <enable>
      <result>
        <status>ok</status>
      </result>
    </enable>
  </dns>
</packet>