[comment]: # aside: 1

[comment]: # translation:outdated

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

I seguenti oggetti sono direttamente correlati all'API `service`.

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

[comment]: # ({92b0166a-5d7a3d70})
### Servizio

L'oggetto servizio ha le seguenti proprietà.

|Proprietà|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|serviceid|ID|ID del servizio.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*<br>- *obbligatoria* per le operazioni di aggiornamento|
|algorithm|integer|Regola di calcolo dello stato. Applicabile solo se esistono servizi figli.<br><br>Valori possibili:<br>0 - imposta lo stato su OK;<br>1 - il più critico se tutti i figli hanno problemi;<br>2 - il più critico tra i servizi figli.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* per le operazioni di creazione|
|name|string|Nome del servizio.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* per le operazioni di creazione|
|sortorder|integer|Posizione del servizio utilizzata per l'ordinamento.<br><br>Valori possibili: 0-999.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* per le operazioni di creazione|
|weight|integer|Peso del servizio.<br><br>Valori possibili: 0-1000000.<br><br>Predefinito: 0.|
|propagation\_rule|integer|Regola di propagazione dello stato.<br><br>Valori possibili:<br>0 - *(predefinito)* propaga lo stato del servizio così com'è, senza alcuna modifica;<br>1 - aumenta lo stato propagato di un determinato `propagation_value` (da 1 a 5 livelli di gravità);<br>2 - diminuisce lo stato propagato di un determinato `propagation_value` (da 1 a 5 livelli di gravità);<br>3 - ignora questo servizio - lo stato non viene propagato al servizio padre in alcun modo;<br>4 - imposta uno stato fisso del servizio usando un determinato `propagation_value`.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `propagation_value` è impostato|
|propagation\_value|integer|Valore di propagazione dello stato.<br><br>Valori possibili se `propagation_rule` è impostato su "0" o "3":<br>0 - Non classificato.<br><br>Valori possibili se `propagation_rule` è impostato su "1" o "2":<br>1 - Informazione;<br>2 - Avviso;<br>3 - Medio;<br>4 - Alto;<br>5 - Disastro.<br><br>Valori possibili se `propagation_rule` è impostato su "4":<br>-1 - OK;<br>0 - Non classificato;<br>1 - Informazione;<br>2 - Avviso;<br>3 - Medio;<br>4 - Alto;<br>5 - Disastro.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `propagation_rule` è impostato|
|status|integer|Indica se il servizio è nello stato OK o in stato di problema.<br><br>Se il servizio è in stato di problema, `status` è uguale a uno dei seguenti valori:<br>- la gravità del problema più critico;<br>- lo stato più alto di un servizio figlio in stato di problema.<br><br>Se il servizio è nello stato OK, `status` è uguale a: -1.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*|
|description|string|Descrizione del servizio.|
|uuid|string|Identificatore univoco universale, utilizzato per collegare i servizi importati a quelli già esistenti. Generato automaticamente, se non fornito.|
|created_at|integer|Timestamp Unix della creazione del servizio.|
|readonly|integer|Accesso al servizio.<br><br>Valori possibili:<br>0 - Lettura-scrittura;<br>1 - Sola lettura.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*|

[comment]: # ({/92b0166a-5d7a3d70})

[comment]: # ({dd16f497-c2041847})
### Regola di stato

L'oggetto regola di stato ha le seguenti proprietà.

|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|type|integer|Condizione per impostare lo stato (Nuovo stato).<br><br>Valori possibili:<br>0 - se almeno (N) servizi figli hanno lo stato (Stato) o superiore;<br>1 - se almeno il (N%) dei servizi figli ha lo stato (Stato) o superiore;<br>2 - se meno di (N) servizi figli hanno lo stato (Stato) o inferiore;<br>3 - se meno del (N%) dei servizi figli ha lo stato (Stato) o inferiore;<br>4 - se il peso dei servizi figli con stato (Stato) o superiore è almeno (W);<br>5 - se il peso dei servizi figli con stato (Stato) o superiore è almeno (N%);<br>6 - se il peso dei servizi figli con stato (Stato) o inferiore è inferiore a (W);<br>7 - se il peso dei servizi figli con stato (Stato) o inferiore è inferiore a (N%).<br><br>Dove:<br>- N (W) è `limit_value`;<br>- (Stato) è `limit_status`;<br>- (Nuovo stato) è `new_status`.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|limit\_value|integer|Valore limite.<br><br>Valori possibili:<br>- per N e W: 1-100000;<br>- per N%: 1-100.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|limit\_status|integer|Stato limite.<br><br>Valori possibili:<br>-1 - OK;<br>0 - Non classificato;<br>1 - Informazione;<br>2 - Avviso;<br>3 - Medio;<br>4 - Alto;<br>5 - Disastro.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|new\_status|integer|Valore del nuovo stato.<br><br>Valori possibili:<br>0 - Non classificato;<br>1 - Informazione;<br>2 - Avviso;<br>3 - Medio;<br>4 - Alto;<br>5 - Disastro.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

[comment]: # ({72128b59-c301cfb2})
### Tag del servizio

L'oggetto tag del servizio ha le seguenti proprietà.

|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|tag|string|Nome del tag del servizio.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatorio*|
|value|string|Valore del tag del servizio.|

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

[comment]: # ({56809270-e6daa7b4})
### Allarme di servizio

::: noteclassic
Gli allarmi di servizio non possono essere creati, aggiornati o
eliminati direttamente tramite la API di Zabbix.
:::

Gli oggetti allarme di servizio rappresentano un cambiamento di stato di un servizio. Hanno
le seguenti proprietà.

|Proprietà |[Tipo](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|clock|timestamp|Ora in cui si è verificato il cambiamento di stato del servizio.|
|value|integer|Stato del servizio.<br><br>Fare riferimento alla [proprietà `status` del servizio](object#service) per un elenco dei valori possibili.|

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

[comment]: # ({10d32ffb-6b88d3dc})
### Tag del problema

I tag del problema consentono di collegare i servizi con gli eventi di problema. L'oggetto tag del problema ha le seguenti proprietà.

|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|tag|string|Nome del tag del problema.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatorio*|
|operator|integer|[Operatore](/manual/it_services/service_tree#service-configuration) della condizione di mappatura.<br><br>Valori possibili:<br>0 - *(predefinito)* Uguale;<br>2 - Contiene.|
|value|string|Valore del tag del problema.|

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