Objet rôle

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

Rôle

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

Propriété Type Description
roleid ID ID du rôle.

Comportement de la propriété :
- lecture seule
- obligatoire pour les opérations de mise à jour
name string Nom du rôle.

Comportement de la propriété :
- obligatoire pour les opérations de création
type integer Type d'utilisateur.

Valeurs possibles :
1 - (par défaut) Utilisateur ;
2 - Admin ;
3 - Super admin.

Comportement de la propriété :
- obligatoire pour les opérations de création
readonly integer Indique si le rôle est en lecture seule.

Valeurs possibles :
0 - (par défaut) Non ;
1 - Oui.

Comportement de la propriété :
- lecture seule

Règles de rôle

L’objet des règles de rôle possède les propriétés suivantes :

Propriété Type Description
ui array Tableau d’objets élément d’interface.
ui.default_access integer Indique si l’accès aux nouveaux éléments d’interface 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és par les propriétés 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.

Un accès en lecture seule sera accordé au rôle utilisateur pour les services spécifiés, y compris les services enfants. L’accès en lecture seule ne remplacera pas l’accès en lecture-écriture aux services.

Comportement de la propriété :
- prise en charge si services.read.mode est défini sur « 0 »
services.read.tag object Tableau d’objets étiquette de service.

Un accès en lecture seule sera accordé au rôle utilisateur pour les services correspondant aux étiquettes, y compris les services enfants. L’accès en lecture seule ne remplacera pas l’accès en lecture-écriture aux services.

Comportement de la propriété :
- prise en charge 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és par les propriétés 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.

Un accès en lecture-écriture sera accordé au rôle utilisateur pour les services spécifiés, y compris les services enfants. L’accès en lecture-écriture remplacera l’accès en lecture seule aux services.

Comportement de la propriété :
- prise en charge si services.write.mode est défini sur « 0 »
services.write.tag object Tableau d’objets étiquette de service.

Un accès en lecture-écriture sera accordé au rôle utilisateur pour les services correspondant aux étiquettes, y compris les services enfants. L’accès en lecture-écriture remplacera l’accès en lecture seule aux services.

Comportement de la propriété :
- prise en charge 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 - (par défaut) Désactivé ;
1 - Activé.
api.mode integer Mode de traitement des méthodes d’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 d’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é.
devices.access integer Indique si l’accès aux propres appareils mobiles de l’utilisateur pour une utilisation avec l’application mobile Zabbix est activé.

Valeurs possibles :
0 - (par défaut pour User et Admin) Désactivé ;
1 - (par défaut pour Super admin) Activé.

Comportement de la propriété :
- prise en charge si EnableMobileDevices est activé
devices.actions array Tableau d’objets action d’appareil.

Comportement de la propriété :
- prise en charge si devices.access est défini sur « 1 »
devices.actions.default_access integer Indique si l’accès aux nouvelles actions d’appareil est activé.

Valeurs possibles :
0 - (par défaut pour User et Admin) Désactivé ;
1 - (par défaut pour Super admin) Activé.

Comportement de la propriété :
- prise en charge si EnableMobileDevices est activé

Élément d’interface

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

Property Type Description
name string Nom de l’élément d’interface.

Valeurs possibles si type de l’objet Role est défini sur « User », « Admin » ou « Super admin » :
monitoring.dashboard - 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 > Vue d’ensemble ;
inventory.hosts - Inventaire > Hôtes ;
reports.availability_report - Rapports > Rapport de disponibilité ;
reports.top_triggers - Rapports > Top 100 des déclencheurs.

Valeurs possibles si type de l’objet Role est défini sur « Admin » ou « Super admin » :
monitoring.discovery - Surveillance > Découverte ;
services.sla - Services > SLA ;
reports.scheduled_reports - Rapports > Rapports planifiés ;
reports.notifications - Rapports > Notifications ;
configuration.template_groups - Collecte de données > Groupes de modèles ;
configuration.host_groups - Collecte de données > Groupes d’hôtes ;
configuration.templates - Collecte de données > Modèles ;
configuration.hosts - Collecte de données > Hôtes ;
configuration.maintenance - Collecte de données > Maintenance ;
configuration.discovery - Collecte de données > Découverte ;
configuration.trigger_actions - Alertes > Actions > Actions de déclencheur ;
configuration.service_actions - Alertes > Actions > Actions de service ;
configuration.discovery_actions - Alertes > Actions > Actions de découverte ;
configuration.autoregistration_actions - Alertes > Actions > Actions d’enregistrement automatique ;
configuration.internal_actions - Alertes > Actions > Actions internes.

Valeurs possibles si type de l’objet Role est défini sur « Super admin » :
reports.system_info - Rapports > Informations système ;
reports.audit - Rapports > Journal d’audit ;
reports.action_log - Rapports > Journal des actions ;
configuration.event_correlation - Collecte de données > Corrélation des événements ;
administration.media_types - Alertes > Types de média ;
administration.scripts - Alertes > Scripts ;
administration.user_groups - Utilisateurs > Groupes d’utilisateurs ;
administration.user_roles - Utilisateurs > Rôles utilisateur ;
administration.users - Utilisateurs > Utilisateurs ;
administration.api_tokens - Utilisateurs > Jetons API ;
administration.authentication - Utilisateurs > Authentification ;
administration.linked_devices - Utilisateurs > Appareils ;
administration.general - Administration > Général ;
administration.audit_log - Administration > Journal d’audit ;
administration.housekeeping - Administration > Maintenance ;
administration.proxy_groups - Administration > Groupes de proxy ;
administration.proxies - Administration > Proxys ;
administration.macros - Administration > Macros ;
administration.queue - Administration > File d’attente.

Comportement de la propriété :
- required
status integer Indique si l’accès à l’élément d’interface est activé.

Valeurs possibles :
0 - Désactivé ;
1 - (par défaut) Activé.

Service

Propriété Type Description
serviceid ID ID du service.

Comportement de la propriété :
- requis

Tag de service

Propriété Type Description
tag string Nom du tag.

Si une chaîne vide est spécifiée, le tag de service ne sera pas utilisé pour la correspondance des services.

Comportement de la propriété :
- obligatoire
value string Valeur du tag.

Si aucune valeur ou une chaîne vide est spécifiée, seul le nom du tag sera utilisé pour la correspondance des services.

Module

L'objet module possède les propriétés suivantes :

Propriété Type Description
moduleid ID ID du module.

Comportement de la propriété :
- obligatoire
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 possède les propriétés suivantes :

Property Type Description
name string Nom de l’action.

Valeurs possibles si type de l’objet Role est défini sur « User », « Admin » ou « Super admin » :
edit_dashboards - Créer et modifier des tableaux de bord ;
edit_maps - Créer et modifier des cartes ;
add_problem_comments - Ajouter des commentaires aux problèmes ;
change_severity - Modifier la gravité des problèmes ;
acknowledge_problems - Accuser réception des problèmes ;
suppress_problems - Supprimer les problèmes ;
close_problems - Fermer les problèmes ;
execute_scripts - Exécuter des scripts ;
manage_api_tokens - Gérer les jetons API ;
change_problem_ranking - Modifier le classement du problème, de cause à symptôme et inversement ;
edit_own_media - Autoriser la création et la modification de ses propres médias.

Valeurs possibles si type de l’objet Role est défini sur « Admin » ou « Super admin » :
edit_maintenance - Créer et modifier des maintenances ;
manage_scheduled_reports - Gérer les rapports planifiés,
manage_sla - Gérer les SLA,
select_server_for_monitoring - Autoriser la création de hôtes surveillés par le serveur et par les règles de découverte réseau exécutées par le serveur.

Valeurs possibles si type de l’objet Role est défini sur « User » ou « Admin » :
invoke_execute_now - Autoriser l’exécution des vérifications d’éléments pour les utilisateurs disposant uniquement d’autorisations de lecture sur le hôte.

Valeurs possibles si type de l’objet Role est défini sur « Super admin » :
edit_user_media - Autoriser la création et la modification de médias pour les utilisateurs.

Comportement de la propriété :
- required
status integer Indique si l’accès permettant d’effectuer l’action est activé.

Valeurs possibles :
0 - Désactivé ;
1 - (default) Activé.

Action sur les appareils

L'objet d'action sur les appareils possède les propriétés suivantes :

Property Type Description
name string Nom de l'action sur les appareils.

Valeurs possibles si type de l'objet Role est défini sur « User », « Admin » ou « Super admin » :
manage_own - Autoriser l'ajout ou la suppression des propres appareils mobiles de l'utilisateur.

Valeurs possibles si type de l'objet Role est défini sur « Super admin » :
manage_user - Autoriser l'ajout ou la suppression d'appareils mobiles pour tous les utilisateurs.

Comportement de la propriété :
- required
status integer Indique si l'accès permettant d'effectuer l'action est activé.

Valeurs possibles :
0 - Désactivé ;
1 - (par défaut) Activé.