Událost znovuzařazení do fronty úloh

Tato událost se vygeneruje, když Batch znovu zařadí úkol do fronty, aby mohl být znovu naplánovan.

Úkol lze znovu zařadit do fronty po servisních akcích, jako je odstranění uzlů, operace deaktivace úloh, které znovu zařazují úkoly, nebo jiné scénáře obnovy založené na službách.

Když je znovu zařazená úloha naplánována, Batch vygeneruje novou událost Task Start pro tento pozdější pokus.

Následující příklad ukazuje tělo události opětovného frontování úkolu.

{
    "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, a schedulingError jsou vyplněny pouze tehdy, když Batch obsahuje informace o chybě při provádění pro znovu zařazenou úlohu.

Název elementu Typ Poznámky
jobId String ID úlohy obsahující úkol.
id String ID úkolu.
taskType String Typ úkolu. Buď JobManager to znamená, že jde o úkol správce práce, nebo User to není úkol správce práce. Tato událost se nevygeneruje pro úkoly přípravy úlohy, úkoly uvolnění úloh ani zahájení úkolů. Pro tyto úkoly viz Speciální úkolová událost.
systemTaskVersion Int32 Interní čítač opakování úkolu. Interně může služba Batch opakovat úlohu, která bude zohledňovat přechodné problémy. Tyto problémy můžou zahrnovat vnitřní chyby plánování nebo pokusy o zotavení z výpočetních uzlů ve špatném stavu.
requiredSlots Int32 Požadované sloty ke spuštění úlohy.
nodeInfo Komplexní typ Obsahuje informace o výpočetním uzlu, na kterém úkol naposledy běžel.
multiInstanceSettings Komplexní typ Určuje, že úloha je úloha s více instancemi vyžadující více výpočetních uzlů. Podrobnosti najdete zde: multiInstanceSettings
constraints Komplexní typ Omezení provádění, která platí pro tuto úlohu.
executionInfo Komplexní typ Obsahuje informace o stavu vykonání zachyceném při opětovném zařazení úkolu.

nodeInfo

Název elementu Typ Poznámky
poolId String ID poolu, na kterém úkol naposledy běžel.
nodeId String ID uzlu, na kterém úkol naposledy běžel.

multiInstanceSettings

Název elementu Typ Poznámky
numberOfInstances Int32 Počet výpočetních uzlů vyžadovaných úkolem

omezení

Název elementu Typ Poznámky
maxTaskRetryCount Int32 Maximální počet opakování úkolu Služba Batch opakuje úlohu, pokud je jeho ukončovací kód nenulový.

Tato hodnota konkrétně řídí počet opakování. Služba Batch zkouší úlohu jednou a může to zkusit znovu až do tohoto limitu. Pokud je například maximální počet opakování 3, služba Batch se pokusí úkol provést až čtyřikrát (jeden počáteční pokus a tři opakování).

Pokud je maximální počet opakování 0, služba Batch neopakuje úlohy.

Pokud je maximální počet opakování -1, služba Batch opakuje úlohy bez omezení.

Výchozí hodnota je 0 (žádné opakování).

executionInfo

Název elementu Typ Poznámky
startTime DateTime Čas, kdy se úkol naposledy spustil, než byl znovu zařazen do fronty. Pokud by úkol nezačal, toto pole mohlo být vynecháno.
endTime DateTime Čas, kdy úkol naposledy přestal běžet, než byl znovu zařazen do fronty. Pokud by úkol nezačal, toto pole mohlo být vynecháno.
exitCode Int32 Výstupní kód z posledního vykonávání úkolu, když má Batch jeden k hlášení. Jinak je toto pole vynecháno.
retryCount Int32 Počet opakování úlohy službou Batch Úkol se znovu pokusí, pokud ukončí s nenulovým výstupním kódem, až do určeného maximálního počtu pokusů o opakování úkolu.
requeueCount Int32 Počet případů, kdy batch služba úkol znovu zařadila do fronty. V aktuálně emitovaném payloadu toto pole odráží aktuální refront služby pro daný úkol.
result String Servisně definovaný řetězec výsledků pro úkol, když je k dispozici.
schedulingError Komplexní typ Obsahuje podrobné informace o hlášené chybě, pokud jsou k dispozici.

Chyba plánování

Název elementu Typ Poznámky
category String Kategorie chyb, například UserError.
code String Chybový kód, například BadCommandType.
message String Chybová zpráva.
details Array Seznam dvojic jméno-hodnota, který poskytuje podrobnější informace o chybě. Pokud nejsou k dispozici žádné další detailní hodnoty, pole je prázdné.

details

Název elementu Typ Poznámky
name String Detailní jméno.
value String Detailní hodnota.