Black Friday promo up to -50% Time left:

Check history

Description

Failover check history


 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 containing the record
record-id String Required Record ID. You can see this ID with the method List records 
rows-per-page Integer  Required Results per page. Can be 10, 20, 30, 50 or 100. 
page Integer  Required Page number starting from 1. 

Return: Status and description if there is an error. List with checks done if everything is correct.


Errors

When the authentication 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."}

If you have entered an invalid or non-existent domain name, the following status will be returned:

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

If the entered Record ID is invalid, the following status will be returned:

{"status":"Failed","statusDescription":"Invalid record-id param."}

If there is not added a value for "rows-per-page", the following status will be returned:

{"status":"Failed","statusDescription":"Wrong or missing required parameter 'rows-per-page'."}

If there is not added a value for "page", the following status will be returned:

{"status":"Failed","statusDescription":"Missing required parameter 'page'"}

Note: These are example errors in JSON format, and these are not the only errors that can be displayed.


 Example

URL JSON: https://api.cloudns.net/dns/failover-check-history.json
POST/GET: auth-id=0&auth-password=password&domain-name=cloudns.net&record-id=32&rows-per-page=10&page=1
POST/GET: sub-auth-id=0&auth-password=password&domain-name=cloudns.net&record-id=32&rows-per-page=10&page=1

URL XML: https://api.cloudns.net/dns/failover-check-history.xml
POST/GET: auth-id=0&auth-password=password&domain-name=cloudns.net&record-id=32&rows-per-page=10&page=1
POST/GET: sub-auth-id=0&auth-password=password&domain-name=cloudns.net&record-id=32&rows-per-page=10&page=1


Last modified: 2019-06-12
Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more