Uppgiftsombyteshändelse

Denna händelse utlöses när Batch lägger tillbaka en uppgift så att den kan schemaläggas igen.

En uppgift kan ställas i kö efter tjänståtgärder såsom borttagning av noder, jobbavstängningsoperationer som köar uppgifter igen, eller andra tjänstedrivna återställningsscenarier.

När den omställda uppgiften schemaläggs igen, skickar Batch en ny Task Start-händelse för det senare försöket.

Följande exempel visar kroppen i en uppgiftsomköshändelse.

{
    "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, och schedulingError fylls endast när Batch har exekveringsfelinformation för den omköade uppgiften.

Elementnamn	Typ	Notes
jobId	String	ID:t för jobbet som innehåller uppgiften.
id	String	Uppgiftens ID
taskType	String	Typen av uppgift. Det indikerar antingen JobManager att det är en jobbchefsuppgift eller User att det inte är en jobbchefsuppgift. Den här händelsen genereras inte för jobbförberedelseaktiviteter, jobbpubliceringsaktiviteter eller startaktiviteter. För dessa uppgifter, se Specialuppgiftshändelse.
systemTaskVersion	Int32	Den interna återförsöksräknaren för en uppgift. Internt kan Batch-tjänsten försöka utföra en uppgift igen för att ta hänsyn till tillfälliga problem. Dessa problem kan omfatta interna schemaläggningsfel eller försök att återställa från beräkningsnoder i ett felaktigt tillstånd.
requiredSlots	Int32	De platser som krävs för att köra aktiviteten.
nodeInfo	Komplex typ	Innehåller information om den beräkningsnod där uppgiften senast kördes.
multiInstanceSettings	Komplex typ	Anger att uppgiften är en aktivitet med flera instanser som kräver flera beräkningsnoder. Se multiInstanceSettings för mer information.
constraints	Komplex typ	De körningsbegränsningar som gäller för den här uppgiften.
executionInfo	Komplex typ	Innehåller information om exekveringstillståndet som fångades när uppgiften ställdes i ny kö.

nodeInfo

Elementnamn	Typ	Notes
poolId	String	ID:t för poolen där uppgiften senast kördes.
nodeId	String	ID:t för noden där uppgiften senast kördes.

multiInstanceSettings

Elementnamn	Typ	Notes
numberOfInstances	Int32	Antalet beräkningsnoder som krävs av aktiviteten.

Begränsningar

Elementnamn	Typ	Notes
maxTaskRetryCount	Int32	Det maximala antalet gånger som aktiviteten kan försökas igen. Batch-tjänsten försöker utföra en aktivitet igen om dess slutkod inte är noll. Det här värdet styr specifikt antalet återförsök. Batch-tjänsten försöker utföra uppgiften en gång och kan sedan försöka upp till den här gränsen igen. Om det maximala antalet återförsök till exempel är 3, försöker Batch en aktivitet upp till fyra gånger (ett första försök och tre återförsök). Om det maximala antalet återförsök är 0 försöker Batch-tjänsten inte utföra uppgifter igen. Om det maximala antalet återförsök är -1 försöker Batch-tjänsten utföra uppgifter utan begränsning. Standardvärdet är 0 (inga återförsök).

executionInfo

Elementnamn	Typ	Notes
startTime	DateTime	Tiden då uppgiften senast började köras innan den lades i kö. Om uppgiften inte hade påbörjats kunde detta fält utelämnas.
endTime	DateTime	Den tid då uppgiften senast slutade köras innan den sattes i kö igen. Om uppgiften inte hade påbörjats kunde detta fält utelämnas.
exitCode	Int32	Slutkoden från den senaste uppgiftskörningen, när Batch har en att rapportera. Annars utelämnas detta fält.
retryCount	Int32	Antalet gånger som Batch-tjänsten har försökt utföra uppgiften igen. Uppgiften prövas igen om den avslutas med en icke-noll avslutningskod, upp till det angivna maxantalet återbesök av uppgifter.
requeueCount	Int32	Antalet gånger Batch-tjänsten ställde om uppgiften. I den aktuella utsända nyttolasten speglar detta fält tjänstens aktuella omköräknare för uppgiften.
result	String	En tjänstedefinierad resultatsträng för uppgiften när en sådan är tillgänglig.
schedulingError	Komplex typ	Innehåller detaljerad information om det rapporterade felet, om ett sådant finns tillgängligt.

schedulingError

Elementnamn	Typ	Notes
category	String	Felkategorin, till exempel UserError.
code	String	Felkoden, till exempel BadCommandType.
message	String	Felmeddelandet.
details	Array	En lista över namn-värde-par som ger mer detaljer om felet. Om inga extra detaljvärden finns tillgängliga är matrisen tom.

details

Elementnamn	Typ	Notes
name	String	Detaljnamnet.
value	String	Detaljvärdet.