Import via transfer

Description

Imports records from another server via zone transfer. Deletes all existing records

If the method is used for importing GeoDNS records, all GeoDNS records will be imported with a Default location.


 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 you want to transfer the records to. It must be the same at the other server as it is in our system.
server String Required Hostname or IP address of the server the records will be transferred from.

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 server parameter is invalid (incorrect host name or IP address), the API request will fail and the following status and statusDescription will be returned:

{"status":"Failed","statusDescription":"This is not a valid host."}

If the transfer is not allowed from the IP address or host name, entered for server parameter, the following status and statusDescription will be returned:

{"status":"Failed","statusDescription":"The zone transfers are not allowed from this server!"}

Note: These are example errors in JSON format.


 Example for master zone

URL JSON: https://api.cloudns.net/dns/axfr-import.json
POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&server=ext-ns1.server.com
sub-auth-id=0&auth-password=password&domain-name=domain.com&server=ext-ns1.server.com


URL XML: https://api.cloudns.net/dns/axfr-import.xml
POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&server=ext-ns1.server.com
sub-auth-id=0&auth-password=password&domain-name=domain.com&server=ext-ns1.server.com


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