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.
  • Last updated on