Opsview 6.9.x End of Support
Opsview versions 6.9.x reached their End of Support (EOS) status at the end of January 2026, in accordance with our Support policy. As of this date, these versions no longer receive code fixes, security updates, maintenance releases, or backported changes.
The documentation for version 6.9.7 and earlier releases will remain accessible for reference, but it will no longer be updated or maintained. We strongly recommend upgrading to the latest supported version of Opsview to ensure continued support and access to the latest features and security enhancements.
Reload - Request Format
URL: /rest/reload
Requires RELOADVIEW. This also requires RELOADACCESS for the POST method.
GET— gets the status of reload.POST— initiates a synchronous reload. If reloading is successful, this returns200. If the reloading fails, this will return400with error messages. This will give a409response if a reload is already in progress.PUT— unimplementedDELETE— unimplemented
Parameters Copied
asynchronous— if set to 1, an asynchronous reload will be run. Use a GET request to poll to see if the reload has completed. Default 0.changelog— if a POST request and changelog is enabled, you must set the text to save otherwise an error will occur.
Returned data Copied
server_status— this is the state of the server.0— server running, with no warnings.1— server reloading.2— server not running.3— configuration error or critical error.4— warnings exist.
configuration_status— this is the state of the configuration.uptodate— all configuration changes have been applied.pending— at least one configuration change requires a reloadaverage_duration— number of seconds a reload normally takes, rounded up to nearest 10 seconds.lastupdated— epoch time for last configuration update.
auditlog_entries— number of audit log entries since last backup. This could be undefined.messages— array of messages, where each message is a hash (or dictionary) of strings.
If a reload is already in progress then the status code will be set to 409 with returned data of:
server_status— set to 1.messages— set to “Reload already running”.
Examples Copied
Fetch the current status Copied
$ opsview_rest --token-file /path/to/opsview_restapi_token --pretty GET reload
{
"auditlog_entries" : "0",
"average_duration" : "30",
"configuration_status" : "uptodate",
"lastupdated" : "1519680052",
"messages" : [
{
"detail" : "Missing required variable EMAIL for contact admin for notification method Email - ignoring this notification",
"monitoringserver" : "Master Monitoring Server",
"severity" : "warning"
},
{
"detail": "Missing required variable EMAIL for contact user for notification method Email - ignoring this notification",
"severity"; "warning",
"monitoringserver" : "Master Monitoring Server",
}
],
"server_status" : "4"
}
Initiate a reload with changelog enabled Copied
$ opsview_rest --token-file /path/to/opsview_restapi_token --pretty POST "reload?changelog=Creating new users"
{
"auditlog_entries" : "0",
"average_duration" : "30",
"configuration_status" : "uptodate",
"lastupdated" : "1519680351",
"messages" : [],
"server_status" : "0"
}