[comment]: # aside: 1 [comment]: # ({0fc3ae4e-92e6c52c}) # Task-Objekt Die folgenden Objekte stehen in direktem Zusammenhang mit der `task`-API. ### Task Das Task-Objekt hat die folgenden Eigenschaften: |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|--| |taskid|ID|ID der Task.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*| |type|integer|Typ der Task.

Mögliche Werte:
1 - Diagnoseinformationen;
2 - Proxy-Konfiguration aktualisieren;
6 - Jetzt ausführen.

Seit Zabbix 7.4.3 können Benutzer vom Typ *Admin* und *User* Tasks vom Typ "Jetzt ausführen" erstellen.

Beachten Sie, dass `task.get` immer "7" zurückgibt (Task-Ausführungszusammenfassung).

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*| |status|integer|Status der Task.

Mögliche Werte:
1 - neue Task;
2 - Task in Bearbeitung;
3 - Task ist abgeschlossen;
4 - Task ist abgelaufen.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*| |clock|timestamp|Zeitpunkt, zu dem die Task erstellt wurde.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*| |ttl|integer|Zeit in Sekunden, nach der die Task abläuft.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*| |proxyid|ID|ID des Proxy, über den Diagnoseinformationen erfasst werden.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *supported* wenn `type` auf "Diagnoseinformationen" oder "Proxy-Konfiguration aktualisieren" gesetzt ist| |request|object|Task-Anfrageobjekt entsprechend dem Task-Typ:
Das Objekt der Task "Jetzt ausführen" ist [unten ausführlich beschrieben](/manual/api/reference/task/object#check-now-request-object);
Das Objekt der Task "Proxy-Konfiguration aktualisieren" ist [unten ausführlich beschrieben](/manual/api/reference/task/object#refresh-proxy-configuration);
Das Objekt der Task "Diagnoseinformationen" ist [unten ausführlich beschrieben](/manual/api/reference/task/object#diagnostic-information-request-object).

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*| |result|object|Ergebnisobjekt der Task für Diagnoseinformationen.
Kann NULL enthalten, wenn das Ergebnis noch nicht bereit ist.
Das Ergebnisobjekt ist [unten ausführlich beschrieben](/manual/api/reference/task/object#statistic-result-object).

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*| [comment]: # ({/0fc3ae4e-92e6c52c}) [comment]: # ({4dff159c-cd63c2fd}) #### Objekt der Anfrage „Execute now“ Das Objekt der Aufgabenanfrage „Execute now“ hat die folgenden Eigenschaften. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |itemid|ID|ID des Datenpunkts und der Low-Level-Discovery-Regeln.

Seit Zabbix 7.4.3 können Benutzer vom Typ *Admin* und *User* Datenpunkte auf Hosts „Execute now“ ausführen, für die sie entweder eine *read-write* [Berechtigung](/manual/api/reference/usergroup/object#permission) haben oder eine *read* Berechtigung sowie die für ihre Rolle aktivierte [Aktion](/manual/api/reference/role/object#action) `invoke_execute_now`. Dasselbe gilt für Benutzer vom Typ *Admin* bei Low-Level-Discovery-(LLD-)Regeln.| [comment]: # ({/4dff159c-cd63c2fd}) [comment]: # ({f395f844-b5d3bd1c}) #### Anforderungsobjekt „Refresh proxy configuration“ Das Anforderungsobjekt der Aufgabe „Refresh proxy configuration“ hat die folgenden Eigenschaften. |Eigenschaft|[Type](/manual/api/reference_commentary#data-types)|Beschreibung| |--|--|------| |proxyids|array|Proxy-IDs.| [comment]: # ({/f395f844-b5d3bd1c}) [comment]: # ({1249a0ab-52d75b77}) #### Anfrageobjekt „Diagnoseinformationen“ Das Anfrageobjekt für die Aufgabe „Diagnoseinformationen“ hat die folgenden Eigenschaften. Das Statistik-Anfrageobjekt für alle Eigenschaftstypen wird [weiter unten ausführlich beschrieben](/manual/api/reference/task/object#statistic-request-object). |Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung| |--|--|------| |historycache|object|Statistik-Anfrage für den Verlaufscache. Verfügbar auf Server und Proxy.| |valuecache|object|Statistik-Anfrage für den Datenpunkt-Cache. Verfügbar auf Server.| |preprocessing|object|Statistik-Anfrage für den Präprozessierungsmanager. Verfügbar auf Server und Proxy.| |alerting|object|Statistik-Anfrage für den Alarmmanager. Verfügbar auf Server.| |lld|object|Statistik-Anfrage für den LLD-Manager. Verfügbar auf Server.| [comment]: # ({/1249a0ab-52d75b77}) [comment]: # ({2eb185f8-5149852c}) ##### Objekt für Statistikabfragen Das Objekt für Statistikabfragen wird verwendet, um festzulegen, welche Art von Informationen über interne Prozesse von Server/Proxy erfasst werden soll. Es hat die folgenden Eigenschaften. |Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung| |--|--|------| |stats|query|Eigenschaften des Statistikobjekts, die zurückgegeben werden sollen.
Die Liste der verfügbaren Felder für jeden Typ von Statistiken zu Diagnoseinformationen wird [weiter unten im Detail beschrieben](object#list-of-statistic-fields-available-for-each-type-of-diagnostic-information-request).

Standard: `extend` gibt alle verfügbaren Statistikfelder zurück.| |top|object|Objekt zum Sortieren und Begrenzen der zurückgegebenen Statistikwerte.
Die Liste der verfügbaren Felder für jeden Typ von Statistiken zu Diagnoseinformationen wird [weiter unten im Detail beschrieben](object#list-of-sorting-fields-available-for-each-type-of-diagnostic-information-request).

Beispiel: { “source.alerts”: 10 }| [comment]: # ({/2eb185f8-5149852c}) [comment]: # ({50ca4dca-60e59ca2}) ###### Liste der Statistikfelder, die für jeden Typ von Diagnoseinformationsanfrage verfügbar sind Die folgenden Statistikfelder können für jede Eigenschaft eines Typs von Diagnoseinformationsanfrage angefordert werden. |Diagnosetyp|Verfügbare Felder|Beschreibung| |--|--|------| |historycache|items|Anzahl der zwischengespeicherten Datenpunkte.| |^|values|Anzahl der zwischengespeicherten Werte.| |^|memory|Statistiken zum Shared Memory (freier Speicherplatz, Anzahl verwendeter Blöcke, Anzahl freier Blöcke, maximale Größe eines freien Blocks).| |^|memory.data|Shared-Memory-Statistiken des Verlaufsdatencaches.| |^|memory.index|Shared-Memory-Statistiken des Verlaufsindexcaches.| |valuecache|items|Anzahl der zwischengespeicherten Datenpunkte.| |^|values|Anzahl der zwischengespeicherten Werte.| |^|memory|Statistiken zum Shared Memory (freier Speicherplatz, Anzahl verwendeter Blöcke, Anzahl freier Blöcke, maximale Größe eines freien Blocks).| |^|mode|Modus des Wertecaches.| |preprocessing|values|Anzahl der Werte in der Warteschlange.| |^|preproc.values|Anzahl der Werte in der Warteschlange mit Vorverarbeitungsschritten.| |alerting|alerts|Anzahl der Benachrichtigungen in der Warteschlange.| |lld|rules|Anzahl der Regeln in der Warteschlange.| |^|values|Anzahl der Werte in der Warteschlange.| [comment]: # ({/50ca4dca-60e59ca2}) [comment]: # ({a768b834-09dc3377}) ###### Liste der Sortierfelder, die für jeden Typ von Diagnoseinformationsanfrage verfügbar sind Die folgenden Statistikfelder können verwendet werden, um angeforderte Informationen zu sortieren und zu begrenzen. |Diagnosetyp|Verfügbare Felder|[Typ](/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}) ##### Statistik-Ergebnisobjekt Das Statistik-Ergebnisobjekt wird im Feld `result` des task-Objekts abgerufen. |Eigenschaft|[Type](/manual/api/reference_commentary#data-types)|Beschreibung| |--|--|------| |status|integer|Status des task-Ergebnisses.

Mögliche Werte:
-1 - während der Ausführung des task ist ein Fehler aufgetreten;
0 - das task-Ergebnis wurde erstellt.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*| |data|string/object|Ergebnisse entsprechend dem Statistik-Anfrageobjekt der jeweiligen Diagnoseinformationstask.
Enthält eine Fehlerzeichenfolge, wenn während der Ausführung des task ein Fehler aufgetreten ist.| [comment]: # ({/13093171-e680be6c})