Case Study - Building a Resilient CDN Network with GeoDNS

Get record

Description

Get record details

Note: This function is available only for master zones. Works with reverse zones too.


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 or reverse zone name whose record you want to see
record-id Integer Required The ID of the record you want to view.

Response: Array with record details or failed status with 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."}

Note: These are example errors in JSON format.


Example

URL JSON: https://api.cloudns.net/dns/get-record.json
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&record-id=123456
sub-auth-id=0&auth-password=password&domain-name=domain.com&record-id=123456
Reverse IPv4 POST/GET:
auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&record-id=12356
sub-auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&record-id=123456
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&record-id=123456
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&record-id=123456

URL XML: https://api.cloudns.net/dns/get-record.xml
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&record-id=123456
sub-auth-id=0&auth-password=password&domain-name=domain.com&record-id=123456
Reverse IPv4 POST/GET:
auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&record-id=123456
sub-auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&record-id=123456
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&record-id=123456
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&record-id=123456


Last modified: 2023-05-10
Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more