Adds new ip address of a slave server for zone transfers. Works with reverse zones too.
Important note:
The API users can allow IPv4/IPv6 subnetworks for zone transfers. The notifications for the subnetworks aren't possible. The API users need to specify a full IP address to be notified.
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 to which you want to add a slave server's ip address |
ip | String | Required | IP address of the slave server |
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 ip parameter is invalid, the API request will fail and the following status and statusDescription will be returned:
{"status":"Failed","statusDescription":"Invalid IP address."}
Note: These are example errors in JSON format.
URL JSON: https://api.cloudns.net/dns/axfr-add.json
Domain POST/GET: auth-id=0&auth-password=password&domain-name=domain.com&ip=1.127.128.255
Reverse IPv4 POST/GET: auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&ip=1.127.128.255
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&ip=1.127.128.255
URL XML: https://api.cloudns.net/dns/axfr-add.xml
Domain POST/GET: auth-id=0&auth-password=password&domain-name=domain.com&ip=1.127.128.255
Reverse IPv4 POST/GET: auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&ip=1.127.128.255
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&ip=1.127.128.255