[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]: # ({92b0166a-5d7a3d70})
### Service

L'objet service possède les propriétés suivantes.

|Propriété|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|serviceid|ID|ID du service.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *lecture seule*<br>- *obligatoire* pour les opérations de mise à jour|
|algorithm|integer|Règle de calcul du statut. Applicable uniquement si des services enfants existent.<br><br>Valeurs possibles :<br>0 - définir le statut sur OK ;<br>1 - le plus critique si tous les enfants ont des problèmes ;<br>2 - le plus critique des services enfants.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire* pour les opérations de création|
|name|string|Nom du service.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire* pour les opérations de création|
|sortorder|integer|Position du service utilisée pour le tri.<br><br>Valeurs possibles : 0-999.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire* pour les opérations de création|
|weight|integer|Poids du service.<br><br>Valeurs possibles : 0-1000000.<br><br>Par défaut : 0.|
|propagation\_rule|integer|Règle de propagation du statut.<br><br>Valeurs possibles :<br>0 - *(par défaut)* propager le statut du service tel quel, sans aucune modification ;<br>1 - augmenter le statut propagé d'une `propagation_value` donnée (de 1 à 5 niveaux de sévérité) ;<br>2 - diminuer le statut propagé d'une `propagation_value` donnée (de 1 à 5 niveaux de sévérité) ;<br>3 - ignorer ce service - le statut n'est pas du tout propagé au service parent ;<br>4 - définir un statut de service fixe à l'aide d'une `propagation_value` donnée.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire* si `propagation_value` est défini|
|propagation\_value|integer|Valeur de propagation du statut.<br><br>Valeurs possibles si `propagation_rule` est défini sur "0" ou "3" :<br>0 - Non classé.<br><br>Valeurs possibles si `propagation_rule` est défini sur "1" ou "2" :<br>1 - Information ;<br>2 - Avertissement ;<br>3 - Moyen ;<br>4 - Élevé ;<br>5 - Désastre.<br><br>Valeurs possibles si `propagation_rule` est défini sur "4" :<br>-1 - OK ;<br>0 - Non classé ;<br>1 - Information ;<br>2 - Avertissement ;<br>3 - Moyen ;<br>4 - Élevé ;<br>5 - Désastre.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire* si `propagation_rule` est défini|
|status|integer|Indique si le service est dans l'état OK ou dans un état de problème.<br><br>Si le service est dans un état de problème, `status` est égal soit à :<br>- la sévérité du problème le plus critique ;<br>- le statut le plus élevé d'un service enfant dans un état de problème.<br><br>Si le service est dans l'état OK, `status` est égal à : -1.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *lecture seule*|
|description|string|Description du service.|
|uuid|string|Identifiant unique universel, utilisé pour lier les services importés à ceux qui existent déjà. 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.<br><br>Valeurs possibles :<br>0 - Lecture-écriture ;<br>1 - Lecture seule.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *lecture seule*|

[comment]: # ({/92b0166a-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).<br><br>Valeurs possibles :<br>0 - si au moins (N) services enfants ont le statut (Statut) ou supérieur ;<br>1 - si au moins (N%) des services enfants ont le statut (Statut) ou supérieur ;<br>2 - si moins de (N) services enfants ont le statut (Statut) ou inférieur ;<br>3 - si moins de (N%) des services enfants ont le statut (Statut) ou inférieur ;<br>4 - si le poids des services enfants ayant le statut (Statut) ou supérieur est au moins égal à (W) ;<br>5 - si le poids des services enfants ayant le statut (Statut) ou supérieur est au moins égal à (N%) ;<br>6 - si le poids des services enfants ayant le statut (Statut) ou inférieur est inférieur à (W) ;<br>7 - si le poids des services enfants ayant le statut (Statut) ou inférieur est inférieur à (N%).<br><br>Où :<br>- N (W) correspond à `limit_value` ;<br>- (Statut) correspond à `limit_status` ;<br>- (Nouveau statut) correspond à `new_status`.<br><br>[Comportement des propriétés](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire*|
|limit\_value|integer|Valeur limite.<br><br>Valeurs possibles :<br>- pour N et W : 1-100000 ;<br>- pour N% : 1-100.<br><br>[Comportement des propriétés](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire*|
|limit\_status|integer|Statut limite.<br><br>Valeurs possibles :<br>-1 - OK ;<br>0 - Non classé ;<br>1 - Information ;<br>2 - Avertissement ;<br>3 - Moyen ;<br>4 - Élevé ;<br>5 - Désastre.<br><br>[Comportement des propriétés](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire*|
|new\_status|integer|Valeur du nouveau statut.<br><br>Valeurs possibles :<br>0 - Non classé ;<br>1 - Information ;<br>2 - Avertissement ;<br>3 - Moyen ;<br>4 - Élevé ;<br>5 - Désastre.<br><br>[Comportement des propriétés](/manual/api/reference_commentary#property-behavior) :<br>- *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.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire*|
|value|string|Valeur de la balise de service.|

[comment]: # ({/72128b59-c301cfb2})

[comment]: # ({56809270-e6daa7b4})
### Alarme de service

::: noteclassic
Les alarmes de service ne peuvent pas être directement créées, mises à jour ou supprimées via l'API Zabbix.
:::

Les objets d'alarme de service représentent un changement d'état d'un service. Ils possèdent les propriétés suivantes.

|Propriété |[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.<br><br>Consultez la [propriété `status` du service](object#service) pour obtenir la liste des valeurs possibles.|

[comment]: # ({/56809270-e6daa7b4})

[comment]: # ({10d32ffb-6b88d3dc})
### Tag de problème

Les tags de problème permettent de lier des services à des événements de problème. L'objet tag de problème
possède les propriétés suivantes.

|Propriété|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|Nom du tag de problème.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire*|
|operator|integer|Condition de correspondance [operator](/manual/it_services/service_tree#service-configuration).<br><br>Valeurs possibles :<br>0 - *(par défaut)* Égal à ;<br>2 - Contient.|
|value|string|Valeur du tag de problème.|

[comment]: # ({/10d32ffb-6b88d3dc})
