> Objet Rôle

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

Rôle

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

Propriété	Type	Description
roleid	string	(lecture seule) ID du rôle.
name (obligatoire)	string	Nom du rôle.
type (obligatoire)	integer	Type d'utilisateur. Valeurs possibles : 1 - (par défaut) Utilisateur; 2 - Administrateur; 3 - Super administrateur.
readonly	integer	(lecture seule) Indique si le rôle est en lecture seule. Valeurs possibles : 0 - (par défaut) Non; 1 - Oui.

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

Règles de rôle

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

Propriété	Type	Description
ui	array	Tableau d'objets élément UI.
ui.default_access	integer	Indique si l'accès aux nouveaux éléments de l'interface utilisateur est activé. Valeurs possibles : 0 - Désactivé ; 1 - (par défaut) Activé.
services.read.mode	integer	Accès en lecture seule aux services. Valeurs possibles : 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`. 1 - (par défaut) Accès en lecture seule à tous les services.
services.read.list	array	Tableau d'objets Service. 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. Utilisé uniquement si `services.read.mode` est défini sur 0.
services.read.tag	object	Tableau d'objets tag de service. 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. Utilisé uniquement si `services.read.mode` est défini sur 0.
services.write.mode	integer	Accès en lecture-écriture aux services. Valeurs possibles : 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`. 1 - Accès en lecture-écriture à tous les services.
services.write.list	array	Tableau d'objets Service. 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. Utilisé uniquement si `services.write.mode` est défini sur 0.
services.write.tag	object	Tableau d'objets tag de service. 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. Utilisé uniquement si `services.write.mode` est défini sur 0.
modules	array	Tableau d'objets module.
modules.default_access	integer	Indique si l'accès aux nouveaux modules est activé. Valeurs possibles : 0 - Désactivé ; 1 - (par défaut) Activé.
api.access	integer	Indique si l'accès à l'API est activé. Valeurs possibles : 0 - Désactivé ; 1 - (par défaut) Activé.
api.mode	integer	Mode de traitement les méthodes API répertoriées dans la propriété `api`. Valeurs possibles : 0 - (par défaut) Liste de refus ; 1 - Liste d'autorisation.
api	array	Tableau de méthodes API.
actions	array	Tableau d'objets action.
actions.default_access	integer	Indique si l'accès aux nouvelles actions est activé. Valeurs possibles : 0 - Désactivé ; 1 - (par défaut) Activé.

Elémént UI

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

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

Service

Propriété	Type	Description
serviceid (obligatoire)	ID du service.

Tag de service

Propriété	Type	Description
tag (obligatoire)	string	Nom de tag. 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. Si aucune valeur ou une chaîne vide est spécifiée, seul le nom du tag sera utilisé pour la correspondance de service.

Module

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

Propriété	Type	Description
moduleid (obligatoire)	string	ID du module.
status	integer	Indique si l'accès au module est activé. Valeurs possibles : 0 - Désactivé; 1 - (par défaut) Activé.

Action

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

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

Documentation