[comment]: # translation:outdated

[comment]: # aside:1

[comment]: # ({9e9adb41-b1a89f1b})
# Objecte servei

Els següents objectes són relacionats amb l'API `service`.

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

[comment]: # ({2fffa082-5d7a3d70})
### Servei

L'objecte de servei té les propietats següents.

|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|serviceid|ID|ID del servei.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només de lectura*<br>- *obligatori* per operacions d'actualització|
|algorithm|nombre|Regla de càlcul d'estat. Només s'aplica si existeixen serveis fill.<br><br>Valors possibles:<br>0: defineix l'estat com a correcte;<br>1: més crític si tots els fills tenen problemes;<br>2: més crítics amb els serveis fill. <br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per a operacions de creació|
|name|cadena|Nom del servei.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per a les operacions de creació|
|sortorder|enter|Posició del servei emprat per ordenar.<br><br>Valors possibles: 0-999.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):< br>- *obligatori* per a operacions de creació|
|weight|enter|Pes del servei.<br><br>Valors possibles: 0-1000000.<br><br>Per defecte: 0.|
|propagation\_rule|enter|Regla de propagació de l'estat.<br><br>Valors possibles:<br>0 - *(per defecte)* propaguen l'estat del servei tal com és - sense cap canvi;<br>1 - augmenta l'estat propagat en un "valor_de_propagació" donat (d'1 a 5 graus);<br>2 - disminueix l'estat propagat per un "valor_de_propagació" determinat (d'1 a 5 graus);<br>3 - ignora aquest servei - l'estat no es propaga al servei principal;<br>4 - establiu l'estat del servei fix mitjançant un `valor_de_propagació` donat.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si s'estableix `valor_de_propagació`|
|propagation\_value|enter|Valor de propagació d'estat.<br><br>Valors possibles si `propagation_rule` s'estableix a "0" o "3":<br>0 - No classificat.<br><br>Valors possibles si `propagation_rule` s'estableix a "1" o "2":<br>1 - Informació;<br>2 - Avís;<br>3 - Mitjana;<br>4 - Alta;<br>5 - Desastre. <br><br>Valors possibles si `propagation_rule` s'estableix a "4":<br>-1 - D'acord;<br>0 - No classificat;<br>1 - Informació;<br>2 - Advertiment;< br>3 - Mitjana;<br>4 - Alt;<br>5 - Desastre.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si s'estableix `propagation_rule`|
|status|enter|Si el servei està en estat correcte o problema.<br><br>Si el servei es troba en estat problema, `estat' és igual a:<br>- la gravetat del problema més crític;< br>- l'estat més alt d'un servei secundari en estat problema.<br><br>Si el servei està en estat correcte, `estat' és igual a: -1.<br><br>[Comportament de la propietat](/ manual/api/reference_commentary#property-behavior):<br>- *només lectura*|
|description|cadena|Descripció del servei.|
|uuid|cadena|Identificador únic universal, que s'empra per enllaçar serveis importats amb els ja existents. Generat automàticament, si no es dóna.|
|created_at|enter|Marca de temps Unix quan es va crear el servei.|
|read only|booleà|Accés al servei.<br><br>Valors possibles:<br>0 - Lectura-escriptura;<br>1 - Només lectura.<br><br>[Comportament de la propietat](/manual /api/reference_commentary#property-behavior):<br>- *només lectura*|

[comment]: # ({/2fffa082-5d7a3d70})

[comment]: # ({a07ec2b6-c2041847})
### Regla d'estat

L'objecte de regla d'estat té les propietats següents.

|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|tipus|enter|Condició per configurar l'estat (estat nou).<br><br>Valors possibles:<br>0 - si almenys (N) serveis secundaris tenen estat (estat) o superior;<br>1 - si almenys (N%) dels serveis fill tenen l'estat (Estat) o superior;<br>2 - si menys de (N) els serveis fill tenen l'estat (Estat) o inferior;<br>3 - si és inferior a (N%) dels serveis fill tenen un estat (Estat) o inferior;<br>4 - si el pes dels serveis fill amb estat (Estat) o superior és com a mínim (W);<br>5 - si el pes dels serveis fill amb estat (Estat) o superior és com a mínim (N%);<br>6 - si el pes dels serveis fill amb estat (estat) o inferior és inferior a (W);<br>7 - si el pes dels serveis fill amb estat (estat) o a continuació és inferior a (N%).<br><br>On:<br>- N (W) és "valor_límit";<br>- (Estat) és "estat_límit";<br>- (Estat nou) és `estat_nou`.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|
|limit\_value|enter|Valor límit.<br><br>Valors possibles:<br>- per N i W: 1-100000;<br>- per N%: 1-100.<br><br> [Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|
|límit\_estat|enter|Estat límit.<br><br>Valors possibles:<br>-1 - Correcte;<br>0 - No classificat;<br>1 - Informació;<br>2 - Avís;< br>3 - Mitjana;<br>4 - Alta;<br>5 - Desastre.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* |
|new\_status|enter|Nou valor d'estat.<br><br>Valors possibles:<br>0 - No classificat;<br>1 - Informació;<br>2 - Avís;<br>3 - Mitjana;< br>4 - Alta;<br>5 - Desastre.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

[comment]: # ({/a07ec2b6-c2041847})

[comment]: # ({8b8faf20-c301cfb2})
### Etiqueta de servei

L'objecte d'etiqueta de servei té les propietats següents:

|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|tag|string|Nom de l'etiqueta de servei.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|
|value|string|Valor de l'etiqueta de servei.|

[comment]: # ({/8b8faf20-c301cfb2})

[comment]: # ({0e3850a4-e6daa7b4})
### Alarma de servei

::: noteclassic
Les alarmes de servei no es poden crear, actualitzar o esborrar directament mitjançant l'API Zabbix.
:::

Els objectes d'alarma de servei representen el canvi d'estat d'un servei. Té les següents propietats.

|Propietat |[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|clock|timestamp|Hora en què s'ha produït el canvi d'estat del servei.|
|value|enter|Estat del servei.<br><br>Consulteu la [propietat d'`status` del servei](objecte#servei) per obtenir una llista de valors possibles.|

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

[comment]: # ({50277e12-6b88d3dc})
### Etiqueta de problema

Les etiquetes de problema permeten enllaçar serveis amb esdeveniments problemàtics. L'objecte d'etiqueta de problema té les propietats següents.

|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|tag|cadena|Nom de l'etiqueta del problema.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|
|operator|enter|[Operador](/manual/it_services/service_tree#service-configuration) de condició de mapatge.<br><br>Valors possibles:<br>0 - *(per defecte)* és igual;<br>2 - Conté.|
|value|cadena|Valor de l'etiqueta del problema.|

[comment]: # ({/50277e12-6b88d3dc})