Use the add_master_server operation to add a primary name server. This server will be primary for the zone specified by the site ID or site alias ID. You can add multiple primary servers in a single packet.
A request XML packet adding a primary name server includes the add_master_server operation node:
<packet>
<dns>
<add_master_server>
...
</add_master_server>
</dns>
</packet>
The graphical representation of the add_master_server node is as follows:
You can add multiple primary name servers in a single packet. Add as many add_master_server operations as the number of different servers you want to add.
<dns>
<add_master_server>
...
</add_master_server>
...
<add_master_server>
...
</add_master_server>
</dns>
Important: When creating request packets, put nodes and elements in the order they follow in the packet structure.
The add_master_server node of the output XML packet is structured as follows:
common.xsd
).This request packet adds a primary name server to the zone of the site with ID 5.
<packet>
<dns>
<add_master_server>
<site-id>5</site-id>
<ip_address>10.6.45.18</ip_address>
</add_master_server>
</dns>
</packet>
Response:
<packet>
<dns>
<add_master_server>
<result>
<status>ok</status>
<id>4</id>
</result>
</add_master_server>
</dns>
</packet>
If the IP address parameter has invalid format, the response looks as follows:
<packet>
<dns>
<add_master_server>
<result>
<status>error</status>
<errcode>1014</errcode>
<errtext>Parser error: Cannot parse the XML from the source specified</errtext>
<id>4</id>
</result>
</add_master_server>
</dns>
</packet>
If the site specified by the ID was not found on the server, the response looks as follows:
<packet>
<dns>
<add_master_server>
<result>
<status>error</status>
<errcode>1015</errcode>
<errtext>site does not exist.</errtext>
<id>4</id>
</result>
</add_master_server>
</dns>
</packet>
This request packet adds a primary name server to the zone of the site with ID 5 and ID 7.
<packet>
<dns>
<add_master_server>
<site-id>5</site-id>
<ip_address>10.6.45.18</ip_address>
</add_master_server>
<add_master_server>
<site-id>7</site-id>
<ip_address>10.6.45.18</ip_address>
</add_master_server>
</dns>
</packet>
Response:
<packet>
<dns>
<add_master_server>
<result>
<status>ok</status>
<id>4</id>
</result>
</add_master_server>
<add_master_server>
<result>
<status>ok</status>
<id>5</id>
</result>
</add_master_server>
</dns>
</packet>