Case Study - Defending against DDoS attacks, improving DNS management, and enhancing web redirects

List notifications

Description

List all notifications of a failover check


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 The domain where the failover notification is
record-id Integer 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 The page number you want to check

Response: Array with notifications of the failover check.


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."}

When the record-id is incorrect or missing, any API request will fail with the following status and statusDescription:

{"status":"Failed","statusDescription":"Invalid request."}

If there is no added 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 no added value for "page", the following status will be returned:

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

Note: These are example errors in JSON format.


Example

URL JSON: https://api.cloudns.net/dns/list-failover-notifications.json
Domain POST/GET: auth-id=0&auth-password=password&domain-name=example.com&record-id=125&rows-per-page=10&page=1

URL XML: https://api.cloudns.net/dns/list-failover-notifications.xml'
Domain POST/GET: auth-id=0&auth-password=password&domain-name=example.com&record-id=125&rows-per-page=10&page=1


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