Taakherwachtrij-event

Dit event wordt geactiveerd wanneer Batch een taak opnieuw in de wachtrij zet zodat deze opnieuw kan worden ingepland.

Een taak kan opnieuw in de rij worden geplaatst na serviceacties zoals het verwijderen van knooppunten, taakdeactiveringsoperaties die taken opnieuw in de wachtrij zetten, of andere servicegedreven herstelscenario's.

Wanneer de opnieuw in de wachtrij geplaatste taak opnieuw wordt ingepland, zendt Batch een nieuw taakstart-event uit voor die latere poging.

Het volgende voorbeeld toont het lichaam van een taak-requeue-gebeurtenis.

{
    "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, en schedulingError worden alleen gevuld wanneer Batch uitvoeringsfoutinformatie heeft voor de opnieuw in de rij geplaatste taak.

Naam van element	Type	Aantekeningen
jobId	String	De id van de taak die de taak bevat.
id	String	De ID van de taak.
taskType	String	Het type taak. Het geeft óf JobManager aan dat het een taak voor een taakmanager is, óf User dat het geen taak voor taakbeheerder is. Deze gebeurtenis wordt niet verzonden voor jobvoorbereidingstaken, jobreleasetaken of begintaken. Voor die taken, zie Speciale taakgebeurtenis.
systemTaskVersion	Int32	De interne teller voor opnieuw proberen voor een taak. Intern kan de Batch-service een taak opnieuw proberen om rekening te houden met tijdelijke problemen. Deze problemen kunnen interne planningsfouten bevatten of pogingen om te herstellen van rekenknooppunten met een slechte status.
requiredSlots	Int32	De vereiste sites om de taak uit te voeren.
nodeInfo	Complexe Type	Bevat informatie over de rekenknoop waarop de taak het laatst is uitgevoerd.
multiInstanceSettings	Complexe Type	Hiermee geeft u op dat de taak een taak met meerdere exemplaren is waarvoor meerdere rekenknooppunten zijn vereist. Zie multiInstanceSettings voor meer informatie.
constraints	Complexe Type	De uitvoeringsbeperkingen die van toepassing zijn op deze taak.
executionInfo	Complexe Type	Bevat informatie over de uitvoeringstoestand die werd vastgelegd toen de taak opnieuw in de wachtrij werd geplaatst.

nodeInfo

Naam van element	Type	Aantekeningen
poolId	String	De ID van de pool waarop de taak het laatst werd uitgevoerd.
nodeId	String	De ID van de node waarop de taak het laatst werd uitgevoerd.

multiInstanceSettings

Naam van element	Type	Aantekeningen
numberOfInstances	Int32	Het aantal rekenknooppunten dat door de taak is vereist.

Beperkingen

Naam van element	Type	Aantekeningen
maxTaskRetryCount	Int32	Het maximum aantal keren dat de taak opnieuw kan worden geprobeerd. De Batch-service probeert een taak opnieuw uit te voeren als de afsluitcode niet-nul is. Deze waarde bepaalt specifiek het aantal nieuwe pogingen. De Batch-service probeert de taak eenmaal uit en probeert vervolgens opnieuw tot deze limiet. Als het maximumaantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch een taak maximaal vier keer (één eerste poging en drie nieuwe pogingen). Als het maximumaantal nieuwe pogingen 0 is, worden taken niet opnieuw geprobeerd door de Batch-service. Als het maximumaantal nieuwe pogingen -1 is, probeert de Batch-service taken zonder limiet opnieuw uit te voeren. De standaardwaarde is 0 (geen nieuwe pogingen).

uitvoeringsinformatie

Naam van element	Type	Aantekeningen
startTime	DateTime	De tijd waarin de taak het laatst begon te draaien voordat hij opnieuw in de wachtrij werd geplaatst. Als de taak niet was begonnen, zou dit veld mogelijk worden weggelaten.
endTime	DateTime	De tijd waarop de taak het laatst stopte met draaien voordat hij opnieuw in de rij werd geplaatst. Als de taak niet was begonnen, zou dit veld mogelijk worden weggelaten.
exitCode	Int32	De exitcode van de meest recente taakuitvoering, wanneer Batch er een moet rapporteren. Anders wordt dit veld weggelaten.
retryCount	Int32	Het aantal keren dat de Batch-service de taak opnieuw heeft geprobeerd. De taak wordt opnieuw geprobeerd als deze afsluit met een niet-nul exitcode, tot het opgegeven maximale aantal taakherhalingen.
requeueCount	Int32	Het aantal keren dat de Batch-service de taak opnieuw in de rij zette. In de huidige uitgezonden payload weerspiegelt dit veld de huidige herqueue-teller van de service voor de taak.
result	String	Een servicegedefinieerde resultaatstring voor de taak wanneer die beschikbaar is.
schedulingError	Complexe Type	Bevat gedetailleerde informatie over de gerapporteerde fout, indien beschikbaar.

schedulingError

Naam van element	Type	Aantekeningen
category	String	De foutcategorie, bijvoorbeeld UserError.
code	String	De foutcode, bijvoorbeeld BadCommandType.
message	String	Het foutbericht.
details	Array	Een lijst van naam-waardeparen die meer details geeft over de fout. Als er geen extra detailwaarden beschikbaar zijn, is de array leeg.

details

Naam van element	Type	Aantekeningen
name	String	De naam van het detail.
value	String	De detailwaarde.