Modify name servers

Description

Modifies the name servers of the domain

Notes:

  • This function is not available for sub users.
  • If you intend to use glue records for "*.be", "*.de", "*.fr", "*.re", "*.tf", "*.wf" or "*.yt" domains, the IP addresses must be added along with your name servers. Samples are shown at the "Examples" section of this page.

Parameters

Name Data Type Status Description
auth-id Integer Required Authentication parameter
auth-password String Required Authentication parameter
domain-name String Required Name of the domain
nameservers Array Required Array with the name servers

Return: Array with status and status description


Errors

When the authentication of API user is not correct, any API request will fail with the following status and statusDescription:

{"status":"Failed","statusDescription":"Invalid authentication, incorrect auth-id or auth-password."}

If there is not added a domain name or if the requested domain does not exist in your account, the following status will be returned:

{"status":"Failed","statusDescription":"Missing domain-name"}

For most of the domains the minimum set for name servers is 2. If you add only 1 name server, the following status will be returned:

{"status":"Failed","statusDescription":"The minimum name servers for .com domains are 2."}

Note: These are example errors in JSON format.


 Example

URL JSON: https://api.cloudns.net/domains/set-nameservers.json
POST/GET: auth-id=0&auth-password=password&domain-name=domain.com&nameservers[]=ns1.domain.com&nameservers[]=ns2.domain.com

URL XML: https://api.cloudns.net/domains/set-nameservers.xml
POST/GET: auth-id=0&auth-password=password&domain-name=domain.com&nameservers[]=ns1.domain.com&nameservers[]=ns2.domain.com

URL JSON: https://api.cloudns.net/domains/set-nameservers.json
POST/GET: auth-id=0&auth-password=password&domain-name=domain.be&nameservers[]=ns1.domain.be 127.0.0.1&nameservers[]=ns2.domain.be 127.0.0.2

URL XML: https://api.cloudns.net/domains/set-nameservers.xml
POST/GET: auth-id=0&auth-password=password&domain-name=domain.be&nameservers[]=ns1.domain.be 127.0.0.1&nameservers[]=ns2.domain.be 127.0.0.2


Last modified: 2021-04-23
Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more