[comment]: # aside: 1 [comment]: # ({0fc3ae4e-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 de la tâche.

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

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

Depuis Zabbix 7.4.3, les utilisateurs de type *Admin* et *User* peuvent créer des tâches "Exécuter maintenant".

Notez que `task.get` renvoie toujours "7" (résumé d'exécution de la tâche).

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

Valeurs possibles :
1 - nouvelle tâche ;
2 - tâche en cours ;
3 - tâche terminée ;
4 - tâche expirée.

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

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *lecture seule*| |ttl|integer|Temps en secondes après lequel la tâche 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 "Informations de diagnostic" ou "Actualiser la configuration du proxy"| |request|object|Objet de requête de tâche selon le type de tâche :
L'objet de la tâche "Exécuter maintenant" est [décrit en détail ci-dessous](/manual/api/reference/task/object#check-now-request-object) ;
L'objet de la tâche "Actualiser la configuration du proxy" est [décrit en détail ci-dessous](/manual/api/reference/task/object#refresh-proxy-configuration) ;
L'objet de la tâche "Informations de diagnostic" 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 de la tâche 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]: # ({/0fc3ae4e-92e6c52c}) [comment]: # ({4dff159c-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.4.3, les utilisateurs de type *Admin* et *User* peuvent exécuter 'Execute now' sur les éléments des hôtes pour lesquels ils disposent d'une [permission](/manual/api/reference/usergroup/object#permission) *lecture-écriture*, ou d'une permission *lecture* 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]: # ({/4dff159c-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]: # ({2eb185f8-5149852c}) ##### Objet de requête de statistiques L'objet de requête de statistiques est utilisé pour définir quel type d'informations doit être collecté sur les processus internes du serveur/proxy. Il possède les propriétés suivantes. |Propriété|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |stats|query|Propriétés de l'objet de statistiques à renvoyer.
La liste des champs disponibles pour chaque type de statistique d'informations de diagnostic 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 de statistiques disponibles.| |top|object|Objet permettant de trier et de limiter les valeurs de statistiques renvoyées.
La liste des champs disponibles pour chaque type de statistique d'informations de diagnostic 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]: # ({/2eb185f8-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})