Oggetto ruolo

I seguenti oggetti sono direttamente correlati all'API role.

Ruolo

L'oggetto ruolo ha le seguenti proprietà:

Proprietà Tipo Descrizione
roleid ID ID del ruolo.

Comportamento della proprietà:
- sola lettura
- obbligatoria per le operazioni di aggiornamento
name string Nome del ruolo.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
type integer Tipo di utente.

Valori possibili:
1 - (predefinito) Utente;
2 - Admin;
3 - Super admin.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
readonly integer Indica se il ruolo è di sola lettura.

Valori possibili:
0 - (predefinito) No;
1 - Sì.

Comportamento della proprietà:
- sola lettura

Regole del ruolo

L'oggetto delle regole del ruolo ha le seguenti proprietà:

Proprietà Type Descrizione
ui array Array di oggetti elemento UI.
ui.default_access integer Indica se l'accesso ai nuovi elementi UI è abilitato.

Valori possibili:
0 - Disabilitato;
1 - (predefinito) Abilitato.
services.read.mode integer Accesso in sola lettura ai servizi.

Valori possibili:
0 - Accesso in sola lettura ai servizi specificati dalla proprietà services.read.list o corrispondenti alla proprietà services.read.tag;
1 - (predefinito) Accesso in sola lettura a tutti i servizi.
services.read.list array Array di oggetti Service.

Ai servizi specificati, inclusi i servizi figli, verrà concesso l'accesso in sola lettura per il ruolo utente. L'accesso in sola lettura non sovrascriverà l'accesso in lettura-scrittura ai servizi.

Comportamento della proprietà:
- supportato se services.read.mode è impostato su "0"
services.read.tag object Array di oggetti tag del servizio.

Ai servizi corrispondenti al tag, inclusi i servizi figli, verrà concesso l'accesso in sola lettura per il ruolo utente. L'accesso in sola lettura non sovrascriverà l'accesso in lettura-scrittura ai servizi.

Comportamento della proprietà:
- supportato se services.read.mode è impostato su "0"
services.write.mode integer Accesso in lettura-scrittura ai servizi.

Valori possibili:
0 - (predefinito) Accesso in lettura-scrittura ai servizi specificati dalla proprietà services.write.list o corrispondenti alla proprietà services.write.tag;
1 - Accesso in lettura-scrittura a tutti i servizi.
services.write.list array Array di oggetti Service.

Ai servizi specificati, inclusi i servizi figli, verrà concesso l'accesso in lettura-scrittura per il ruolo utente. L'accesso in lettura-scrittura sovrascriverà l'accesso in sola lettura ai servizi.

Comportamento della proprietà:
- supportato se services.write.mode è impostato su "0"
services.write.tag object Array di oggetti tag del servizio.

Ai servizi corrispondenti al tag, inclusi i servizi figli, verrà concesso l'accesso in lettura-scrittura per il ruolo utente. L'accesso in lettura-scrittura sovrascriverà l'accesso in sola lettura ai servizi.

Comportamento della proprietà:
- supportato se services.write.mode è impostato su "0"
modules array Array di oggetti module.
modules.default_access integer Indica se l'accesso ai nuovi moduli è abilitato.

Valori possibili:
0 - Disabilitato;
1 - (predefinito) Abilitato.
api.access integer Indica se l'accesso all'API è abilitato.

Valori possibili:
0 - Disabilitato;
1 - (predefinito) Abilitato.
api.mode integer Modalità di gestione dei metodi API elencati nella proprietà api.

Valori possibili:
0 - (predefinito) Elenco di negazione;
1 - Elenco di autorizzazione.
api array Array di metodi API.
actions array Array di oggetti action.
actions.default_access integer Indica se l'accesso alle nuove azioni è abilitato.

Valori possibili:
0 - Disabilitato;
1 - (predefinito) Abilitato.

Elemento UI

L'oggetto elemento UI ha le seguenti proprietà:

Property Type Description
name string Nome dell'elemento UI.

Valori possibili se type dell'oggetto Role è impostato su "User", "Admin" o "Super admin":
monitoring.dashboard - Dashboards;
monitoring.problems - Monitoring > Problems;
monitoring.hosts - Monitoring > Hosts;
monitoring.latest_data - Monitoring > Latest data;
monitoring.maps - Monitoring > Maps;
services.services - Services > Services;
services.sla_report - Services > SLA report;
inventory.overview - Inventory > Overview;
inventory.hosts - Inventory > Hosts;
reports.availability_report - Reports > Availability report;
reports.top_triggers - Reports > Triggers top 100.

Valori possibili se type dell'oggetto Role è impostato su "Admin" o "Super admin":
monitoring.discovery - Monitoring > Discovery;
services.sla - Services > SLA;
reports.scheduled_reports - Reports > Scheduled reports;
reports.notifications - Reports > Notifications;
configuration.template_groups - Data collection > Template groups;
configuration.host_groups - Data collection > Host groups;
configuration.templates - Data collection > Templates;
configuration.hosts - Data collection > Hosts;
configuration.maintenance - Data collection > Maintenance;
configuration.discovery - Data collection > Discovery;
configuration.trigger_actions - Alerts > Actions > Trigger actions;
configuration.service_actions - Alerts > Actions > Service actions;
configuration.discovery_actions - Alerts > Actions > Discovery actions;
configuration.autoregistration_actions - Alerts > Actions > Autoregistration actions;
configuration.internal_actions - Alerts > Actions > Internal actions.

Valori possibili se type dell'oggetto Role è impostato su "Super admin":
reports.system_info - Reports > System information;
reports.audit - Reports > Audit log;
reports.action_log - Reports > Action log;
configuration.event_correlation - Data collection > Event correlation;
administration.media_types - Alerts > Media types;
administration.scripts - Alerts > Scripts;
administration.user_groups - Users > User groups;
administration.user_roles - Users > User roles;
administration.users - Users > Users;
administration.api_tokens - Users > API tokens;
administration.authentication - Users > Authentication;
administration.general - Administration > General;
administration.audit_log - Administration > Audit log;
administration.housekeeping - Administration > Housekeeping;
administration.proxy_groups - Administration > Proxy groups;
administration.proxies - Administration > Proxies;
administration.macros - Administration > Macros;
administration.queue - Administration > Queue.

Comportamento della proprietà:
- required
status integer Se l'accesso all'elemento UI è abilitato.

Valori possibili:
0 - Disabilitato;
1 - (default) Abilitato.

Servizio

Proprietà Type Descrizione
serviceid ID ID del servizio.

Comportamento della proprietà:
- obbligatorio

Tag del servizio

Property Type Description
tag string Nome del tag.

Se viene specificata una stringa vuota, il tag del servizio non verrà utilizzato per la corrispondenza del servizio.

Comportamento della proprietà:
- obbligatorio
value string Valore del tag.

Se non viene specificato alcun valore o viene specificata una stringa vuota, per la corrispondenza del servizio verrà utilizzato solo il nome del tag.

Modulo

L'oggetto modulo ha le seguenti proprietà:

Proprietà Tipo Descrizione
moduleid ID ID del modulo.

Comportamento della proprietà:
- obbligatorio
status integer Indica se l'accesso al modulo è abilitato.

Valori possibili:
0 - Disabilitato;
1 - (predefinito) Abilitato.

Azione

L'oggetto action ha le seguenti proprietà:

Proprietà Tipo Descrizione
name string Nome dell'azione.

Valori possibili se type dell'oggetto Role è impostato su "User", "Admin" o "Super admin":
edit_dashboards - Crea e modifica dashboard;
edit_maps - Crea e modifica mappe;
add_problem_comments - Aggiunge commenti ai problemi;
change_severity - Modifica la gravità del problema;
acknowledge_problems - Riconosce i problemi;
suppress_problems - Sopprime i problemi;
close_problems - Chiude i problemi;
execute_scripts - Esegue script;
manage_api_tokens - Gestisce i token API;
change_problem_ranking - Modifica la classificazione del problema da causa a sintomo e viceversa;
edit_own_media - Consente di creare/modificare i propri media.

Valori possibili se type dell'oggetto Role è impostato su "Admin" o "Super admin":
edit_maintenance - Crea e modifica periodi di manutenzione;
manage_scheduled_reports - Gestisce i report pianificati,
manage_sla - Gestisce gli SLA.

Valori possibili se type dell'oggetto Role è impostato su "User" o "Admin":
invoke_execute_now - consente di eseguire i controlli degli item agli utenti che hanno solo permessi di lettura sul host.

Valori possibili se type dell'oggetto Role è impostato su "Super admin":
edit_user_media - Consente di creare/modificare i media per gli utenti.

Comportamento della proprietà:
- obbligatoria
status integer Indica se l'accesso per eseguire l'azione è abilitato.

Valori possibili:
0 - Disabilitato;
1 - (predefinito) Abilitato.