Rest API Config endpoint for roles
Object type: role
Request URL: /rest/config/role
Example role:
{
"object" : {
"contacts" : [
{
"ref" : "/rest/config/contact/1",
"name" : "admin"
}
],
"monitoringservers" : [],
"hostgroups" : [
{
"ref" : "/rest/config/hostgroup/1",
"name" : "Opsview"
}
],
"name" : "Admin",
"id" : "10",
"description" : "quot;Administrator access",
"accesses" : [
{
"ref" : "/rest/config/access/1",
"name" : "VIEWALL"
},
{
"ref" : "/rest/config/access/14",
"name" : "PASSWORDSAVE"
}
],
"access_hostgroups": [],
"access_servicegroups": [],
"access_keywords" : [],
"all_hostgroups" : "0",
"all_servicegroups" : "0",
"all_keywords" : "0",
"all_monitoringservers" : "1",
"uncommitted" : "0"
}
}
If you add a parameter of “order=priority”, this will list the roles in the same order that the web page displays it. Without this parameter, the order is undefined, though usually by id.
Note: The reference to access is not currently available.
Note: From Opsview 3.11.0, the fields access_hostgroups, access_servicegroups, access_keywords, all_hostgroups, all_servicegroups and all_keywords are available, as this data is moved from the contact level.