[comment]: # aside: 1
[comment]: # translation:outdated
[comment]: # ({70c23b61-2135842b})
# Oggetto ruolo
I seguenti oggetti sono direttamente correlati all'API `role`.
[comment]: # ({/70c23b61-2135842b})
[comment]: # ({4c760d03-1708e020})
### Ruolo
L'oggetto ruolo ha le seguenti proprietà:
|Proprietà|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|roleid|ID|ID del ruolo.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*
- *obbligatoria* per le operazioni di aggiornamento|
|name|string|Nome del ruolo.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatoria* per le operazioni di creazione|
|type|integer|Tipo di utente.
Valori possibili:
1 - *(predefinito)* Utente;
2 - Admin;
3 - Super admin.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *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à](/manual/api/reference_commentary#property-behavior):
- *sola lettura*|
[comment]: # ({/4c760d03-1708e020})
[comment]: # ({28862318-8a9b3008})
### Regole del ruolo
L'oggetto delle regole del ruolo ha le seguenti proprietà:
|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|ui|array|Array di oggetti [elemento UI](object#ui-element).|
|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](object#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à](/manual/api/reference_commentary#property-behavior):
- *supportato* se `services.read.mode` è impostato su "0"|
|services.read.tag|object|Array di oggetti [tag del servizio](object#service-tag).
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à](/manual/api/reference_commentary#property-behavior):
- *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](object#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à](/manual/api/reference_commentary#property-behavior):
- *supportato* se `services.write.mode` è impostato su "0"|
|services.write.tag|object|Array di oggetti [tag del servizio](object#service-tag).
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à](/manual/api/reference_commentary#property-behavior):
- *supportato* se `services.write.mode` è impostato su "0"|
|modules|array|Array di oggetti [module](object#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](object#action).|
|actions.default\_access|integer|Indica se l'accesso alle nuove azioni è abilitato.
Valori possibili:
0 - Disabilitato;
1 - *(predefinito)* Abilitato.|
[comment]: # ({/28862318-8a9b3008})
[comment]: # ({b7519b73-006cdfb5})
#### Elemento dell'interfaccia utente
L'oggetto elemento dell'interfaccia utente ha le seguenti proprietà:
|Proprietà|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|name|string|Nome dell'elemento dell'interfaccia utente.
Valori possibili se `type` dell'oggetto [Role](#role) è impostato su "User", "Admin" o "Super admin":
`monitoring.dashboard` - *Dashboard*;
`monitoring.problems` - *Monitoraggio → Problemi*;
`monitoring.hosts` - *Monitoraggio → Host*;
`monitoring.latest_data` - *Monitoraggio → Dati più recenti*;
`monitoring.maps` - *Monitoraggio → Mappe*;
`services.services` - *Servizi → Servizi*;
`services.sla_report` - *Servizi → Report SLA*;
`inventory.overview` - *Inventario → Panoramica*;
`inventory.hosts` - *Inventario → Host*;
`reports.availability_report` - *Report → Report di disponibilità*;
`reports.top_triggers` - *Report → Top 100 trigger*.
Valori possibili se `type` dell'oggetto [Role](#role) è impostato su "Admin" o "Super admin":
`monitoring.discovery` - *Monitoraggio → Discovery*;
`services.sla` - *Servizi → SLA*;
`reports.scheduled_reports` - *Report → Report pianificati*;
`reports.notifications` - *Report → Notifiche*;
`configuration.template_groups` - *Raccolta dati → Gruppi di template*;
`configuration.host_groups` - *Raccolta dati → Gruppi di host*;
`configuration.templates` - *Raccolta dati → Template*;
`configuration.hosts` - *Raccolta dati → Host*;
`configuration.maintenance` - *Raccolta dati → Manutenzione*;
`configuration.discovery` - *Raccolta dati → Discovery*;
`configuration.trigger_actions` - *Avvisi → Azioni → Azioni trigger*;
`configuration.service_actions` - *Avvisi → Azioni → Azioni servizio*;
`configuration.discovery_actions` - *Avvisi → Azioni → Azioni discovery*;
`configuration.autoregistration_actions` - *Avvisi → Azioni → Azioni di autoregistrazione*;
`configuration.internal_actions` - *Avvisi → Azioni → Azioni interne*.
Valori possibili se `type` dell'oggetto [Role](#role) è impostato su "Super admin":
`reports.system_info` - *Report → Informazioni di sistema*;
`reports.audit` - *Report → Log di audit*;
`reports.action_log` - *Report → Log delle azioni*;
`configuration.event_correlation` - *Raccolta dati → Correlazione eventi*;
`administration.media_types` - *Avvisi → Tipi di supporto*;
`administration.scripts` - *Avvisi → Script*;
`administration.user_groups` - *Utenti → Gruppi di utenti*;
`administration.user_roles` - *Utenti → Ruoli utente*;
`administration.users` - *Utenti → Utenti*;
`administration.api_tokens` - *Utenti → Token API*;
`administration.authentication` - *Utenti → Autenticazione*;
`administration.general` - *Amministrazione → Generale*;
`administration.audit_log` - *Amministrazione → Log di audit*;
`administration.housekeeping` - *Amministrazione → Housekeeping*;
`administration.proxy_groups` - *Amministrazione → Gruppi proxy*;
`administration.proxies` - *Amministrazione → Proxy*;
`administration.macros` - *Amministrazione → Macro*;
`administration.queue` - *Amministrazione → Coda*.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatoria*|
|status|integer|Indica se l'accesso all'elemento dell'interfaccia utente è abilitato.
Valori possibili:
0 - Disabilitato;
1 - *(predefinito)* Abilitato.|
[comment]: # ({/b7519b73-006cdfb5})
[comment]: # ({e891a8d2-ebf4bb3a})
#### Servizio
|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|serviceid|ID|ID del servizio.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatorio*|
[comment]: # ({/e891a8d2-ebf4bb3a})
[comment]: # ({62d78428-300e6d5b})
#### Tag del servizio
|Property|[Type](/manual/api/reference_commentary#data-types)|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à](/manual/api/reference_commentary#property-behavior):
- *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.|
[comment]: # ({/62d78428-300e6d5b})
[comment]: # ({bdcf5af8-f70e75e9})
#### Modulo
L'oggetto modulo ha le seguenti proprietà:
|Proprietà|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|moduleid|ID|ID del modulo.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatorio*|
|status|integer|Indica se l'accesso al modulo è abilitato.
Valori possibili:
0 - Disabilitato;
1 - *(predefinito)* Abilitato.|
[comment]: # ({/bdcf5af8-f70e75e9})
[comment]: # ({17265016-957a00bb})
#### Azione
L'oggetto action ha le seguenti proprietà:
|Proprietà|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|name|string|Nome dell'azione.
Valori possibili se `type` dell'oggetto [Role](#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](#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](#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](#role) è impostato su "Super admin":
`edit_user_media` - Consente di creare/modificare i media per gli utenti.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatoria*|
|status|integer|Indica se l'accesso per eseguire l'azione è abilitato.
Valori possibili:
0 - Disabilitato;
1 - *(predefinito)* Abilitato.|
[comment]: # ({/17265016-957a00bb})