Case Study - Safe and Secure: The ccTLD Protection Journey

Modify child name server

Description

Modifies the child name servers (Glue records) of the domain


 Parameters

Name Data Type Status Description
auth-id or sub-auth-id or sub-auth-user Integer Required Authentication parameter
auth-password String Required Authentication parameter
domain-name String Required Name of the domain
host String Required Host of child name server
old-ip String Required The old IP of the child name server
new-ip String Required The new IP of the child name server

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"}

Note: These are example errors in JSON format, and these are not the only errors that can be displayed.


Example

URL JSON: https://api.cloudns.net/domains/modify-child-nameservers.json
POST/GET: auth-id=0&auth-password=password&domain-name=domain.com&host=ns1&old-ip=127.0.0.1&new-ip=192.168.1.2
POST/GET: sub-auth-id=0&auth-password=password&domain-name=domain.com&host=ns1&old-ip=127.0.0.1&new-ip=192.168.1.2

URL XML: https://api.cloudns.net/domains/modify-child-nameservers.xml
POST/GET: auth-id=0&auth-password=password&domain-name=domain.com&host=ns1&old-ip=127.0.0.1&new-ip=192.168.1.2
POST/GET: sub-auth-id=0&auth-password=password&domain-name=domain.com&host=ns1&old-ip=127.0.0.1&new-ip=192.168.1.2


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