Get monitoring checks pages

Description

Get the monitoring checks page count.

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
rows-per-page	Integer	Required	Results per page. Can be 10, 20, 30, 50 or 100
check_type	Integer	Optional	Monitoring check types: 17 - Ping 18 - Web 8 - TCP 9 - UDP 10 - DNS 12 - Heartbeat 13 - TLS (SSL) certificate 15 - SMTP 16 - Streaming
state	Integer	Optional	Possible values: 0 - Paused 1 - Active
status	Integer	Optional	Possible values: -1 - UNKNOWN 0 - DOWN 1 - UP

Response: The number of pages with checks.

Errors

When the authentication of the PI 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 a value is not added for "rows-per-page", the following status will be returned:

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

Note: These are example errors in JSON format.

Example

URL JSON: https://api.cloudns.net/monitoring/get-records-pages.json
POST/GET:
auth-id=0&auth-password=password&rows-per-page=10
sub-auth-id=0&auth-password=password&rows-per-page=10

URL XML: https://api.cloudns.net/monitoring/get-records-pages.xml
POST/GET:
auth-id=0&auth-password=password&rows-per-page=10
sub-auth-id=0&auth-password=password&rows-per-page=10

Last modified: 2025-06-03