Welcome to docs.opsview.com

Opsview Community is deprecated - read more here. Showing the most current documentation for Opsview Core

REST API: Re-checks

This will be available from Opsview 3.13.0.

URL: /rest/recheck. This requires authentication. Requires ACTIONSOME or ACTIONALL access.

  • GET - lists all hosts and services that can be re-checked based on user permissions
  • POST - submit an recheck request
  • PUT, DELETE - not implemented

Access Control

ACTIONALL allows submitting a recheck to any object in Opsview.

ACTIONSOME allows submitting a recheck to host or services based on the access object selection.

Note: If a user has ACTIONALL, but only VIEWSOME, the user could submit rechecks for objects that they cannot view.

Listing Services for Re-checking

You will get a list of services, same as /rest/status/service, but with the following filtering:

  • only objects that the user will have access to recheck will be listed

See the status API for details of the search parameters and the output.

Requesting a Re-check

Re-checks are set asynchronously, so the REST API will return as soon as the submission is entered. There maybe a small delay before the result is displayed in the user interface.

On successful submission of re-checks, the response will be of the form:

 summary => { 
  num_hosts => ...., 
  num_services => ....,
 list => {
  hosts => [
   { id => ..., hostname => .... },
  services => [
   { id => ..., hostname => ..., servicename => ... },

This reflects the number of hosts and services that this re-check applied to.

In the event of a failure, the response will be:

 message => ..., 
 detail => ....,

Where message will be one of:

  • No objects chosen for recheck (this could also appear if the user does not have access to the objects specified)
  • Errors setting recheck - some objects may have been rechecked
  • Error when searching for objects

Object Selection


You can use the below example call to force a recheck of all services against a given host

./opsview_rest --pretty --username=USERNAME --password=PASSWORD POST "recheck?hostname=HOSTNAME&servicename=%"