[comment]: # translation:outdated

[comment]: # ({2135842b-2135842b})
# > Objet Rôle

Les objets suivants sont directement liés à l'API `role`.

[comment]: # ({/2135842b-2135842b})

[comment]: # ({f727ed1f-1708e020})
### Rôle

L'objet rôle a les propriétés suivantes :

|Propriété|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|roleid|string|*(lecture seule)* ID du rôle.|
|**name**<br>(obligatoire)|string|Nom du rôle.|
|**type**<br>(obligatoire)|integer|Type d'utilisateur.<br><br>Valeurs possibles :<br>1 - *(par défaut)* Utilisateur;<br>2 - Administrateur;<br>3 - Super administrateur.|
|readonly|integer|*(lecture seule)* Indique si le rôle est en lecture seule.<br><br>Valeurs possibles :<br>0 - *(par défaut)* Non;<br>1 - Oui.|

Notez que pour certaines méthodes (mise à jour, suppression) la combinaison de paramètres requise/optionnelle est différente.

[comment]: # ({/f727ed1f-1708e020})

[comment]: # ({bfa4b7e4-8a9b3008})

### Règles de rôle

L'objet de règles de rôle a les propriétés suivantes :

|Propriété|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|ui|array|Tableau d\'objets [élément UI](object#ui_element).|
|ui.default\_access|integer|Indique si l'accès aux nouveaux éléments de l'interface utilisateur est activé.<br><br>Valeurs possibles :<br>0 - Désactivé ;<br>1 - *(par défaut)* Activé.|
|services.read.mode|integer|Accès en lecture seule aux services.<br><br>Valeurs possibles :<br><br>0 - Accès en lecture seule aux services, spécifié par la propriété `services.read.list` ou correspondant à la propriété `services.read.tag`.<br>1 - *(par défaut)* Accès en lecture seule à tous les services.|
|services.read.list|array|Tableau d'objets [Service](object#service).<br><br>Les services spécifiés, y compris les services enfants, se verront accorder un accès en lecture seule au rôle d'utilisateur. L'accès en lecture seule ne remplacera pas l'accès en lecture-écriture aux services.<br><br>Utilisé uniquement si `services.read.mode` est défini sur 0.|
|services.read.tag|object|Tableau d'objets [tag de service](object#service_tag).<br><br>Les services correspondant au(x) tag(s), y compris les services enfants, se verront accorder un accès en lecture seule au rôle d'utilisateur. L'accès en lecture seule ne remplacera pas l'accès en lecture-écriture aux services.<br><br>Utilisé uniquement si `services.read.mode` est défini sur 0.|
|services.write.mode|integer|Accès en lecture-écriture aux services.<br><br>Valeurs possibles :<br><br>0 - (par défaut) Accès en lecture-écriture aux services, spécifié par la propriété `services.write.list` ou correspondant à la propriété `services.write.tag`.<br>1 - Accès en lecture-écriture à tous les services.|
|services.write.list|array|Tableau d'objets [Service](object#service).<br><br>Les services spécifiés, y compris les services enfants, se verront accorder un accès en lecture-écriture au rôle d'utilisateur. L'accès en lecture-écriture remplacera l'accès en lecture seule aux services.<br><br>Utilisé uniquement si `services.write.mode` est défini sur 0.|
|services.write.tag|object|Tableau d'objets [tag de service](object#service_tag).<br><br>Les services correspondant au(x) tag(s), y compris les services enfants, se verront accorder un accès en lecture-écriture au rôle d'utilisateur. L'accès en lecture-écriture remplacera l'accès en lecture seule aux services.<br><br>Utilisé uniquement si `services.write.mode` est défini sur 0.|
|modules|array|Tableau d'objets [module](object#module).|
|modules.default\_access|integer|Indique si l'accès aux nouveaux modules est activé.<br><br>Valeurs possibles :<br>0 - Désactivé ;<br>1 - *(par défaut)* Activé.|
|api.access|integer|Indique si l'accès à l'API est activé.<br><br>Valeurs possibles :<br>0 - Désactivé ;<br>1 - *(par défaut)* Activé.|
|api.mode|integer|Mode de traitement les méthodes API répertoriées dans la propriété `api`.<br><br>Valeurs possibles :<br>0 - *(par défaut)* Liste de refus ;<br>1 - Liste d'autorisation.|
|api|array|Tableau de méthodes API.|
|actions|array|Tableau d'objets [action](objet#action).|
|actions.default\_access|integer|Indique si l'accès aux nouvelles actions est activé.<br><br>Valeurs possibles :<br>0 - Désactivé ;<br>1 - *(par défaut)* Activé.|

[comment]: # ({/bfa4b7e4-8a9b3008})

[comment]: # ({1262d126-006cdfb5})

### Elémént UI

L'objet d'élément d'interface utilisateur possède les propriétés suivantes :

|Propriété|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|**name**<br>(obligatoire)|string|Nom de l'élément UI.<br><br>Valeurs possibles pour tout type d'utilisateur :<br>`monitoring.dashboard` - *Surveillance → Tableaux de bord*;<br>`monitoring.problems` - *Surveillance → Problèmes*;<br>`monitoring.hosts` - *Surveillance → Hôtes*;<br>`monitoring.latest_data` - *Surveillance → Dernières données*;<br>`monitoring.maps` - *Surveillance → Cartes*;<br>`services.services` - *Services → Services*;<br>`services.sla_report` - *Services → Rapport SLA*;<br>`inventory.overview` - *Inventaire → Aperçu*;<br>`inventory.hosts` - *Inventaire → Hôtes*;<br>`reports.availability_report` - *Rapports → Rapport de disponibilité*;<br>`reports.top_triggers` - *Rapports → TOP 100 des déclencheurs*.<br><br>Valeurs possibles uniquement pour les utilisateurs de types d'utilisateurs *Admin* et *Super admin* :<br>`monitoring.discovery` - *Surveillance → Découverte*;<br>`services.actions` - *Services → Actions de service*;<br>`services.sla` - *Services → SLA*;<br>`reports.scheduled_reports` - *Rapports → Rapports planifiés*;<br>`reports.notifications` - *Rapports → Notifications*;<br>`configuration.host_groups` - *Configuration → Groupes d'hôte*;<br>`configuration.templates` - *Configuration → Modèles*;<br>`configuration.hosts` - *Configuration → Hôtes*;<br>`configuration.maintenance` - *Configuration → Maintenance*;<br>`configuration.actions` - *Configuration → Actions*;<br>`configuration.discovery` - *Configuration → Découverte*.<br><br>Valeurs possibles uniquement pour les utilisateurs de type *Super admin* :<br>`reports.system_info` - *Rapports → Information système*;<br>`reports.audit` - *Rapports → Audit*;<br>`reports.action_log` - *Rapports → Action log*;<br>`configuration.event_correlation` - *Configuration → Corrélation d'événements*;<br>`administration.general` - *Administration → Général*;<br>`administration.proxies` - *Administration → Proxies*;<br>`administration.authentication` - *Administration → Authentification*;<br>`administration.user_groups` - *Administration → Groupes utilisateur*;<br>`administration.user_roles` - *Administration → Rôles utilisateur*;<br>`administration.users` - *Administration → Utilisateurs*;<br>`administration.media_types` - *Administration → Types de media*;<br>`administration.scripts` - *Administration → Scripts*;<br>`administration.queue` - *Administration → File d'attente*.|
|status|integer|Indique si l'accès à l'élément de l'interface utilisateur est activé.<br><br>Valeurs possibles :<br>0 - Désactivé ;<br>1 - *(par défaut)* Activé.|

[comment]: # ({/1262d126-006cdfb5})

[comment]: # ({151b404b-ebf4bb3a})
### Service

|Propriété|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|**serviceid**<br>(obligatoire)|ID du service.|

[comment]: # ({/151b404b-ebf4bb3a})

[comment]: # ({d55c3cab-300e6d5b})
### Tag de service

|Propriété|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|**tag**<br>(obligatoire)|string|Nom de tag.<br><br>Si une chaîne vide est spécifiée, le tag de service ne sera pas utilisé pour la correspondance de service.|
|value|string|Valeur de tag.<br><br>Si aucune valeur ou une chaîne vide est spécifiée, seul le nom du tag sera utilisé pour la correspondance de service.|

[comment]: # ({/d55c3cab-300e6d5b})

[comment]: # ({47f1d6aa-f70e75e9})
### Module

L'objet module a les propriétés suivantes :

|Propriété|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|**moduleid**<br>(obligatoire)|string|ID du module.|
|status|integer|Indique si l'accès au module est activé.<br><br>Valeurs possibles :<br>0 - Désactivé;<br>1 - *(par défaut)* Activé.|

[comment]: # ({/47f1d6aa-f70e75e9})

[comment]: # ({39949519-957a00bb})
### Action

L'objet action a les propriétés suivantes :

|Propriété|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|**nom**<br>(obligatoire)|string|Nom de l'action.<br><br>Valeurs possibles pour les utilisateurs de tout type :<br>`edit_dashboards` - Créer et modifier des tableaux de bord ;<br>` edit_maps` - Créer et modifier des cartes ;<br>`add_problem_comments` - Ajouter des commentaires sur les problèmes ;<br>`change_severity` - Modifier la sévérité du problème ;<br>`acknowledge_problems` - Acquitter les problèmes ;<br>`close_problems` - Fermer les problèmes ; <br>`execute_scripts` - Exécuter des scripts ;<br>`manage_api_tokens` - Gère les jetons d'API.<br><br>Valeurs possibles uniquement pour les utilisateurs de types d'utilisateurs *Admin* et *Super admin* :<br>`edit_maintenance` - Créer et modifier des maintenances ;<br>`manage_scheduled_reports` - Gérer les rapports planifiés.|
|status|integer|Indique si l'accès pour effectuer l'action est activé.<br><br>Valeurs possibles :<br>0 - Désactivé ;<br>1 - *(par défaut)* Activé.|

[comment]: # ({/39949519-957a00bb})
