Šajā lapā
role.get
Apraksts
integer/array role.get(object parameters)
Šī metode ļauj izgūt lomas atbilstoši norādītajiem parametriem.
Šī metode ir pieejama jebkura tipa lietotājiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet Lietotāju lomas.
Parametri
(object) Parametri, kas nosaka vēlamo izvadi.
Metode atbalsta šādus parametrus.
| Parameter | Type | Description |
|---|---|---|
| roleids | ID/array | Atgriež tikai lomas ar norādītajiem ID. |
| current | boolean | Ja iestatīts uz true, atgriež tikai pašreizējā lietotāja lomu. |
| selectRules | query | Atgriež rules rekvizītu ar lomas noteikumiem. |
| selectUsers | query | Atgriež users rekvizītu ar lietotājiem, kuriem ir piešķirta šī loma.Skatiet user.get, lai uzzinātu par ierobežojumiem, kas balstīti uz lietotāja tipu. |
| sortfield | string/array | Kārto rezultātu pēc norādītajiem rekvizītiem. Iespējamās vērtības: roleid, name. |
| countOutput | boolean | Šie parametri ir aprakstīti atsauces komentāros. |
| editable | boolean | |
| excludeSearch | boolean | |
| filter | object | |
| limit | integer | |
| output | query | |
| preservekeys | boolean | |
| search | object | |
| searchByAny | boolean | |
| searchWildcardsEnabled | boolean | |
| sortorder | string/array | |
| startSearch | boolean |
Atgrieztās vērtības
(integer/array) Atgriež vienu no šīm vērtībām:
- objektu masīvu;
- izgūto objektu skaitu, ja ir izmantots parametrs
countOutput.
Piemēri
Lomas datu izgūšana
Izgūstiet lomas "Super admin role" datus un tās piekļuves noteikumus.
{
"jsonrpc": "2.0",
"method": "role.get",
"params": {
"output": "extend",
"selectRules": "extend",
"roleids": "3"
},
"id": 1
}Atbilde:
{
"jsonrpc": "2.0",
"result": [
{
"roleid": "3",
"name": "Super admin role",
"type": "3",
"readonly": "1",
"rules": {
"ui": [
{
"name": "monitoring.dashboard",
"status": "1"
},
{
"name": "monitoring.problems",
"status": "1"
},
{
"name": "monitoring.hosts",
"status": "1"
},
{
"name": "monitoring.latest_data",
"status": "1"
},
{
"name": "monitoring.maps",
"status": "1"
},
{
"name": "services.services",
"status": "1"
},
{
"name": "services.sla_report",
"status": "1"
},
{
"name": "inventory.overview",
"status": "1"
},
{
"name": "inventory.hosts",
"status": "1"
},
{
"name": "reports.availability_report",
"status": "1"
},
{
"name": "reports.top_triggers",
"status": "1"
},
{
"name": "monitoring.discovery",
"status": "1"
},
{
"name": "services.sla",
"status": "1"
},
{
"name": "reports.scheduled_reports",
"status": "1"
},
{
"name": "reports.notifications",
"status": "1"
},
{
"name": "configuration.template_groups",
"status": "1"
},
{
"name": "configuration.host_groups",
"status": "1"
},
{
"name": "configuration.templates",
"status": "1"
},
{
"name": "configuration.hosts",
"status": "1"
},
{
"name": "configuration.maintenance",
"status": "1"
},
{
"name": "configuration.discovery",
"status": "1"
},
{
"name": "configuration.trigger_actions",
"status": "1"
},
{
"name": "configuration.service_actions",
"status": "1"
},
{
"name": "configuration.discovery_actions",
"status": "1"
},
{
"name": "configuration.autoregistration_actions",
"status": "1"
},
{
"name": "configuration.internal_actions",
"status": "1"
},
{
"name": "reports.system_info",
"status": "1"
},
{
"name": "reports.audit",
"status": "1"
},
{
"name": "reports.action_log",
"status": "1"
},
{
"name": "configuration.event_correlation",
"status": "1"
},
{
"name": "administration.media_types",
"status": "1"
},
{
"name": "administration.scripts",
"status": "1"
},
{
"name": "administration.user_groups",
"status": "1"
},
{
"name": "administration.user_roles",
"status": "1"
},
{
"name": "administration.users",
"status": "1"
},
{
"name": "administration.api_tokens",
"status": "1"
},
{
"name": "administration.authentication",
"status": "1"
},
{
"name": "administration.general",
"status": "1"
},
{
"name": "administration.audit_log",
"status": "1"
},
{
"name": "administration.housekeeping",
"status": "1"
},
{
"name": "administration.proxy_groups",
"status": "1"
},
{
"name": "administration.proxies",
"status": "1"
},
{
"name": "administration.macros",
"status": "1"
},
{
"name": "administration.queue",
"status": "1"
}
],
"ui.default_access": "1",
"services.read.mode": "1",
"services.read.list": [],
"services.read.tag": {
"tag": "",
"value": ""
},
"services.write.mode": "1",
"services.write.list": [],
"services.write.tag": {
"tag": "",
"value": ""
},
"modules": [
{
"moduleid": 1,
"status": "1"
},
{
"moduleid": 2,
"status": "1"
},
{
"moduleid": 3,
"status": "1"
},
{
"moduleid": 4,
"status": "1"
},
{
"moduleid": 5,
"status": "1"
},
{
"moduleid": 6,
"status": "1"
},
{
"moduleid": 7,
"status": "1"
},
{
"moduleid": 8,
"status": "1"
},
{
"moduleid": 9,
"status": "1"
},
{
"moduleid": 10,
"status": "1"
},
{
"moduleid": 11,
"status": "1"
},
{
"moduleid": 12,
"status": "1"
},
{
"moduleid": 13,
"status": "1"
},
{
"moduleid": 14,
"status": "1"
},
{
"moduleid": 15,
"status": "1"
},
{
"moduleid": 16,
"status": "1"
},
{
"moduleid": 17,
"status": "1"
},
{
"moduleid": 18,
"status": "1"
},
{
"moduleid": 19,
"status": "1"
},
{
"moduleid": 20,
"status": "1"
},
{
"moduleid": 21,
"status": "1"
},
{
"moduleid": 22,
"status": "1"
},
{
"moduleid": 23,
"status": "1"
},
{
"moduleid": 24,
"status": "1"
},
{
"moduleid": 25,
"status": "1"
},
{
"moduleid": 26,
"status": "1"
},
{
"moduleid": 27,
"status": "1"
},
{
"moduleid": 28,
"status": "1"
},
{
"moduleid": 29,
"status": "1"
},
{
"moduleid": 30,
"status": "1"
},
{
"moduleid": 31,
"status": "1"
},
{
"moduleid": 32,
"status": "1"
},
{
"moduleid": 33,
"status": "1"
}
],
"modules.default_access": "1",
"api.access": "1",
"api.mode": "0",
"api": [],
"actions": [
{
"name": "edit_dashboards",
"status": "1"
},
{
"name": "edit_maps",
"status": "1"
},
{
"name": "acknowledge_problems",
"status": "1"
},
{
"name": "suppress_problems",
"status": "1"
},
{
"name": "close_problems",
"status": "1"
},
{
"name": "change_severity",
"status": "1"
},
{
"name": "add_problem_comments",
"status": "1"
},
{
"name": "execute_scripts",
"status": "1"
},
{
"name": "manage_api_tokens",
"status": "1"
},
{
"name": "edit_maintenance",
"status": "1"
},
{
"name": "manage_scheduled_reports",
"status": "1"
},
{
"name": "manage_sla",
"status": "1"
},
{
"name": "invoke_execute_now",
"status": "1"
},
{
"name": "change_problem_ranking",
"status": "1"
},
{
"name": "edit_own_media",
"status": "1"
},
{
"name": "edit_user_media",
"status": "1"
}
],
"actions.default_access": "1"
}
}
],
"id": 1
}Skatiet arī
Avots
CRole::get() failā ui/include/classes/api/services/CRole.php.