[comment]: # aside: 1 [comment]: # ({582254cb-92e6c52c}) # Objet task Les objets suivants sont directement liés à l'API `task`. ### Task L'objet task possède les propriétés suivantes : |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|--| |taskid|ID|ID du task.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *lecture seule*| |type|integer|Type du task.

Valeurs possibles :
1 - Informations de diagnostic;
2 - Actualiser la configuration du proxy;
6 - Exécuter maintenant.

Depuis Zabbix 7.0.19, les utilisateurs de type *Admin* et *User* peuvent créer des tasks "Exécuter maintenant".

Notez que `task.get` renvoie toujours "7" (résumé d'exécution du task).

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *obligatoire*| |status|integer|Statut du task.

Valeurs possibles :
1 - nouveau task;
2 - task en cours;
3 - task terminé;
4 - task expiré.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *lecture seule*| |clock|timestamp|Heure de création du task.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *lecture seule*| |ttl|integer|Temps en secondes après lequel le task expire.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *lecture seule*| |proxyid|ID|ID du proxy pour lequel les statistiques d'informations de diagnostic sont collectées.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *pris en charge* si `type` est défini sur "Diagnostic information" ou "Refresh proxy configuration"| |request|object|Objet de requête du task selon le type de task :
L'objet du task "Execute now" est [décrit en détail ci-dessous](/manual/api/reference/task/object#check-now-request-object);
L'objet du task "Refresh proxy configuration" est [décrit en détail ci-dessous](/manual/api/reference/task/object#refresh-proxy-configuration);
L'objet du task "Diagnostic information" est [décrit en détail ci-dessous](/manual/api/reference/task/object#diagnostic-information-request-object).

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *obligatoire*| |result|object|Objet résultat du task d'informations de diagnostic.
Peut contenir NULL si le résultat n'est pas encore prêt.
L'objet résultat est [décrit en détail ci-dessous](/manual/api/reference/task/object#statistic-result-object).

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *lecture seule*| [comment]: # ({/582254cb-92e6c52c}) [comment]: # ({479c7177-cd63c2fd}) #### Objet de requête "Execute now" L'objet de requête de tâche "Execute now" possède les propriétés suivantes. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |itemid|ID|ID de l'élément et des règles de découverte de bas niveau.

Depuis Zabbix 7.0.19, les utilisateurs de type *Admin* et *User* peuvent exécuter "Execute now" sur les éléments des hôtes pour lesquels ils disposent de l'autorisation *read-write* [permission](/manual/api/reference/usergroup/object#permission), ou de l'autorisation *read* et de l'action `invoke_execute_now` [action](/manual/api/reference/role/object#action) activée pour leur rôle. La même chose s'applique aux utilisateurs de type *Admin* pour les règles de découverte de bas niveau (LLD).| [comment]: # ({/479c7177-cd63c2fd}) [comment]: # ({f395f844-b5d3bd1c}) #### Objet de requête « Refresh proxy configuration » L'objet de requête de tâche « Refresh proxy configuration » possède les propriétés suivantes. |Propriété|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |proxyids|array|ID de proxy.| [comment]: # ({/f395f844-b5d3bd1c}) [comment]: # ({1249a0ab-52d75b77}) #### Objet de requête « Diagnostic information » L'objet de requête de tâche d'informations de diagnostic possède les propriétés suivantes. L'objet de requête de statistiques pour tous les types de propriétés est [décrit en détail ci-dessous](/manual/api/reference/task/object#statistic-request-object). |Propriété|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |historycache|object|Requête de statistiques du cache d'historique. Disponible sur le serveur et le proxy.| |valuecache|object|Requête de statistiques du cache des éléments. Disponible sur le serveur.| |preprocessing|object|Requête de statistiques du gestionnaire de prétraitement. Disponible sur le serveur et le proxy.| |alerting|object|Requête de statistiques du gestionnaire d'alertes. Disponible sur le serveur.| |lld|object|Requête de statistiques du gestionnaire LLD. Disponible sur le serveur.| [comment]: # ({/1249a0ab-52d75b77}) [comment]: # ({643b017b-5149852c}) ##### Objet de requête statistique L'objet de requête statistique est utilisé pour définir quel type d'informations doit être collecté à propos des processus internes du serveur/proxy. Il possède les propriétés suivantes. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |stats|query|Propriétés de l'objet statistique à renvoyer.
La liste des champs disponibles pour chaque type d'information de diagnostic statistique est [décrite en détail ci-dessous](object#list-of-statistic-fields-available-for-each-type-of-diagnostic-information-request).

Par défaut : `extend` renverra tous les champs statistiques disponibles.| |top|object|Objet permettant de trier et de limiter les valeurs statistiques renvoyées.
La liste des champs disponibles pour chaque type d'information de diagnostic statistique est [décrite en détail ci-dessous](object#list-of-sorting-fields-available-for-each-type-of-diagnostic-information-request).

Exemple : { "source.alerts": 10 }| [comment]: # ({/643b017b-5149852c}) [comment]: # ({50ca4dca-60e59ca2}) ###### Liste des champs statistiques disponibles pour chaque type de requête d'informations de diagnostic Les champs statistiques suivants peuvent être demandés pour chaque type de propriété de requête d'informations de diagnostic. |Type de diagnostic|Champs disponibles|Description| |--|--|------| |historycache|items|Nombre d'éléments en cache.| |^|values|Nombre de valeurs en cache.| |^|memory|Statistiques de mémoire partagée (espace libre, nombre de segments utilisés, nombre de segments libres, taille maximale du segment libre).| |^|memory.data|Statistiques de mémoire partagée du cache des données d'historique.| |^|memory.index|Statistiques de mémoire partagée du cache d'index d'historique.| |valuecache|items|Nombre d'éléments en cache.| |^|values|Nombre de valeurs en cache.| |^|memory|Statistiques de mémoire partagée (espace libre, nombre de segments utilisés, nombre de segments libres, taille maximale du segment libre).| |^|mode|Mode du cache de valeurs.| |preprocessing|values|Nombre de valeurs en file d'attente.| |^|preproc.values|Nombre de valeurs en file d'attente avec des étapes de prétraitement.| |alerting|alerts|Nombre d'alertes en file d'attente.| |lld|rules|Nombre de règles en file d'attente.| |^|values|Nombre de valeurs en file d'attente.| [comment]: # ({/50ca4dca-60e59ca2}) [comment]: # ({a768b834-09dc3377}) ###### Liste des champs de tri disponibles pour chaque type de demande d'informations de diagnostic Les champs statistiques suivants peuvent être utilisés pour trier et limiter les informations demandées. |Type de diagnostic|Champs disponibles|[Type](/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}) ##### Objet de résultat statistique L'objet de résultat statistique est récupéré dans le champ `result` de l'objet de tâche. |Propriété|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |status|integer|Statut du résultat de la tâche.

Valeurs possibles :
-1 - une erreur s'est produite lors de l'exécution de la tâche ;
0 - le résultat de la tâche est créé.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :
- *lecture seule*| |data|string/object|Résultats selon l'objet de requête statistique de la tâche d'informations de diagnostic particulière.
Contient une chaîne de message d'erreur si une erreur s'est produite lors de l'exécution de la tâche.| [comment]: # ({/13093171-e680be6c})