Update monitoring check

Description

Update a monitoring check

Parameters

Name	Data Type	Status	Description
auth-id	Integer	Required	Authentication parameter
auth-password	String	Required	Authentication parameter
name	String	Required	Name of the monitoring check
check_type	Integer	Required	Monitoring check types: 17 - Ping 18 - Web 8 - TCP 9 - UDP 10 - DNS 12 - Heartbeat 13 - TLS (SSL) certificate 15 - SMTP 16 - Streaming
id	Integer	Required	The ID of the monitoring check, that you want to update
ip	String	Optional	The IP address which will be monitored, it is required for all checks except the Heartbeat check.
status_change_checks	Integer	Optional	The number of checks to confirm the change of status. By default, the value is 1.
monitoring_region	String	Optional	Parameter required if you would like to specify a monitoring region or country. Possible values: global - Global eur - Europe nam - North America asi - Asia-Pacific at - Austria bg - Bulgaria br - Brazil ca - Canada de - Germany es - Spain fi - Finland hk - Hong Kong hu - Hungary il - Israel in - India it - Italy jp - Japan kr - South Korea mx - Mexico nl - Netherlands pe - Peru pl - Poland ro - Romania ru - Russian Federation sg - Singapore tr - Turkey tw - Taiwan uk - United Kingdom us - United States za - South Africa You can also specify a single node to make the checks. To achieve this, you need to list the available nodes by using this API method. Find the ID of the node you want to use and write it in the monitoring_region parameter. Example: monitoring_region=270. Disclaimer: If the node is down the check status will be Unknown!
host	String	Optional	Parameter required for Web and DNS check types. It must contain a hostname (FQDN).
ping_threshold	Integer	Optional	Used for Ping monitoring check type. Desired ping threshold. Default value is 15 - Ping (15% threshold). Possible values: 15 - Ping (15% threshold) 25 - Ping (25% threshold) 50 - Ping (50% threshold) 100 - Ping (100% threshold)
http_protocol	String	Optional	Used for Web monitoring check type. Desired Web protocol. Default value is HTTPS. Possible values: http - HTTP https - HTTPS
port	Integer	Optional	Parameter required for Web, TCP, UDP, TLS (SSL) certificate and SMTP check types. It must contain the port of the server. For TCP/UDP is a port on the Main IP.
path	String	Optional	Parameter for Web check types. If there is a specific path on the FQDN, it must be filled in this parameter.
content	String	Optional	Parameter required for Web check types. In case you require a specific output to be returned, it must be filled in this parameter (e.g. OK).
open_port	String	Optional	Parameter required for TCP and UDP check types: 0 - Monitoring check will be considered as UP if the port is closed, filtered or there is no successful connection 1 - Monitoring check will be considered as UP If the port is opened.
query_type	String	Optional	Parameter required for DNS check type. It must contain the record type (e.g. A).
query_response	String	Optional	Parameter required for DNS check type. You must fill in the response of the DNS server for this specific record.
check_period	Integer	Optional	Time-frame between each monitoring check. Possible values: 60 - 1 minute 120 - 2 minutes 300 - 5 minutes 600 - 10 minutes 900 - 15 minutes 1200 - 20 minutes 1800 - 30 minutes 3600 - 1 hour 10800 - 3 hours 21600 - 6 hours 43200 - 12 hours 86400 - 1 day
state	Integer	Optional	Default value is Active. Possible values: 0 - Paused 1 - Active
timeout	Integer	Optional	Seconds to wait for the server to reply. For Ping monitoring checks must be between 1 and 5. Default value is 2. For Web monitoring checks must be between 4 and 10. Default value is 5.
http_status_code	Integer	Required	HTTP status code the monitored server will return. It can be between 100 and 599.
content_match	String	Optional	Is the expected content an exact match or is it a keyword in the returned content from the server? The default value is - exact match. Possible values: exact keyword regex
custom_header	String	Optional	Custom header name for Web monitoring check. The header name must contain only Latin letters (upper and/or lowercase), dash, and/or underscore (a-zA-Z-_).
custom_header_value	String	Optional	Custom header value for Web monitoring check.
latency_limit	Double	Optional	Only for Ping monitoring checks. If the latency of the check is above the limit, the check will be marked as DOWN.
notification_period	Integer	Optional	Days before the expiration of the SSL when you will receive a notification. Default value is 1, 7, 15, 30 Days. Possible values: 1 - 1 Day 7 - 1, 7 Days 15 - 1, 7, 15 Days 30 - 1, 7, 15, 30 Days
cacert	String	Optional	Self Signed Root CA for TLS/SSL monitoring checks. Write your CA CERT.
http_request_type	String	Optional	Only for Web monitoring checks. The request type will be used for the check. The default value is GET. Possible values: GET HEAD POST PUT DELETE
ip_type	Integer	Optional	If you have entered a hostname for the IP/Host of the monitoring check, you can specify what IP type to be checked, IPv4, IPv6 or both if present. The default value is 1 - IPv4 and IPv6. Possible values: 1 - IPv4 and IPv6 2 - IPv4 only 3 - IPv6 only
url	String	Optional	Used for Streaming monitoring check type. Write the URL of the streaming service you want to be checked.
audio_threshold	Double	Optional	Used for Streaming monitoring check type. Enter a number between -91 and 0. If the volume is below that number the check will be marked as Down! If left empty the volume will not be considered!
connection_security	Integer	Optional	Used for SMTP monitoring check type. What security protocol the connection to be cheked for. Default value is 1 - None. Possible values: 1 - None 2 - STARTTLS 3 - SSL/TLS

Return: Status and message.

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 a missing, or invalid name, the following status will be returned:

{"status":"Failed","statusDescription":"Name is mandatory, it should be no longer than 32 characters and can only contain a-z, A-Z, 0-9, -, ., and space characters."}

If the value for "check_type" is missing, or invalid, the following status will be returned:

{"status":"Failed","statusDescription":"This is invalid monitoring type."}

If the value for "id" is missing, or invalid, the following status will be returned:

{"status":"Failed","statusDescription":"Missing monitoring record."}

If the value for "ip" is missing, or invalid, the following status will be returned:

{"status":"Failed","statusDescription":"Invalid IP address"}

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/monitoring/update.json
POST/GET: auth-id=0&auth-password=password&id=170&name=name&check_type=18&ip=127.0.0.1&host=cloudns.net&port=443&check_period=600

URL XML: https://api.cloudns.net/monitoring/update.xml
POST/GET: auth-id=0&auth-password=password&id=170&name=name&check_type=18&ip=127.0.0.1&host=cloudns.net&port=443&check_period=600

Last modified: 2025-01-21