Case Study - Global Reach, Local Touch: The Role of GeoDNS in eCommerce Expansion

Delete master server

Description

Delete master server by ID in domain zone

Note: This function is available only for slave zones. Works with reverse zones too.


 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 Domain name or reverse zone name whose master servers you want to see
master-id Integer Required ID of master server, returned in List master servers.

Response: Array with status and status description.


Errors

When the authenctication 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."}

In case the credentials of API sub user are invalid, the following status and statusDescription will be returned:

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

When invalid or non-existant domain-name is entered, the following status will be returned:

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

When master-id parameter is invalid or incorrect, the API request will fail and the following status and statusDescription will be returned:

{"status":"Failed","statusDescription":"Invalid parameter master-id"}

Note: These are example errors in JSON format.


 Example

URL JSON: https://api.cloudns.net/dns/delete-master-server.json
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&master-id=000000
sub-auth-id=0&auth-password=password&domain-name=domain.com&master-id=000000
Reverse IPv4 POST/GET:
auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&master-id=000000
sub-auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&master-id=000000
Reverse IPv6 POST/GET:
auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.ip6.arpa&master-id=000000
sub-auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.ip6.arpa&master-id=000000


URL XML: https://api.cloudns.net/dns/delete-master-server.xml
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&master-id=000000
sub-auth-id=0&auth-password=password&domain-name=domain.com&master-id=000000
Reverse IPv4 POST/GET:
auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&master-id=000000
sub-auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&master-id=000000
Reverse IPv6 POST/GET:
auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.ip6.arpa&master-id=000000
sub-auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.ip6.arpa&master-id=000000


Last modified: 2020-01-13
Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more