Gets a list with zones you have or zone names matching a keyword. The method works with pagination. Reverse zones are included.
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 |
page | Integer | Required | Current page your zone list is on |
rows-per-page | Integer | Required | Results per page. Can be 10, 20, 30, 50 or 100. |
search | String | Optional | Domain name, reverse zone name or keyword to search for in the zone names |
group-id | Integer | Optional | ID of the relevant group. If group's ID is set up, all zones in this group will be listed. If value none is set up for parameter group-id, all not included zones in this group will be listed. |
has-cloud-domains | Integer | Optional | Possible value: 1. Show page count only for zones that have cloud domains. |
If only authentication parameters are sent or page parameter is not Integer, the API request will fail with the following status and statusDescription:
{"status":"Failed","statusDescription":"Missing required parameter 'page'."}
When only authentication and page parameters are sent or rows-per-page paremeter is not Integer, the API request will fail and the following status and statusDescription will be returned:
{"status":"Failed","statusDescription":"Wrong or missing required parameter 'rows-per-page'."}
Note: These are example errors in JSON format.
URL JSON: https://api.cloudns.net/dns/list-zones.json
POST/GET: auth-id=0&auth-password=password&page=1&rows-per-page=10
POST/GET: sub-auth-id=0&auth-password=password&page=1&rows-per-page=10
URL XML: https://api.cloudns.net/dns/list-zones.xml
POST/GET: auth-id=0&auth-password=password&page=1&rows-per-page=10
POST/GET: sub-auth-id=0&auth-password=password&page=1&rows-per-page=10
Example for zone search
URL JSON: https://api.cloudns.net/dns/list-zones.json
Domain POST/GET:
auth-id=0&auth-password=password&page=1&rows-per-page=10&search=domain-name
sub-auth-id=0&auth-password=password&page=1&rows-per-page=10&search=domain-name
Reverse zone POST/GET:
auth-id=0&auth-password=password&page=1&rows-per-page=10&search=0.0.127.in-addr.arpa
sub-auth-id=0&auth-password=password&page=1&rows-per-page=10&search=0.0.127.in-addr.arpa
URL XML: https://api.cloudns.net/dns/list-zones.xml
Domain POST/GET:
auth-id=0&auth-password=password&page=1&rows-per-page=10&search=domain-name
sub-auth-id=0&auth-password=password&page=1&rows-per-page=10&search=domain-name
Reverse zone POST/GET:
auth-id=0&auth-password=password&page=1&rows-per-page=10&search=0.0.127.in-addr.arpa
sub-auth-id=0&auth-password=password&page=1&rows-per-page=10&search=0.0.127.in-addr.arpa
Example for zone search filtered by groups
URL JSON: https://api.cloudns.net/dns/list-zones.json
Domain POST/GET:
auth-id=0&auth-password=password&page=1&rows-per-page=10&group-id=id
sub-auth-id=0&auth-password=password&page=1&rows-per-page=10&group-id=id
URL XML: https://api.cloudns.net/dns/list-zones.xml
Domain POST/GET:
auth-id=0&auth-password=password&page=1&rows-per-page=10&group-id=id
sub-auth-id=0&auth-password=password&page=1&rows-per-page=10&group-id=id