[comment]: # translation:outdated

[comment]: # ({b1a89f1b-b1a89f1b})
# > Objet Service

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

[comment]: # ({/b1a89f1b-b1a89f1b})

[comment]: # ({132baa34-4a7e98f0})

### Service

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

| Propriété                    | [Type](/manual/api/reference_commentary#data_types) | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|-----------------------------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| serviceid                   | string                                              | *(lecture seule)* ID du service.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **algorithm**<br>(required) | integer                                             | Règle de calcul du statut. Applicable uniquement si des services enfants existent.<br><br>Valeurs possibles :<br>0 - définir l'état sur OK ;<br>1 - le plus critique si tous les enfants ont des problèmes ;<br>2 - le plus critique des services enfants.                                                                                                                                                                                                                                                                                                                |
| **name**<br>(required)      | string                                              | Nom du service.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **sortorder**<br>(required) | integer                                             | Position du service utilisé pour le tri.<br><br>Valeurs possibles : 0-999.                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| weight                      | integer                                             | Poids du service.<br><br>Valeurs possibles : 0-1000000.<br><br>Par défaut : 0.                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| propagation\_rule           | integer                                             | Règle de propagation d'état. Doit être défini avec `propagation_value`.<br><br>Valeurs possibles :<br>0 - *(par défaut)* propage l'état du service tel quel - sans aucune modification ;<br>1 - augmente l'état propagé d'une valeur donnée `propagation_value` (de 1 à 5 sévérités) ;<br>2 - diminue le statut propagé d'une `propagation_value` donnée (de 1 à 5 sévérités) ;<br>3 - ignore ce service - le statut n'est pas propagé au service parent du tout ;<br>4 - définir le statut du service fixe en utilisant une `propagation_value` donnée. |
| propagation\_value          | integer                                             | Valeur de propagation de l'état. Doit être défini avec `propagation_rule`.<br><br>Valeurs possibles pour `propagation_rule` avec les valeurs `0` et `3` : 0.<br><br>Valeurs possibles pour `propagation_rule` avec les valeurs `1` et `2`  : 1-5.<br><br>Valeurs possibles pour `propagation_rule` avec la valeur `4` :<br>-1 - OK ;<br>0 - Non classifié ;<br>1 - Information ; <br>2 - Avertissement ;<br>3 - Moyen ;<br>4 - Élevé ;<br>5 - Désastre.                                                                                                              |
| status                      | integer                                             | *(lecture seule)* Indique si le service est en état OK ou problème.<br><br>Si le service est en état problème, `status` est égal à :<br>- la sévérité du problème le plus critique ;<br>- le niveau le plus élevé d'un service enfant en état de problème.<br><br>Si le service est en état OK, `status` est égal à -1.                                                                                                                                                                                                               |
| description                 | string                                              | Description du service.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| uuid                        | string                                              | Identifiant unique universel. Pour les opérations de mise à jour, ce champ est en *lecture seule*.                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| created_at                  | integer                                             | Horodatage Unix de quand le service a été créé.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| readonly                    | boolean                                             | *(lecture seule)* Accès au service.<br><br>Valeurs possibles :<br>0 - Lecture-écriture ;<br>1 - Lecture seule.                                                                                                                                                                                                                                                                                                                                                                                                                              |

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

[comment]: # ({/132baa34-4a7e98f0})

[comment]: # ({6bfdbc42-6bfdbc42})

### Règle de statut

L'objet de règle de statut a les propriétés suivantes.

| Propriété                        | [Type](/manual/api/reference_commentary#data_types) | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|---------------------------------|-----------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **type**<br>(obligatoire)          | 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 ( Statut) statut ou inférieur ;<br>4 - si le poids des services enfants avec le statut (Statut) ou supérieur est au moins (W) ;<br>5 - si le poids des services enfants avec le statut (Statut) ou supérieur est au moins (N%) ;<br>6 - si le poids des services enfants avec le statut (Statut) ou inférieur est inférieur à (W) ;<br>7 - si le poids des services enfants avec le statut (Statut) ou inférieur est inférieur à (N%).<br><br>Où :<br>- N (W) est `limit_value` ;<br>- (Statut) est `limit_status` ;<br>- (Nouveau statut) est `new_status`. |
| **limit\_value**<br>(obligatoire)  | integer                                             | Valeur limite.<br><br>Valeurs possibles :<br>- pour N et W : 1-100000 ;<br>- pour N % : 1-100.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **limit\_status**<br>(obligatoire) | integer                                             | État limite.<br><br>Valeurs possibles :<br>-1 - OK ;<br>0 - Non classifié ;<br>1 - Information ;<br>2 - Avertissement ;<br>3 - Moyenne ;<br>4 - Élevé ;<br>5 - Désastre.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **new\_status**<br>(obligatoire)   | integer                                             | Nouvelle valeur d'état.<br><br>Valeurs possibles :<br>0 - Non classifié ;<br>1 - Information ;<br>2 - Avertissement ;<br>3 - Moyenne ;<br>4 - Élevé ;<br>5 - Désastre.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |

[comment]: # ({/6bfdbc42-6bfdbc42})

[comment]: # ({9903142f-9903142f})
### Tag de service

L'objet de tag de service a les propriétés suivantes.

| Propriété              | [Type](/manual/api/reference_commentary#data_types) | Description        |
|-----------------------|-----------------------------------------------------|--------------------|
| **tag**<br>(obligatoire) | string                                              | Nom du tag de service.  |
| value                 | string                                              | Valeur du tag de service. |

[comment]: # ({/9903142f-9903142f})

[comment]: # ({fe2d8044-fe2d8044})
### 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 le changement d'état d'un service. Il a 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                                             | État du service.<br><br>Reportez-vous à la [propriété d'état du service](object#service) pour obtenir une liste des valeurs possibles. |

[comment]: # ({/fe2d8044-fe2d8044})

[comment]: # ({1c3ecb40-1c3ecb40})
### Tag de problème

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

| Propriété              | [Type](/manual/api/reference_commentary#data_types) | Description                                                                                 |
|-----------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------------|
| **tag**<br>(obligatoire) | string                                              | Nom du tag de problème.                                                                           |
| operator              | integer                                             | Opérateur de condition de mappage.<br><br>Valeurs possibles :<br>0 - *(par défaut)* equals;<br>2 - like. |
| value                 | string                                              | Valeur du tag de problème.                                                                          |

[comment]: # ({/1c3ecb40-1c3ecb40})
