Skip to main content

JSON objects

Response objects

Healthcheck

NameTypeDefault valueDescription
uuidStringThe health check uuid
nameStringThe name of the health check
statusStringThe status of the health check
Allowed values :
  • INSTALLING: The probes are currently determining the initial status of the health check. During this process, the status is considered HEALTHY
  • HEALTHY: The majority of probes are able to establish a connection with the endpoint
  • UNHEALTHY: The majority of probes are unable to establish a connection with the endpoint
customer_idIntegerThe customer ID associated with the health check
protocolStringThe protocol used by the health check
Allowed values :
  • TCP: The probes try to establish a TCP connection
  • HTTP: The probes submit an HTTP request and wait for an HTTP status code of 2xx
  • HTTPS: The probes submit an HTTPS request and wait for an HTTP status code of 2xx. By default, the certificate validity is not verified
targetStringThe target of the health check. You can specify the target using an IP address (IPV4, IPV6), a domain or a specific URL
portIntegerThe port used to establish the connection
frequencyIntegerTime interval (in seconds) between checks
created_atString (date-time)The creation date of the health check
created_byStringThe user who created the health check
modified_atString (date-time)The last modification date of the health check
modified_byStringThe last user who modified the health check
http_server_addressStringIP address used to establish the connection. Available only for HTTP and HTTPS health checks. By default, the IP address is obtained by resolving the domain specified in the target field
verify_sslBooleanEnable the verification of the SSL/TLS certificate validity. Available only for HTTPS health checks

HealthcheckAlert

NameTypeDefault valueDescription
idIntegerThe alert ID
typeStringType of alert.
Allowed values :
  • EMAIL
recipientsArrayList of alert recipients
created_atString (date-time)The creation date of the alert
created_byStringThe user who created the alert
modified_atString (date-time)The last modification date of the alert
modified_byStringThe last user who modified the alert

HealthcheckSearchResults

NameTypeDefault valueDescription
totalIntegerTotal number of health checks matching the search criteria
limitInteger100Number of health checks returned
offsetInteger0Offset used
resultsList of HealthcheckList of health checks matching the search criteria

Input objects

InputHealthcheck

NameTypeDefault valueDescription
nameStringThe name of the health check
customer_idIntegerThe customer ID associated with the health check
protocolStringThe protocol used by the health check
Allowed values :
  • TCP: The probes try to establish a TCP connection
  • HTTP: The probes submit an HTTP request and wait for an HTTP status code of 2xx
  • HTTPS: The probes submit an HTTPS request and wait for an HTTP status code of 2xx. By default, the certificate validity is not verified
targetStringThe target of the health check. You can specify the target using an IP address (IPV4, IPV6), a domain or a specific URL
portIntegerThe port used to establish the connection
frequencyIntegerTime interval (in seconds) between checks
http_server_addressStringIP address used to establish the connection. Available only for HTTP and HTTPS health checks. By default, the IP address is obtained by resolving the domain specified in the target field
verify_sslBooleanEnable the verification of the SSL/TLS certificate validity. Available only for HTTPS health checks

InputHealthcheckAlert

NameRequiredTypeDefault valueDescription
typeYesStringType of alert.
Allowed values :
  • EMAIL
recipientsYesArrayList of alert recipients