[comment]: # aside: 1 [comment]: # ({0fc3ae4e-92e6c52c}) # Oggetto Task I seguenti oggetti sono direttamente correlati all'API `task`. ### Task L'oggetto task ha le seguenti proprietà: |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |taskid|ID|ID del task.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*| |type|integer|Tipo del task.

Valori possibili:
1 - Informazioni diagnostiche;
2 - Aggiorna configurazione del proxy;
6 - Esegui ora.

A partire da Zabbix 7.4.3, gli utenti di tipo *Admin* e *User* possono creare task "Esegui ora".

Nota che `task.get` restituisce sempre "7" (Riepilogo esecuzione task).

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*| |status|integer|Stato del task.

Valori possibili:
1 - nuovo task;
2 - task in corso;
3 - task completato;
4 - task scaduto.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*| |clock|timestamp|Ora in cui il task è stato creato.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*| |ttl|integer|Tempo in secondi dopo il quale il task scade.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*| |proxyid|ID|ID del proxy per il quale vengono raccolte le statistiche delle informazioni diagnostiche.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *supported* se `type` è impostato su "Informazioni diagnostiche" o "Aggiorna configurazione del proxy"| |request|object|Oggetto richiesta del task in base al tipo di task:
L'oggetto del task "Esegui ora" è [descritto in dettaglio di seguito](/manual/api/reference/task/object#check-now-request-object);
L'oggetto del task "Aggiorna configurazione del proxy" è [descritto in dettaglio di seguito](/manual/api/reference/task/object#refresh-proxy-configuration);
L'oggetto del task "Informazioni diagnostiche" è [descritto in dettaglio di seguito](/manual/api/reference/task/object#diagnostic-information-request-object).

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*| |result|object|Oggetto risultato del task di informazioni diagnostiche.
Può contenere NULL se il risultato non è ancora pronto.
L'oggetto risultato è [descritto in dettaglio di seguito](/manual/api/reference/task/object#statistic-result-object).

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*| [comment]: # ({/0fc3ae4e-92e6c52c}) [comment]: # ({4dff159c-cd63c2fd}) #### Oggetto richiesta 'Execute now' L'oggetto richiesta del task 'Execute now' ha le seguenti proprietà. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |itemid|ID|ID di item e delle regole di discovery a basso livello.

A partire da Zabbix 7.4.3, gli utenti di tipo *Admin* e *User* possono eseguire 'Execute now' sugli item degli host per i quali dispongono dell'[autorizzazione](/manual/api/reference/usergroup/object#permission) *read-write*, oppure dell'autorizzazione *read* e dell'[azione](/manual/api/reference/role/object#action) `invoke_execute_now` abilitata per il proprio ruolo. Lo stesso vale per gli utenti di tipo *Admin* per le regole di discovery a basso livello (LLD).| [comment]: # ({/4dff159c-cd63c2fd}) [comment]: # ({f395f844-b5d3bd1c}) #### Oggetto richiesta 'Refresh proxy configuration' L'oggetto richiesta del task 'Refresh proxy configuration' ha le seguenti proprietà. |Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione| |--|--|------| |proxyids|array|ID dei proxy.| [comment]: # ({/f395f844-b5d3bd1c}) [comment]: # ({1249a0ab-52d75b77}) #### Oggetto richiesta 'Informazioni diagnostiche' L'oggetto richiesta dell'attività di informazioni diagnostiche ha le seguenti proprietà. L'oggetto richiesta delle statistiche per tutti i tipi di proprietà è [descritto in dettaglio di seguito](/manual/api/reference/task/object#statistic-request-object). |Proprietà|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione| |--|--|------| |historycache|object|Richiesta di statistiche della cache della cronologia. Disponibile su server e proxy.| |valuecache|object|Richiesta di statistiche della cache degli item. Disponibile sul server.| |preprocessing|object|Richiesta di statistiche del gestore di preprocessing. Disponibile su server e proxy.| |alerting|object|Richiesta di statistiche del gestore degli avvisi. Disponibile sul server.| |lld|object|Richiesta di statistiche del gestore LLD. Disponibile sul server.| [comment]: # ({/1249a0ab-52d75b77}) [comment]: # ({2eb185f8-5149852c}) ##### Oggetto di richiesta delle statistiche L'oggetto di richiesta delle statistiche viene utilizzato per definire quale tipo di informazioni deve essere raccolto sui processi interni di server/proxy. Ha le seguenti proprietà. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |stats|query|Proprietà dell'oggetto statistico da restituire.
L'elenco dei campi disponibili per ciascun tipo di statistica delle informazioni diagnostiche è [descritto in dettaglio di seguito](object#list-of-statistic-fields-available-for-each-type-of-diagnostic-information-request).

Predefinito: `extend` restituirà tutti i campi statistici disponibili.| |top|object|Oggetto per ordinare e limitare i valori statistici restituiti.
L'elenco dei campi disponibili per ciascun tipo di statistica delle informazioni diagnostiche è [descritto in dettaglio di seguito](object#list-of-sorting-fields-available-for-each-type-of-diagnostic-information-request).

Esempio: { “source.alerts”: 10 }| [comment]: # ({/2eb185f8-5149852c}) [comment]: # ({50ca4dca-60e59ca2}) ###### Elenco dei campi statistici disponibili per ciascun tipo di richiesta di informazioni diagnostiche I seguenti campi statistici possono essere richiesti per ciascun tipo di proprietà della richiesta di informazioni diagnostiche. |Tipo diagnostico|Campi disponibili|Descrizione| |--|--|------| |historycache|items|Numero di item nella cache.| |^|values|Numero di valori nella cache.| |^|memory|Statistiche della memoria condivisa (spazio libero, numero di blocchi utilizzati, numero di blocchi liberi, dimensione massima del blocco libero).| |^|memory.data|Statistiche della memoria condivisa della cache dei dati storici.| |^|memory.index|Statistiche della memoria condivisa della cache dell'indice storico.| |valuecache|items|Numero di item nella cache.| |^|values|Numero di valori nella cache.| |^|memory|Statistiche della memoria condivisa (spazio libero, numero di blocchi utilizzati, numero di blocchi liberi, dimensione massima del blocco libero).| |^|mode|Modalità della cache dei valori.| |preprocessing|values|Numero di valori in coda.| |^|preproc.values|Numero di valori in coda con passaggi di preprocessing.| |alerting|alerts|Numero di avvisi in coda.| |lld|rules|Numero di regole in coda.| |^|values|Numero di valori in coda.| [comment]: # ({/50ca4dca-60e59ca2}) [comment]: # ({a768b834-09dc3377}) ###### Elenco dei campi di ordinamento disponibili per ciascun tipo di richiesta di informazioni diagnostiche I seguenti campi statistici possono essere utilizzati per ordinare e limitare le informazioni richieste. |Tipo diagnostico|Campi disponibili|[Tipo](/manual/api/reference_commentary#data-types)| |--|--|------| |historycache|values|integer| |valuecache|values|integer| |^|request.values|integer| |preprocessing|values|integer| |alerting|media.alerts|integer| |^|source.alerts|integer| |lld|values|integer| [comment]: # ({/a768b834-09dc3377}) [comment]: # ({13093171-e680be6c}) ##### Oggetto risultato statistico L'oggetto risultato statistico viene recuperato nel campo `result` dell'oggetto task. |Proprietà|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione| |--|--|------| |status|integer|Stato del risultato del task.

Valori possibili:
-1 - si è verificato un errore durante l'esecuzione del task;
0 - il risultato del task è stato creato.

[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*| |data|string/object|Risultati in base all'oggetto richiesta statistica del particolare task di informazioni diagnostiche.
Contiene una stringa con il messaggio di errore se si è verificato un errore durante l'esecuzione del task.| [comment]: # ({/13093171-e680be6c})