Modify SOA details.
Note: This function is available only for master zones. Works with reverse zones too.
| 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 |
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.
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