[comment]: # aside: 1
[comment]: # translation:outdated
[comment]: # ({9e9adb41-b1a89f1b})
# Oggetto servizio
I seguenti oggetti sono direttamente correlati all'API `service`.
[comment]: # ({/9e9adb41-b1a89f1b})
[comment]: # ({64f35abb-5d7a3d70})
### Service
L'oggetto service ha le seguenti proprietà.
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|serviceid|ID|ID del service.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*
- *required* per le operazioni di aggiornamento|
|algorithm|integer|Regola di calcolo dello stato. Applicabile solo se esistono service figlio.
Valori possibili:
0 - imposta lo stato su OK;
1 - il più critico se tutti i figli hanno problemi;
2 - il più critico tra i service figlio.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* per le operazioni di creazione|
|name|string|Nome del service.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* per le operazioni di creazione|
|sortorder|integer|Posizione del service usata per l'ordinamento.
Valori possibili: 0-999.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* per le operazioni di creazione|
|weight|integer|Peso del service.
Valori possibili: 0-1000000.
Predefinito: 0.|
|propagation\_rule|integer|Regola di propagazione dello stato.
Valori possibili:
0 - *(predefinito)* propaga lo stato del service così com'è, senza alcuna modifica;
1 - aumenta lo stato propagato di un dato `propagation_value` (di 1-5 severità);
2 - diminuisce lo stato propagato di un dato `propagation_value` (di 1-5 severità);
3 - ignora questo service - lo stato non viene propagato al service padre;
4 - imposta uno stato fisso del service usando un dato `propagation_value`.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* se `propagation_value` è impostato|
|propagation\_value|integer|Valore di propagazione dello stato.
Valori possibili se `propagation_rule` è impostato su "0" o "3":
0 - Non classificato.
Valori possibili se `propagation_rule` è impostato su "1" o "2":
1 - Informazione;
2 - Avviso;
3 - Medio;
4 - Alto;
5 - Disastro.
Valori possibili se `propagation_rule` è impostato su "4":
-1 - OK;
0 - Non classificato;
1 - Informazione;
2 - Avviso;
3 - Medio;
4 - Alto;
5 - Disastro.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* se `propagation_rule` è impostato|
|status|integer|Indica se il service si trova nello stato OK o di problema.
Se il service si trova in uno stato di problema, `status` è uguale alla gravità del problema più critico oppure allo stato più alto di un service figlio in stato di problema.
Se il service si trova nello stato OK, `status` è uguale a: -1.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*|
|description|string|Descrizione del service.|
|uuid|string|Identificatore univoco universale, usato per collegare i service importati a quelli già esistenti. Generato automaticamente, se non specificato.|
|created_at|integer|Timestamp Unix in cui il service è stato creato.|
|readonly|integer|Accesso al service.
Valori possibili:
0 - Lettura e scrittura;
1 - Sola lettura.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*|
[comment]: # ({/64f35abb-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).
Valori possibili:
0 - se almeno (N) servizi figli hanno lo stato (Stato) o superiore;
1 - se almeno il (N%) dei servizi figli ha lo stato (Stato) o superiore;
2 - se meno di (N) servizi figli hanno lo stato (Stato) o inferiore;
3 - se meno del (N%) dei servizi figli ha lo stato (Stato) o inferiore;
4 - se il peso dei servizi figli con stato (Stato) o superiore è almeno (W);
5 - se il peso dei servizi figli con stato (Stato) o superiore è almeno (N%);
6 - se il peso dei servizi figli con stato (Stato) o inferiore è inferiore a (W);
7 - se il peso dei servizi figli con stato (Stato) o inferiore è inferiore a (N%).
Dove:
- N (W) è `limit_value`;
- (Stato) è `limit_status`;
- (Nuovo stato) è `new_status`.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *required*|
|limit\_value|integer|Valore limite.
Valori possibili:
- per N e W: 1-100000;
- per N%: 1-100.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *required*|
|limit\_status|integer|Stato limite.
Valori possibili:
-1 - OK;
0 - Non classificato;
1 - Informazione;
2 - Avviso;
3 - Medio;
4 - Alto;
5 - Disastro.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *required*|
|new\_status|integer|Valore del nuovo stato.
Valori possibili:
0 - Non classificato;
1 - Informazione;
2 - Avviso;
3 - Medio;
4 - Alto;
5 - Disastro.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *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.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatorio*|
|value|string|Valore del tag del servizio.|
[comment]: # ({/72128b59-c301cfb2})
[comment]: # ({92be70e8-e6daa7b4})
### Allarme del servizio
::: noteclassic
Gli allarmi del servizio non possono essere creati, aggiornati o eliminati direttamente tramite la Zabbix API.
:::
Gli oggetti allarme del servizio rappresentano una modifica dello stato di un servizio.
Ha le seguenti proprietà.
|Property |[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|clock|timestamp|Ora in cui si è verificata la modifica dello stato del servizio.|
|value|integer|Stato del servizio.
Fare riferimento alla [proprietà `status` del servizio](object#service) per un elenco dei valori possibili.|
[comment]: # ({/92be70e8-e6daa7b4})
[comment]: # ({88aae5fd-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à.
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|Nome del tag del problema.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*|
|operator|integer|[Operatore](/manual/it_services/service_tree#service-configuration) della condizione di mapping.
Valori possibili:
0 - *(default)* Uguale;
2 - Contiene.|
|value|string|Valore del tag del problema.|
[comment]: # ({/88aae5fd-6b88d3dc})