Copy records

Description

Copies all the records from a specified zone.

Notes:

  • This function is available only for master zones.
  • Reverse DNS zones are not supported for this API method.

 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 to copy the records to
from-domain String Required Domain name to copy the records from
delete-current-records Integer Optional Set to 1, to delete the current domain records (if any).

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 or from-domain is entered, the following status will be returned:

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

Note: These are example errors in JSON format.


Example

URL JSON: https://api.cloudns.net/dns/copy-records.json
POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&from-domain=from-domain.com
sub-auth-id=0&auth-password=password&domain-name=domain.com&from-domain=from-domain.com

URL XML: https://api.cloudns.net/dns/copy-records.xml
POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&from-domain=from-domain.com
sub-auth-id=0&auth-password=password&domain-name=domain.com&from-domain=from-domain.com


 Example with optional parameter delete-current-records

URL JSON: https://api.cloudns.net/dns/copy-records.json
POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&from-domain=from-domain.com&delete-current-records=1
sub-auth-id=0&auth-password=password&domain-name=domain.com&from-domain=from-domain.com&delete-current-records=1

URL XML: https://api.cloudns.net/dns/copy-records.xml
POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&from-domain=from-domain.com&delete-current-records=1
sub-auth-id=0&auth-password=password&domain-name=domain.com&from-domain=from-domain.com&delete-current-records=1


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