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

Modify SOA details

Description

Modify SOA details.

Note: This function is available only for master 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 SOA details you want to modify
primary-ns String Required Hostname of primary nameserver.
admin-mail String Required DNS admin's e-mail
refresh Integer Required Refresh rate from 1200 to 43200 seconds
retry Integer Required Retry rate from 180 to 2419200 seconds
expire Integer Required Expire time from 1209600 to 2419200 seconds
default-ttl Integer Required Default TTL from 60 to 2419200 seconds

Return: 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 invalid host name is entered for primary-ns parameter, the following status and statusDescription will be returned:

{"status":"Failed","statusDescription":"Invalid hostname for Primary NS"}

If invalid e-mail address is entered for admin-mail parameter, the following status and statusDescription will be returned:

{"status":"Failed","statusDescription":"Invalid admin mail"}

When one of the refresh, retry, expire and default-ttl parameters is not from the suggested values or Integer, the API request will fail and the following status and statusDescription will be returned:

{"status":"Failed","statusDescription":"Invalid Refresh/Retry/Expire/Default TTL value"}

Note: These are example errors in JSON format.


 Example

URL JSON: https://api.cloudns.net/dns/modify-soa.json
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&primary-ns=ns1.cloudns.net&admin-mail=support@cloudns.net&refresh=7200&retry=1800&expire=1209600&default-ttl=3600
sub-auth-id=0&auth-password=password&domain-name=domain.com&primary-ns=ns1.cloudns.net&admin-mail=support@cloudns.net&refresh=7200&retry=1800&expire=1209600&default-ttl=3600
Reverse IPv4 POST/GET:
auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&primary-ns=ns1.cloudns.net&admin-mail=support@cloudns.net&refresh=7200&retry=1800&expire=1209600&default-ttl=3600
sub-auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&primary-ns=ns1.cloudns.net&admin-mail=support@cloudns.net&refresh=7200&retry=1800&expire=1209600&default-ttl=3600
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&primary-ns=ns1.cloudns.net&admin-mail=support@cloudns.net&refresh=7200&retry=1800&expire=1209600&default-ttl=3600
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&primary-ns=ns1.cloudns.net&admin-mail=support@cloudns.net&refresh=7200&retry=1800&expire=1209600&default-ttl=3600


URL XML: https://api.cloudns.net/dns/modify-soa.xml
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&primary-ns=ns1.cloudns.net&admin-mail=support@cloudns.net&refresh=7200&retry=1800&expire=1209600&default-ttl=3600
sub-auth-id=0&auth-password=password&domain-name=domain.com&primary-ns=ns1.cloudns.net&admin-mail=support@cloudns.net&refresh=7200&retry=1800&expire=1209600&default-ttl=3600
Reverse IPv4 POST/GET:
auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&primary-ns=ns1.cloudns.net&admin-mail=support@cloudns.net&refresh=7200&retry=1800&expire=1209600&default-ttl=3600
sub-auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&primary-ns=ns1.cloudns.net&admin-mail=support@cloudns.net&refresh=7200&retry=1800&expire=1209600&default-ttl=3600
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&primary-ns=ns1.cloudns.net&admin-mail=support@cloudns.net&refresh=7200&retry=1800&expire=1209600&default-ttl=3600
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&primary-ns=ns1.cloudns.net&admin-mail=support@cloudns.net&refresh=7200&retry=1800&expire=1209600&default-ttl=3600


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