[comment]: # aside: 1 [comment]: # translation:outdated [comment]: # ({9e9adb41-b1a89f1b}) # Objet service Les objets suivants sont directement liés à l'API `service`. [comment]: # ({/9e9adb41-b1a89f1b}) [comment]: # ({64f35abb-5d7a3d70}) ### Service L'objet service possède les propriétés suivantes. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |serviceid|ID|ID du service.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*
- *required* for update operations| |algorithm|integer|Règle de calcul de l'état. Applicable uniquement si des services enfants existent.

Valeurs possibles :
0 - définir l'état sur OK;
1 - le plus critique si tous les enfants ont des problèmes;
2 - le plus critique des services enfants.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* for create operations| |name|string|Nom du service.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* for create operations| |sortorder|integer|Position du service utilisée pour le tri.

Valeurs possibles : 0-999.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* for create operations| |weight|integer|Poids du service.

Valeurs possibles : 0-1000000.

Par défaut : 0.| |propagation\_rule|integer|Règle de propagation de l'état.

Valeurs possibles :
0 - *(default)* propager l'état du service tel quel - sans aucune modification;
1 - augmenter l'état propagé d'une valeur `propagation_value` donnée (de 1 à 5 niveaux de gravité);
2 - diminuer l'état propagé d'une valeur `propagation_value` donnée (de 1 à 5 niveaux de gravité);
3 - ignorer ce service - l'état n'est pas du tout propagé au service parent;
4 - définir un état de service fixe à l'aide d'une valeur `propagation_value` donnée.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* if `propagation_value` is set| |propagation\_value|integer|Valeur de propagation de l'état.

Valeurs possibles si `propagation_rule` est défini sur "0" ou "3" :
0 - Non classé.

Valeurs possibles si `propagation_rule` est défini sur "1" ou "2" :
1 - Information;
2 - Avertissement;
3 - Moyen;
4 - Élevé;
5 - Désastre.

Valeurs possibles si `propagation_rule` est défini sur "4" :
-1 - OK;
0 - Non classé;
1 - Information;
2 - Avertissement;
3 - Moyen;
4 - Élevé;
5 - Désastre.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* if `propagation_rule` is set| |status|integer|Indique si le service est dans un état OK ou en problème.

Si le service est dans un état de problème, `status` est égal soit à la gravité du problème le plus critique, soit à l'état le plus élevé d'un service enfant en état de problème.

Si le service est dans un état OK, `status` est égal à : -1.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*| |description|string|Description du service.| |uuid|string|Identifiant unique universel, utilisé pour lier les services importés à ceux déjà existants. Généré automatiquement s'il n'est pas fourni.| |created_at|integer|Horodatage Unix de la création du service.| |readonly|integer|Accès au service.

Valeurs possibles :
0 - Lecture-écriture;
1 - Lecture seule.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*| [comment]: # ({/64f35abb-5d7a3d70}) [comment]: # ({dd16f497-c2041847}) ### Règle de statut L'objet de règle de statut possède les propriétés suivantes. |Propriété|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |type|integer|Condition pour définir le statut (Nouveau statut).

Valeurs possibles :
0 - si au moins (N) services enfants ont le statut (Statut) ou supérieur ;
1 - si au moins (N%) des services enfants ont le statut (Statut) ou supérieur ;
2 - si moins de (N) services enfants ont le statut (Statut) ou inférieur ;
3 - si moins de (N%) des services enfants ont le statut (Statut) ou inférieur ;
4 - si le poids des services enfants ayant le statut (Statut) ou supérieur est au moins égal à (W) ;
5 - si le poids des services enfants ayant le statut (Statut) ou supérieur est au moins égal à (N%) ;
6 - si le poids des services enfants ayant le statut (Statut) ou inférieur est inférieur à (W) ;
7 - si le poids des services enfants ayant le statut (Statut) ou inférieur est inférieur à (N%).

Où :
- N (W) correspond à `limit_value` ;
- (Statut) correspond à `limit_status` ;
- (Nouveau statut) correspond à `new_status`.

[Comportement des propriétés](/manual/api/reference_commentary#property-behavior) :
- *obligatoire*| |limit\_value|integer|Valeur limite.

Valeurs possibles :
- pour N et W : 1-100000 ;
- pour N% : 1-100.

[Comportement des propriétés](/manual/api/reference_commentary#property-behavior) :
- *obligatoire*| |limit\_status|integer|Statut limite.

Valeurs possibles :
-1 - OK ;
0 - Non classé ;
1 - Information ;
2 - Avertissement ;
3 - Moyen ;
4 - Élevé ;
5 - Désastre.

[Comportement des propriétés](/manual/api/reference_commentary#property-behavior) :
- *obligatoire*| |new\_status|integer|Valeur du nouveau statut.

Valeurs possibles :
0 - Non classé ;
1 - Information ;
2 - Avertissement ;
3 - Moyen ;
4 - Élevé ;
5 - Désastre.

[Comportement des propriétés](/manual/api/reference_commentary#property-behavior) :
- *obligatoire*| [comment]: # ({/dd16f497-c2041847}) [comment]: # ({72128b59-c301cfb2}) ### Balise de service L'objet de balise de service possède les propriétés suivantes. |Propriété|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |tag|string|Nom de la balise de service.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :
- *obligatoire*| |value|string|Valeur de la balise de service.| [comment]: # ({/72128b59-c301cfb2}) [comment]: # ({92be70e8-e6daa7b4}) ### Alarme de service ::: noteclassic Les alarmes de service ne peuvent pas être créées, mises à jour ou supprimées directement via l'API Zabbix. ::: Les objets d'alarme de service représentent un changement d'état d'un service. Il possède les propriétés suivantes. |Property |[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |clock|timestamp|Heure à laquelle le changement d'état du service s'est produit.| |value|integer|Statut du service.

Reportez-vous à la [propriété `status` du service](object#service) pour obtenir la liste des valeurs possibles.| [comment]: # ({/92be70e8-e6daa7b4}) [comment]: # ({88aae5fd-6b88d3dc}) ### Balise de problème Les balises de problème permettent de lier des services avec des événements de problème. L'objet balise de problème possède les propriétés suivantes. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |tag|string|Nom de la balise de problème.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *required*| |operator|integer|[Opérateur](/manual/it_services/service_tree#service-configuration) de la condition de mappage.

Valeurs possibles :
0 - *(par défaut)* Égal à;
2 - Contient.| |value|string|Valeur de la balise de problème.| [comment]: # ({/88aae5fd-6b88d3dc})