Task-Re-Queue-Ereignis

Dieses Ereignis wird ausgelöst, wenn Batch eine Aufgabe wieder in die Warteschlange setzt, damit sie erneut geplant werden kann.

Eine Aufgabe kann nach Service-Aktionen wie Knotenentfernung, Job-Deaktivierungsoperationen, die Aufgaben neu in die Warteschlange stellen, oder anderen dienstgesteuerten Wiederherstellungsszenarien wieder in die Warteschlange gestellt werden.

Wenn die wieder in der Warteschlange eingeordnete Aufgabe erneut geplant wird, sendet Batch ein neues Task-Startereignis für diesen späteren Versuch.

Das folgende Beispiel zeigt den Körper eines Task-Requeue-Events.

{
    "jobId": "myJob",
    "id": "myTask",
    "taskType": "User",
    "systemTaskVersion": 3,
    "requiredSlots": 1,
    "nodeInfo": {
        "poolId": "pool-001",
        "nodeId": "tvm-257509324_1-20160908t162728z"
    },
    "multiInstanceSettings": {
        "numberOfInstances": 1
    },
    "constraints": {
        "maxTaskRetryCount": 2
    },
    "executionInfo": {
        "startTime": "2016-09-08T16:32:23.799Z",
        "endTime": "2016-09-08T16:34:00.666Z",
        "exitCode": 11,
        "retryCount": 0,
        "requeueCount": 1,
        "result": "failure",
        "schedulingError": {
            "category": "UserError",
            "code": "BadCommandType",
            "message": "Task has invalid command",
            "details": [
                {
                    "name": "Reason",
                    "value": "Access denied"
                }
            ]
        }
    }
}

exitCode, result, und schedulingError werden nur dann gefüllt, wenn Batch Ausführungsfehlerinformationen für die neu in die Warteschlange gestellte Aufgabe enthält.

Elementname	Typ	Hinweise
jobId	String	Die ID des Auftrags, der die Aufgabe enthält.
id	String	Die ID des Tasks.
taskType	String	Der Typ des Vorgangs. Es bedeutet entweder JobManager , dass es sich um eine Aufgabe des Jobmanagers handelt, oder User darum, dass es keine Aufgabe ist. Dieses Ereignis wird nicht für Aufgabenvorbereitungsaufgaben, Aufgaben freigeben oder Aufgaben starten ausgegeben. Für diese Aufgaben siehe Spezialaufgaben-Ereignis.
systemTaskVersion	Int32	Der interne Wiederholungsindikator für einen Vorgang. Intern kann der Batchdienst eine Aufgabe wiederholen, um vorübergehende Probleme zu berücksichtigen. Zu diesen Problemen können interne Planungsfehler oder Versuche zum Wiederherstellen von Computeknoten in einem fehlerhaften Zustand gehören.
requiredSlots	Int32	Die erforderlichen Steckplätze zum Ausführen der Aufgabe.
nodeInfo	Komplexer Typ	Enthält Informationen über den Rechenknoten, auf dem die Aufgabe zuletzt ausgeführt wurde.
multiInstanceSettings	Komplexer Typ	Gibt an, dass es sich bei der Aufgabe um einen Vorgang mit mehreren Instanzen handelt, der mehrere Computeknoten erfordert. Weitere Informationen finden Sie unter multiInstanceSettings.
constraints	Komplexer Typ	Die Ausführungseinschränkungen, die für diesen Vorgang gelten.
executionInfo	Komplexer Typ	Enthält Informationen über den Ausführungszustand, der beim erneuten Queuen der Aufgabe erfasst wurde.

nodeInfo

Elementname	Typ	Hinweise
poolId	String	Die ID des Pools, auf dem die Aufgabe zuletzt ausgeführt wurde.
nodeId	String	Die ID des Knotens, auf dem die Aufgabe zuletzt lief.

multiInstanceSettings

Elementname	Typ	Hinweise
numberOfInstances	Int32	Die Anzahl der Computeknoten, die für den Vorgang erforderlich sind.

Zwänge

Elementname	Typ	Hinweise
maxTaskRetryCount	Int32	Die maximale Anzahl der Wiederholungsversuche des Vorgangs. Der Batchdienst ruft eine Aufgabe erneut auf, wenn der Beendigungscode nicht null ist. Dieser Wert steuert insbesondere die Anzahl der Wiederholungen. Der Batchdienst versucht die Aufgabe einmal und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn beispielsweise die maximale Wiederholungsanzahl 3 ist, versucht Batch eine Aufgabe bis zu vier mal (ein erster Versuch und drei Wiederholungsversuche). Wenn die maximale Wiederholungsanzahl 0 ist, wiederholt der Batchdienst keine Aufgaben. Wenn die maximale Wiederholungsanzahl -1 ist, wiederholt der Batchdienst Vorgänge ohne Beschränkung. Der Standardwert ist 0 (keine Wiederholungen).

Ausführungsinformation

Elementname	Typ	Hinweise
startTime	Datum/Uhrzeit	Die Zeit, in der die Aufgabe zuletzt zu laufen begann, bevor sie wieder in die Warteschlange gestellt wurde. Hätte die Aufgabe nicht begonnen, könnte dieses Feld weggelassen werden.
endTime	Datum/Uhrzeit	Die Zeit, in der die Aufgabe zuletzt aufgehört hat, bevor sie wieder in die Warteschlange gesetzt wurde. Hätte die Aufgabe nicht begonnen, könnte dieses Feld weggelassen werden.
exitCode	Int32	Der Ausgangscode der letzten Aufgabenausführung, wenn Batch einen zu melden hat. Andernfalls wird dieses Feld weggelassen.
retryCount	Int32	Die Anzahl der Wiederholungen des Batchdiensts für den Vorgang. Die Aufgabe wird erneut ausprobiert, wenn sie mit einem von null verschiedenen Ausgangscode ausgeht, bis zur angegebenen maximalen Anzahl von Aufgaben-Wiederholungen.
requeueCount	Int32	Die Anzahl der Male, in denen der Batch-Service die Aufgabe erneut in die Warteschlange gesetzt hat. In der aktuell emittierten Nutzlast spiegelt dieses Feld den aktuellen Re-Queue-Zähler des Dienstes für die Aufgabe wider.
result	String	Eine dienstdefinierte Ergebnisfolge für die Aufgabe, wenn eine verfügbar ist.
schedulingError	Komplexer Typ	Enthält detaillierte Informationen zum gemeldeten Fehler, falls vorhanden.

schedulingError

Elementname	Typ	Hinweise
category	String	Die Fehlerkategorie, zum Beispiel UserError.
code	String	Der Fehlercode, zum Beispiel BadCommandType.
message	String	Die Fehlermeldung.
details	Array	Eine Liste von Namen-Wert-Paaren, die mehr Details zum Fehler liefert. Wenn keine zusätzlichen Detailwerte verfügbar sind, ist das Array leer.

details

Elementname	Typ	Hinweise
name	String	Der Name des Details.
value	String	Der Detailwert.