Task - Get
Získá informace o zadaném úkolu.
Informace o úlohách s více instancemi, jako jsou affinityId, executionInfo a nodeInfo, odkazují na primární úlohu. K načtení informací o dílčích úkolůch použijte rozhraní API seznamu dílčích úkolů.
GET {batchUrl}/jobs/{jobId}/tasks/{taskId}?api-version=2023-11-01.18.0
GET {batchUrl}/jobs/{jobId}/tasks/{taskId}?$select={$select}&$expand={$expand}&timeout={timeout}&api-version=2023-11-01.18.0
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
batch
|
path | True |
string |
Základní adresa URL pro všechny požadavky služby Azure Batch. |
job
|
path | True |
string |
ID úlohy, která obsahuje úkol. |
task
|
path | True |
string |
ID úlohy, o které chcete získat informace. |
api-version
|
query | True |
string |
Verze klientského rozhraní API. |
$expand
|
query |
string |
Klauzule $expand OData. |
|
$select
|
query |
string |
Klauzule $select OData. |
|
timeout
|
query |
integer int32 |
Maximální čas, který může server strávit zpracováním požadavku, v sekundách. Výchozí hodnota je 30 sekund. |
Hlavička požadavku
Media Types: "application/json; odata=minimalmetadata"
Name | Vyžadováno | Typ | Description |
---|---|---|---|
client-request-id |
string uuid |
Identita požadavku vygenerovaná volajícím ve formě identifikátoru GUID bez ozdob, jako jsou složené závorky, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Jestli má server v odpovědi vrátit client-request-id. |
|
ocp-date |
string date-time-rfc1123 |
Čas, kdy byla žádost vystavena. Klientské knihovny obvykle tuto možnost nastaví na aktuální systémový čas. pokud přímo voláte rozhraní REST API, nastavte ho explicitně. |
|
If-Match |
string |
Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značka ETag prostředku ve službě přesně odpovídá hodnotě zadané klientem. |
|
If-None-Match |
string |
Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značka ETag prostředku ve službě neodpovídá hodnotě zadané klientem. |
|
If-Modified-Since |
string date-time-rfc1123 |
Časové razítko označující čas poslední změny prostředku známého klientovi. Operace se provede pouze v případě, že se prostředek ve službě od zadaného času změnil. |
|
If-Unmodified-Since |
string date-time-rfc1123 |
Časové razítko označující čas poslední změny prostředku známého klientovi. Operace se provede pouze v případě, že prostředek ve službě nebyl od zadaného času změněn. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Odpověď obsahující úkol. Hlavičky
|
|
Other Status Codes |
Chyba ze služby Batch. |
Zabezpečení
azure_auth
Microsoft Entra tok kódu ověřování OAuth 2.0
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
Name | Description |
---|---|
user_impersonation | Zosobnění uživatelského účtu |
Authorization
Typ:
apiKey
V:
header
Příklady
Task get
Ukázkový požadavek
GET account.region.batch.azure.com/jobs/jobId/tasks/taskId?api-version=2023-11-01.18.0
Ukázková odpověď
{
"id": "testTask",
"url": "https://account.region.batch.azure.com/jobs/jobId/tasks/taskId",
"eTag": "0x8D3D62350711C55",
"creationTime": "2016-09-06T06:59:15.1161429Z",
"lastModified": "2016-09-06T06:59:15.1161429Z",
"state": "active",
"stateTransitionTime": "2016-09-06T06:59:15.1161429Z",
"commandLine": "cmd /c hostname",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"multiInstanceSettings": {
"numberOfInstances": 3,
"coordinationCommandLine": "cmd /c echo coordinating"
},
"constraints": {
"maxWallClockTime": "P10675199DT2H48M5.4775807S",
"retentionTime": "P10675199DT2H48M5.4775807S",
"maxTaskRetryCount": 0
},
"requiredSlots": 2,
"executionInfo": {
"retryCount": 0,
"requeueCount": 0
}
}
Definice
Name | Description |
---|---|
Access |
Prostředky služby Batch, ke kterým token uděluje přístup. |
Affinity |
Nápověda k umístění, kterou může služba Batch použít k výběru výpočetního uzlu, na kterém se má úkol spustit. |
Application |
Odkaz na balíček, který se má nasadit do výpočetních uzlů. |
Authentication |
Nastavení ověřovacího tokenu, který může úloha použít k provádění operací služby Batch. |
Auto |
Obor automatického uživatele |
Auto |
Určuje parametry pro automatického uživatele, který spouští úlohu ve službě Batch. |
Batch |
Služba Azure Batch obdržela chybovou odpověď. |
Batch |
Položka s dalšími informacemi, které jsou součástí Azure Batch chybové odpovědi. |
Cloud |
Úkol Azure Batch. |
Compute |
Odkaz na identitu přiřazenou uživatelem přidruženou k fondu služby Batch, který bude výpočetní uzel používat. |
Compute |
Informace o výpočetním uzlu, na kterém se úloha spustila. |
Container |
Privátní registr kontejneru. |
Container |
Umístění pracovního adresáře úloh kontejneru. |
Dependency |
Akce, kterou služba Batch provádí u úloh, které jsou na této úloze závislé. |
Elevation |
Úroveň zvýšení oprávnění uživatele. |
Environment |
Proměnná prostředí, která má být nastavena pro proces úlohy. |
Error |
Kategorie chyby. |
Error |
Chybová zpráva přijatá v Azure Batch chybovou odpověď. |
Exit |
Jak by měla služba Batch reagovat, když se úloha ukončí s konkrétním ukončovacím kódem. |
Exit |
Rozsah ukončovací kódy a způsob, jakým má služba Batch reagovat na ukončovací kódy v daném rozsahu. |
Exit |
Určuje, jak má služba Batch reagovat na dokončení úlohy. |
Exit |
Určuje, jak služba Batch reaguje na konkrétní ukončovací podmínku. |
Http |
Pár název-hodnota hlavičky HTTP |
Job |
Akce, která se má provést s úlohou obsahující úlohu, pokud se úkol dokončí s danou výstupní podmínkou a vlastnost úlohy onTaskFailed je performExitOptionsJobAction. |
Multi |
Nastavení určující, jak spustit úlohu s více instancemi. |
Name |
Představuje dvojici název-hodnota. |
Output |
Specifikace pro nahrávání souborů z Azure Batch výpočetního uzlu do jiného umístění po dokončení procesu úkolu službou Batch. |
Output |
Určuje cíl pro nahrání souboru v kontejneru úložiště objektů blob v Azure. |
Output |
Cíl, do kterého se má soubor nahrát. |
Output |
Podmínky, za kterých se má nahrát výstupní soubor úkolu nebo sada souborů. |
Output |
Podrobnosti o operaci nahrávání výstupního souboru, včetně toho, za jakých podmínek se má nahrávání provést. |
Resource |
Jeden soubor nebo více souborů ke stažení do výpočetního uzlu. |
Task |
Omezení provádění, která se mají použít pro úlohu. |
Task |
Obsahuje informace o kontejneru, který úloha provádí. |
Task |
Nastavení kontejneru pro úlohu. |
Task |
Určuje všechny závislosti úlohy. Každá úloha, která je explicitně určena nebo v rozsahu závislostí, musí být dokončena před naplánování závislé úlohy. |
Task |
Informace o provádění úlohy. |
Task |
Výsledek spuštění úlohy. |
Task |
Informace o selhání úlohy |
Task |
Rozsah ID úkolů, na které může úkol záviset. Všechny úkoly s ID v rozsahu musí být úspěšně dokončeny před naplánováním závislé úlohy. |
Task |
Stav úkolu. |
Task |
Statistika využití zdrojů pro úkol. |
User |
Definice identity uživatele, pod kterou je úloha spuštěna. |
AccessScope
Prostředky služby Batch, ke kterým token uděluje přístup.
Name | Typ | Description |
---|---|---|
job |
string |
Uděluje přístup k provádění všech operací s úlohou obsahující úlohu. |
AffinityInformation
Nápověda k umístění, kterou může služba Batch použít k výběru výpočetního uzlu, na kterém se má úkol spustit.
Name | Typ | Description |
---|---|---|
affinityId |
string |
Neprůžný řetězec představující umístění výpočetního uzlu nebo úlohy, která byla dříve spuštěna. |
ApplicationPackageReference
Odkaz na balíček, který se má nasadit do výpočetních uzlů.
Name | Typ | Description |
---|---|---|
applicationId |
string |
ID aplikace, která se má nasadit. |
version |
string |
Verze aplikace, která se má nasadit. Pokud tento parametr vynecháte, nasadí se výchozí verze. |
AuthenticationTokenSettings
Nastavení ověřovacího tokenu, který může úloha použít k provádění operací služby Batch.
Name | Typ | Description |
---|---|---|
access |
Prostředky služby Batch, ke kterým token uděluje přístup. |
AutoUserScope
Obor automatického uživatele
Name | Typ | Description |
---|---|---|
pool |
string |
Určuje, že úloha se spustí jako běžný účet automatického uživatele, který se vytvoří na každém výpočetním uzlu ve fondu. |
task |
string |
Určuje, že služba by měla pro úlohu vytvořit nového uživatele. |
AutoUserSpecification
Určuje parametry pro automatického uživatele, který spouští úlohu ve službě Batch.
Name | Typ | Description |
---|---|---|
elevationLevel |
Úroveň zvýšení oprávnění automatického uživatele. |
|
scope |
Obor automatického uživatele |
BatchError
Služba Azure Batch obdržela chybovou odpověď.
Name | Typ | Description |
---|---|---|
code |
string |
Identifikátor chyby. Kódy jsou neutrální a mají být využívány programově. |
message |
Zpráva popisující chybu, která má být vhodná k zobrazení v uživatelském rozhraní. |
|
values |
Kolekce párů klíč-hodnota obsahující další podrobnosti o chybě. |
BatchErrorDetail
Položka s dalšími informacemi, které jsou součástí Azure Batch chybové odpovědi.
Name | Typ | Description |
---|---|---|
key |
string |
Identifikátor určující význam value vlastnost. |
value |
string |
Další informace zahrnuté v chybové odpovědi. |
CloudTask
Úkol Azure Batch.
Name | Typ | Description |
---|---|---|
affinityInfo |
Tip lokality, který může služba Batch použít k výběru výpočetního uzlu, na kterém se má nový úkol spustit. |
|
applicationPackageReferences |
Seznam balíčků, které služba Batch nasadí do výpočetního uzlu před spuštěním příkazového řádku. |
|
authenticationTokenSettings |
Nastavení ověřovacího tokenu, který může úloha použít k provádění operací služby Batch. |
|
commandLine |
string |
Příkazový řádek úkolu. |
constraints |
Omezení provádění, která se vztahují na tuto úlohu. |
|
containerSettings |
Nastavení kontejneru, ve kterém se úloha spouští. |
|
creationTime |
string |
Čas vytvoření úkolu. |
dependsOn |
Úkoly, na které závisí tento úkol. |
|
displayName |
string |
Zobrazovaný název úkolu. |
eTag |
string |
Značka ETag úkolu. |
environmentSettings |
Seznam nastavení proměnných prostředí pro úlohu. |
|
executionInfo |
Informace o provádění úlohy. |
|
exitConditions |
Určuje, jak má služba Batch reagovat na dokončení úlohy. |
|
id |
string |
Řetězec, který jednoznačně identifikuje úkol v rámci úlohy. |
lastModified |
string |
Čas poslední změny úkolu. |
multiInstanceSettings |
Objekt, který označuje, že úloha je úloha s více instancemi a obsahuje informace o tom, jak spustit úlohu s více instancemi. |
|
nodeInfo |
Informace o výpočetním uzlu, na kterém se úloha spustila. |
|
outputFiles |
Seznam souborů, které služba Batch nahraje z výpočetního uzlu po spuštění příkazového řádku. |
|
previousState |
Předchozí stav úkolu. |
|
previousStateTransitionTime |
string |
Čas, kdy úkol vstoupil do předchozího stavu. |
requiredSlots |
integer |
Počet slotů plánování, které úloha vyžaduje ke spuštění. |
resourceFiles |
Seznam souborů, které služba Batch stáhne do výpočetního uzlu před spuštěním příkazového řádku. |
|
state |
Aktuální stav úkolu. |
|
stateTransitionTime |
string |
Čas, kdy úkol vstoupil do aktuálního stavu. |
stats |
Statistika využití zdrojů pro úkol. |
|
url |
string |
Adresa URL úkolu. |
userIdentity |
Identita uživatele, pod kterou je úloha spuštěna. |
ComputeNodeIdentityReference
Odkaz na identitu přiřazenou uživatelem přidruženou k fondu služby Batch, který bude výpočetní uzel používat.
Name | Typ | Description |
---|---|---|
resourceId |
string |
ID prostředku ARM identity přiřazené uživatelem. |
ComputeNodeInformation
Informace o výpočetním uzlu, na kterém se úloha spustila.
Name | Typ | Description |
---|---|---|
affinityId |
string |
Identifikátor uzlu, na kterém byl úkol spuštěn, který lze předat při přidávání úkolu, který vyžaduje naplánování úkolu na tomto výpočetním uzlu. |
nodeId |
string |
ID výpočetního uzlu, na kterém se úloha spustila. |
nodeUrl |
string |
Adresa URL výpočetního uzlu, na kterém se úloha spustila. |
poolId |
string |
ID fondu, ve kterém se úloha spustila. |
taskRootDirectory |
string |
Kořenový adresář úlohy na výpočetním uzlu. |
taskRootDirectoryUrl |
string |
Adresa URL kořenového adresáře úlohy na výpočetním uzlu. |
ContainerRegistry
Privátní registr kontejneru.
Name | Typ | Description |
---|---|---|
identityReference |
Odkaz na identitu přiřazenou uživatelem, která se použije pro přístup k Azure Container Registry místo uživatelského jména a hesla. |
|
password |
string |
Heslo pro přihlášení k serveru registru. |
registryServer |
string |
Adresa URL registru. |
username |
string |
Uživatelské jméno pro přihlášení k serveru registru. |
ContainerWorkingDirectory
Umístění pracovního adresáře úloh kontejneru.
Name | Typ | Description |
---|---|---|
containerImageDefault |
string |
Použijte pracovní adresář definovaný v imagi kontejneru. Mějte na pozoru, že tento adresář nebude obsahovat soubory prostředků stažené službou Batch. |
taskWorkingDirectory |
string |
Použijte standardní pracovní adresář úkolů služby Batch, který bude obsahovat soubory zdrojů úkolů naplněné službou Batch. |
DependencyAction
Akce, kterou služba Batch provádí u úloh, které jsou na této úloze závislé.
Name | Typ | Description |
---|---|---|
block |
string |
Blokuje úkoly čekající na tento úkol a brání jejich naplánování. |
satisfy |
string |
Splnění úkolů čekajících na tento úkol; Jakmile budou všechny závislosti splněny, bude úloha naplánovaná na spuštění. |
ElevationLevel
Úroveň zvýšení oprávnění uživatele.
Name | Typ | Description |
---|---|---|
admin |
string |
Uživatel je uživatel se zvýšeným přístupem a pracuje s úplnými oprávněními správce. |
nonadmin |
string |
Uživatel je standardní uživatel bez zvýšeného přístupu. |
EnvironmentSetting
Proměnná prostředí, která má být nastavena pro proces úlohy.
Name | Typ | Description |
---|---|---|
name |
string |
Název proměnné prostředí. |
value |
string |
Hodnota proměnné prostředí. |
ErrorCategory
Kategorie chyby.
Name | Typ | Description |
---|---|---|
servererror |
string |
Příčinou chyby je interní problém se serverem. |
usererror |
string |
Příčinou chyby je problém s uživatelem, například chybná konfigurace. |
ErrorMessage
Chybová zpráva přijatá v Azure Batch chybovou odpověď.
Name | Typ | Description |
---|---|---|
lang |
string |
Kód jazyka chybové zprávy |
value |
string |
Text zprávy |
ExitCodeMapping
Jak by měla služba Batch reagovat, když se úloha ukončí s konkrétním ukončovacím kódem.
Name | Typ | Description |
---|---|---|
code |
integer |
Ukončovací kód procesu. |
exitOptions |
Jak by měla služba Batch reagovat, pokud se úloha ukončí s tímto ukončovacím kódem. |
ExitCodeRangeMapping
Rozsah ukončovací kódy a způsob, jakým má služba Batch reagovat na ukončovací kódy v daném rozsahu.
Name | Typ | Description |
---|---|---|
end |
integer |
Poslední ukončovací kód v rozsahu. |
exitOptions |
Jak by měla služba Batch reagovat, pokud se úloha ukončí s ukončovacím kódem v rozsahu od začátku do konce (včetně). |
|
start |
integer |
První ukončovací kód v rozsahu. |
ExitConditions
Určuje, jak má služba Batch reagovat na dokončení úlohy.
Name | Typ | Description |
---|---|---|
default |
Jak by měla služba Batch reagovat, pokud úloha selže s výstupní podmínkou, která není pokryta žádnou z ostatních vlastností. |
|
exitCodeRanges |
Seznam rozsahů ukončovacích kódů úlohy a způsob, jakým na ně má služba Batch reagovat. |
|
exitCodes |
Seznam jednotlivých ukončovací kódy úkolu a způsob, jakým na ně má služba Batch reagovat. |
|
fileUploadError |
Jak by měla služba Batch reagovat, pokud dojde k chybě nahrávání souboru. |
|
preProcessingError |
Jak by měla služba Batch reagovat, pokud se úloha nespustí kvůli chybě. |
ExitOptions
Určuje, jak služba Batch reaguje na konkrétní ukončovací podmínku.
Name | Typ | Description |
---|---|---|
dependencyAction |
Akce, kterou služba Batch provádí u úkolů závislých na tomto úkolu. |
|
jobAction |
Akce, která se má provést u úlohy obsahující úkol, pokud se úkol dokončí s danou výstupní podmínkou a vlastností úlohy onTaskFailed je performExitOptionsJobAction. |
HttpHeader
Pár název-hodnota hlavičky HTTP
Name | Typ | Description |
---|---|---|
name |
string |
Název hlavičky, která se má použít při nahrávání výstupních souborů, nerozlišují malá a velká písmena. |
value |
string |
Hodnota hlavičky, která se má použít při nahrávání výstupních souborů |
JobAction
Akce, která se má provést s úlohou obsahující úlohu, pokud se úkol dokončí s danou výstupní podmínkou a vlastnost úlohy onTaskFailed je performExitOptionsJobAction.
Name | Typ | Description |
---|---|---|
disable |
string |
Zakažte úlohu. To je ekvivalent volání rozhraní API pro úlohy disable s hodnotou disableTasks requeue. |
none |
string |
Nechejte žádnou akci. |
terminate |
string |
Ukončete úlohu. TerminateReason v sadě ExecutionInfo úlohy je nastavená na TaskFailed. |
MultiInstanceSettings
Nastavení určující, jak spustit úlohu s více instancemi.
Name | Typ | Description |
---|---|---|
commonResourceFiles |
Seznam souborů, které služba Batch stáhne před spuštěním příkazového řádku pro koordinaci. |
|
coordinationCommandLine |
string |
Příkazový řádek, který se spustí na všech výpočetních uzlech, aby mohly koordinovat, když primární uzel spustí hlavní příkaz Task. |
numberOfInstances |
integer |
Počet výpočetních uzlů požadovaných úlohou. |
NameValuePair
Představuje dvojici název-hodnota.
Name | Typ | Description |
---|---|---|
name |
string |
Název ve dvojici název-hodnota. |
value |
string |
Hodnota ve dvojici název-hodnota. |
OutputFile
Specifikace pro nahrávání souborů z Azure Batch výpočetního uzlu do jiného umístění po dokončení procesu úkolu službou Batch.
Name | Typ | Description |
---|---|---|
destination |
Cíl pro výstupní soubory. |
|
filePattern |
string |
Vzor označující, které soubory se mají nahrát. |
uploadOptions |
Další možnosti operace nahrávání, včetně toho, za jakých podmínek se má nahrávání provést. |
OutputFileBlobContainerDestination
Určuje cíl pro nahrání souboru v kontejneru úložiště objektů blob v Azure.
Name | Typ | Description |
---|---|---|
containerUrl |
string |
Adresa URL kontejneru v rámci Azure Blob Storage, do které se mají nahrát soubory. |
identityReference |
Odkaz na identitu přiřazenou uživatelem, která se má použít pro přístup k Azure Blob Storage určené pomocí containerUrl |
|
path |
string |
Cílový objekt blob nebo virtuální adresář v kontejneru Azure Storage. |
uploadHeaders |
Seznam dvojic název-hodnota pro hlavičky, které se mají použít při nahrávání výstupních souborů |
OutputFileDestination
Cíl, do kterého se má soubor nahrát.
Name | Typ | Description |
---|---|---|
container |
Umístění v úložišti objektů blob v Azure, do kterého se nahrají soubory. |
OutputFileUploadCondition
Podmínky, za kterých se má nahrát výstupní soubor úkolu nebo sada souborů.
Name | Typ | Description |
---|---|---|
taskcompletion |
string |
Po ukončení procesu úlohy nahrajte soubory bez ohledu na to, jaký byl ukončovací kód. |
taskfailure |
string |
Nahrajte soubory až po ukončení procesu úlohy s nenulovým ukončovacím kódem. |
tasksuccess |
string |
Nahrajte soubory až po ukončení procesu úlohy s ukončovacím kódem 0. |
OutputFileUploadOptions
Podrobnosti o operaci nahrávání výstupního souboru, včetně toho, za jakých podmínek se má nahrávání provést.
Name | Typ | Description |
---|---|---|
uploadCondition |
Podmínky, za kterých se má výstupní soubor úkolu nebo sada souborů nahrát. |
ResourceFile
Jeden soubor nebo více souborů ke stažení do výpočetního uzlu.
Name | Typ | Description |
---|---|---|
autoStorageContainerName |
string |
Název kontejneru úložiště v účtu automatického úložiště. |
blobPrefix |
string |
Předpona objektu blob, která se má použít při stahování objektů blob z kontejneru Azure Storage. Stáhnou se jenom objekty blob, jejichž názvy začínají zadanou předponou. |
fileMode |
string |
Atribut režimu oprávnění k souboru v osmičkovém formátu. |
filePath |
string |
Umístění na výpočetním uzlu, do kterého se mají soubory stáhnout, vzhledem k pracovnímu adresáři úkolu. |
httpUrl |
string |
Adresa URL souboru, který se má stáhnout. |
identityReference |
Odkaz na identitu přiřazenou uživatelem pro přístup k Azure Blob Storage určený storageContainerUrl nebo httpUrl |
|
storageContainerUrl |
string |
Adresa URL kontejneru objektů blob v rámci Azure Blob Storage. |
TaskConstraints
Omezení provádění, která se mají použít pro úlohu.
Name | Typ | Description |
---|---|---|
maxTaskRetryCount |
integer |
Maximální počet pokusů o opakování úkolu Služba Batch opakuje úlohu, pokud je její ukončovací kód nenulový. |
maxWallClockTime |
string |
Maximální uplynulý čas, po který může úloha běžet, měřená od okamžiku spuštění úlohy. Pokud se úkol nedokončil ve stanoveném časovém limitu, služba Batch ho ukončí. |
retentionTime |
string |
Minimální doba uchování adresáře úkolů na výpočetním uzlu, na kterém byl spuštěný, od okamžiku dokončení provádění. Po uplynutí této doby může služba Batch odstranit adresář úkolů a veškerý jeho obsah. |
TaskContainerExecutionInformation
Obsahuje informace o kontejneru, který úloha provádí.
Name | Typ | Description |
---|---|---|
containerId |
string |
ID kontejneru. |
error |
string |
Podrobné informace o chybě o kontejneru |
state |
string |
Stav kontejneru. |
TaskContainerSettings
Nastavení kontejneru pro úlohu.
Name | Typ | Description |
---|---|---|
containerRunOptions |
string |
Další možnosti příkazu container create |
imageName |
string |
Image, která se má použít k vytvoření kontejneru, ve kterém bude úloha spuštěna. |
registry |
Privátní registr, který obsahuje image kontejneru. |
|
workingDirectory |
Umístění pracovního adresáře úloh kontejneru. |
TaskDependencies
Určuje všechny závislosti úlohy. Každá úloha, která je explicitně určena nebo v rozsahu závislostí, musí být dokončena před naplánování závislé úlohy.
Name | Typ | Description |
---|---|---|
taskIdRanges |
Seznam rozsahů ID úlohy, na které závisí tento úkol. Před naplánování závislé úlohy musí být všechny úkoly ve všech oblastech úspěšně dokončeny. |
|
taskIds |
string[] |
Seznam ID úkolů, na které závisí tento úkol. Všechny úkoly v tomto seznamu musí být úspěšně dokončeny před tím, než bude možné naplánovat závislý úkol. |
TaskExecutionInformation
Informace o provádění úlohy.
Name | Typ | Description |
---|---|---|
containerInfo |
Informace o kontejneru, ve kterém se úloha spouští. |
|
endTime |
string |
Čas dokončení úkolu. |
exitCode |
integer |
Ukončovací kód programu zadaný na příkazovém řádku úkolu. |
failureInfo |
Informace popisující selhání úlohy, pokud existuje. |
|
lastRequeueTime |
string |
Poslední čas, kdy byla úloha znovu zadána službou Batch na základě požadavku uživatele. |
lastRetryTime |
string |
Poslední čas, kdy se spustilo opakování úlohy. |
requeueCount |
integer |
Počet opětovného zařazení úlohy do fronty službou Batch v důsledku požadavku uživatele. |
result |
Výsledek spuštění úlohy. |
|
retryCount |
integer |
Kolikrát služba Batch úlohu zopakovala. |
startTime |
string |
Čas, kdy úloha začala běžet. |
TaskExecutionResult
Výsledek spuštění úlohy.
Name | Typ | Description |
---|---|---|
failure |
string |
Při zpracování úlohy došlo k chybě. K selhání mohlo dojít před spuštěním procesu úkolu, během provádění procesu úkolu nebo po ukončení procesu úkolu. |
success |
string |
Úloha se úspěšně spustila. |
TaskFailureInformation
Informace o selhání úlohy
Name | Typ | Description |
---|---|---|
category |
Kategorie chyby Úlohy. |
|
code |
string |
Identifikátor chyby úlohy. Kódy jsou invariantní a mají být využívány programově. |
details |
Seznam dalších podrobností souvisejících s chybou |
|
message |
string |
Zpráva popisující chybu Úlohy, která má být vhodná pro zobrazení v uživatelském rozhraní. |
TaskIdRange
Rozsah ID úkolů, na které může úkol záviset. Všechny úkoly s ID v rozsahu musí být úspěšně dokončeny před naplánováním závislé úlohy.
Name | Typ | Description |
---|---|---|
end |
integer |
ID posledního úkolu v oblasti. |
start |
integer |
Id prvního úkolu v oblasti. |
TaskState
Stav úkolu.
Name | Typ | Description |
---|---|---|
active |
string |
Úloha je zařazená do fronty a může se spustit, ale aktuálně není přiřazená k výpočetnímu uzlu. Úloha přejde do tohoto stavu, když je vytvořena, když je povolena po zakázání nebo když čeká na opakování po neúspěšném spuštění. |
completed |
string |
Úloha již není způsobilá ke spuštění, obvykle z důvodu úspěšného dokončení úlohy nebo neúspěšného dokončení a vyčerpání limitu opakování. Úkol je také označen jako dokončený, pokud při spouštění úlohy došlo k chybě nebo když byl úkol ukončen. |
preparing |
string |
Úkol byl přiřazen výpočetnímu uzlu, ale čeká na dokončení požadovaného úkolu přípravy úlohy na výpočetním uzlu. Pokud je úkol přípravy úlohy úspěšný, přesune se do spuštěného úkolu. Pokud úkol přípravy úlohy selže, úkol se vrátí do aktivního a bude mít nárok na přiřazení k jinému výpočetnímu uzlu. |
running |
string |
Úkol běží na výpočetním uzlu. To zahrnuje přípravu na úrovni úkolu, jako je stahování souborů prostředků nebo nasazení balíčků zadaných u úkolu – nemusí to nutně znamenat, že se spustil příkazový řádek úkolu. |
TaskStatistics
Statistika využití zdrojů pro úkol.
Name | Typ | Description |
---|---|---|
kernelCPUTime |
string |
Celkový čas procesoru v režimu jádra (sečtený napříč všemi jádry a všemi výpočetními uzly) spotřebovaný úlohou. |
lastUpdateTime |
string |
Čas, kdy byly statistiky naposledy aktualizovány. Všechny statistiky jsou omezené na rozsah mezi startTime a lastUpdateTime. |
readIOGiB |
number |
Celkový počet gibibajtů přečtených z disku úlohou. |
readIOps |
integer |
Celkový počet operací čtení z disku provedených úlohou. |
startTime |
string |
Počáteční čas časového rozsahu, na který se statistika vztahuje. |
url |
string |
Adresa URL statistiky. |
userCPUTime |
string |
Celkový čas procesoru v uživatelském režimu (sečtený napříč všemi jádry a všemi výpočetními uzly) spotřebovaný úlohou. |
waitTime |
string |
Celková doba čekání úlohy. Čekací doba úlohy je definována jako uplynulý čas mezi vytvořením úlohy a spuštěním úlohy. (Pokud se úloha zopakuje kvůli selháním, čekací doba je doba do posledního spuštění úlohy.) |
wallClockTime |
string |
Celkový čas hodin úkolu. |
writeIOGiB |
number |
Celkový počet gibibajtů zapsaných na disk úlohou. |
writeIOps |
integer |
Celkový počet operací zápisu na disk provedených úlohou. |
UserIdentity
Definice identity uživatele, pod kterou je úloha spuštěna.
Name | Typ | Description |
---|---|---|
autoUser |
Automatický uživatel, pod kterým je úloha spuštěna. |
|
username |
string |
Název identity uživatele, pod kterou je úloha spuštěna. |