Access all API commands using the following general format:
https://<hostname>:<port>/api/<api_version>/<end_point>/<id>/<task> |
hostname
: the URI for the Uptime Infrastructure Monitor Controller installationport
: the Uptime Infrastructure Monitor Controller listener port, typically 9997api_version
: the version of the API to run commands against (see Version Control below)end_point
: the type of object you want to work with in Uptime Infrastructure Monitor (see Endpoints below)id
: the numerical ID of the object you are interested intask
: where supported, specific tasks to be executed against the provided objectAccessing the standard format URL using different HTTP methods produces different results on the target object:
POST
: add an object or trigger an actionPUT
: edit an objectDELETE
: delete an objectGET
: view the details of an objectAll returned results are provided in JSON format. Successfully completed requests return an HTTP code in the 200 range.
Authentication to the API is based on the basic HTTP basic authentication template: each request to the API must provide a username and password pair. To safeguard this information, all requests to the Uptime Infrastructure Monitor API must use SSL communication.
Each user in Uptime Infrastructure Monitor has access to the API. User-visibility and role-based permissions are applied to each API call, ensuring users are only able to access and modify the same information they would be able to access from the Uptime Infrastructure Monitor UI.
The version of the API you wish to access is embedded directly into the URL. Bug fixes and non-breaking feature changes are made without changing the version number. Major feature changes or breaking changes introduce a new version number. Backward support for previous API version is currently not defined.
Non-breaking changes include:
Breaking changes include:
Endpoints define the different types of Uptime Infrastructure Monitor objects that you can work with using the API. The currently supported endpoints include the following:
/elements
– Uptime Infrastructure Monitor Elements
/monitors
– Uptime Infrastructure Monitor service monitors
/groups
– Uptime Infrastructure Monitor Element groups
The following is a summary of presently available resources:
list all Elements and attached service monitors; display an Element's information and attached service monitors; display an Element's information and its current status:
|
update Element configuration:
|
add, delete Element:
|
list all service monitors; display a specific server monitor; display status information for a service monitor:
|
list all Element groups, member Elements, and monitors; list an Element group's member Elements and monitors; display the status of an Element group's member Elements and monitors:
|
If the provided command produces an error, an HTTP status in the 400 range is returned including a specific status code and a message with further details about the error. All error messages are returned in JSON format and look like the following:
{ "error" : "Required field missing" , "errorDescription" : null } |