Task - List
Zobrazí seznam všech úkolů přidružených k zadané úloze.
Informace o úlohách s více instancemi, jako jsou spřaženíId, executionInfo a nodeInfo, odkazují na primární úlohu. Pomocí rozhraní API dílčích úkolů seznamu můžete načíst informace o dílčích úkolůch.
GET {batchUrl}/jobs/{jobId}/tasks?api-version=2024-07-01.20.0
GET {batchUrl}/jobs/{jobId}/tasks?$filter={$filter}&$select={$select}&$expand={$expand}&maxresults={maxresults}&timeout={timeout}&api-version=2024-07-01.20.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. |
api-version
|
query | True |
string |
Verze rozhraní API klienta. |
$expand
|
query |
string |
Klauzule $expand OData. |
|
$filter
|
query |
string |
Klauzule $filter OData. Další informace o vytváření tohoto filtru naleznete v tématu https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-tasks. |
|
$select
|
query |
string |
Klauzule $select OData. |
|
maxresults
|
query |
integer int32 |
Maximální počet položek, které se mají vrátit v odpovědi. Může se vrátit maximálně 1 000 úkolů. |
|
timeout
|
query |
integer int32 |
Maximální doba, po kterou může server strávit zpracováním požadavku v sekundách. Výchozí hodnota je 30 sekund. Pokud je hodnota větší než 30, použije se výchozí hodnota. |
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 dekorace, jako jsou složené závorky, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Určuje, jestli má server v odpovědi vrátit ID požadavku klienta. |
|
ocp-date |
string date-time-rfc1123 |
Čas vydání žádosti. Klientské knihovny obvykle nastavily aktuální systémový čas; explicitně ji nastavte, pokud voláte přímo rozhraní REST API. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Odpověď obsahující seznam úkolů. Hlavičky
|
|
Other Status Codes |
Chyba ze služby Batch. |
Zabezpečení
azure_auth
Tok ověřovacího kódu Microsoft Entra 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 list
Ukázkový požadavek
GET account.region.batch.azure.com/jobs/jobId/tasks?api-version=2024-07-01.20.0
Ukázková odpověď
{
"value": [
{
"id": "task1",
"url": "https://account.region.batch.azure.com/jobs/jobId/tasks/task1",
"eTag": "0x8D4125FD1A825A4",
"creationTime": "2016-11-21T22:43:31.4733476Z",
"lastModified": "2016-11-21T22:43:31.4733476Z",
"state": "active",
"stateTransitionTime": "2016-11-21T22:43:31.4733476Z",
"commandLine": "cmd /c echo task1",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"constraints": {
"maxWallClockTime": "P10675199DT2H48M5.4775807S",
"retentionTime": "P10675199DT2H48M5.4775807S",
"maxTaskRetryCount": 0
},
"requiredSlots": 2,
"executionInfo": {
"retryCount": 0,
"requeueCount": 0
}
},
{
"id": "task2",
"url": "https://account.region.batch.azure.com/jobs/jobId/tasks/task2",
"eTag": "0x8D4125FD2153345",
"creationTime": "2016-11-21T22:43:31.6736345Z",
"lastModified": "2016-11-21T22:43:32.1880389Z",
"state": "active",
"stateTransitionTime": "2016-11-21T22:43:31.6736345Z",
"commandLine": "cmd /c echo task2",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"constraints": {
"maxWallClockTime": "P10675199DT2H48M5.4775807S",
"retentionTime": "P10675199DT2H48M5.4775807S",
"maxTaskRetryCount": 3
},
"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ědu k lokalitě, kterou může služba Batch použít k výběru výpočetního uzlu, na kterém chcete spustit úlohu. |
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 |
Odpověď na chybu přijatá ze služby Azure Batch |
Batch |
Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch |
Cloud |
Úloha Služby Azure Batch. |
Cloud |
Výsledek výpisu úkolů v úloze |
Compute |
Odkaz na identitu přiřazenou uživatelem přidruženou k fondu Batch, který bude používat výpočetní uzel. |
Compute |
Informace o výpočetním uzlu, na kterém byla úloha spuštěna. |
Container |
Vstup cesty a režimu připojení, který chcete připojit k kontejneru úloh. |
Container |
Cesty, které budou připojeny ke kontejneru úlohy kontejneru. |
Container |
Privátní registr kontejneru. |
Container |
Umístění pracovního adresáře úlohy kontejneru. |
Dependency |
Akce, kterou služba Batch provádí na úkolech závislých na tomto úkolu. |
Elevation |
Úroveň zvýšení úrovně uživatele |
Environment |
Proměnná prostředí, která se má nastavit v procesu úkolu. |
Error |
Kategorie chyby. |
Error |
V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva. |
Exit |
Jak by služba Batch měla reagovat, pokud úloha skončí s konkrétním ukončovacím kódem. |
Exit |
Rozsah ukončovací kódy a způsob reakce služby Batch na ukončovací kódy v daném rozsahu. |
Exit |
Určuje, jak má služba Batch reagovat po dokončení úlohy. |
Exit |
Určuje, jak služba Batch reaguje na konkrétní výstupní podmínku. |
Http |
Pár název-hodnota hlavičky HTTP |
Job |
Akce, která se má provést u úlohy obsahující úkol, pokud úkol dokončí s danou podmínkou ukončení a vlastnost Job onTaskFailed je performExitOptionsJobAction. |
Multi |
Nastavení, která určují, jak spustit úlohu s více instancemi. |
Name |
Představuje dvojici název-hodnota. |
Output |
Specifikace pro nahrání souborů z výpočetního uzlu Služby Azure Batch do jiného umístění po dokončení provádění procesu úlohy |
Output |
Určuje cíl 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ů, které se mají stáhnout do výpočetního uzlu. |
Task |
Omezení provádění, která se mají použít pro úlohu. |
Task |
Obsahuje informace o kontejneru, který spouští úloha. |
Task |
Nastavení kontejneru pro úlohu. |
Task |
Určuje všechny závislosti úkolu. Všechny úlohy, které jsou explicitně zadány nebo v rámci rozsahu závislostí musí být dokončeny před naplánování závislého úkolu. |
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, aby bylo možné naplánovat závislý úkol. |
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í v úloze obsahující úkol. |
AffinityInformation
Nápovědu k lokalitě, kterou může služba Batch použít k výběru výpočetního uzlu, na kterém chcete spustit úlohu.
Name | Typ | Description |
---|---|---|
affinityId |
string |
Neprůhlený řetězec představující umístění výpočetního uzlu nebo úlohy, která byla spuštěna dříve. |
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 tuto hodnotu 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
Odpověď na chybu přijatá ze služby Azure Batch
Name | Typ | Description |
---|---|---|
code |
string |
Identifikátor chyby. Kódy jsou invariantní a mají být využity programově. |
message |
Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní. |
|
values |
Kolekce párů klíč-hodnota obsahující další podrobnosti o chybě. |
BatchErrorDetail
Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch
Name | Typ | Description |
---|---|---|
key |
string |
Identifikátor určující význam vlastnosti Value. |
value |
string |
Další informace zahrnuté v odpovědi na chybu. |
CloudTask
Úloha Služby Azure Batch.
Name | Typ | Description |
---|---|---|
affinityInfo |
Nápovědu 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á spustit nový úkol. |
|
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á platí pro tuto úlohu. |
|
containerSettings |
Nastavení kontejneru, pod kterým se úloha spouští. |
|
creationTime |
string |
Čas vytvoření úkolu. |
dependsOn |
Úkoly, na které tento úkol závisí. |
|
displayName |
string |
Zobrazovaný název úkolu. |
eTag |
string |
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 po 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 úloha běžela. |
|
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 se úloha spouští. |
CloudTaskListResult
Výsledek výpisu úkolů v úloze
Name | Typ | Description |
---|---|---|
odata.nextLink |
string |
Adresa URL pro získání další sady výsledků. |
value |
Seznam úkolů. |
ComputeNodeIdentityReference
Odkaz na identitu přiřazenou uživatelem přidruženou k fondu Batch, který bude používat výpočetní uzel.
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 byla úloha spuštěna.
Name | Typ | Description |
---|---|---|
affinityId |
string |
Identifikátor uzlu, na kterém byla spuštěna úloha, která se dá předat při přidání úkolu, který požádá o naplánování úkolu na tomto výpočetním uzlu. |
nodeId |
string |
ID výpočetního uzlu, na kterém úloha běžela. |
nodeUrl |
string |
Adresa URL výpočetního uzlu, na kterém byla úloha spuštěna. |
poolId |
string |
ID fondu, na kterém byla úloha spuštěna. |
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. |
ContainerHostBatchBindMountEntry
Vstup cesty a režimu připojení, který chcete připojit k kontejneru úloh.
Name | Typ | Description |
---|---|---|
isReadOnly |
boolean |
Připojte tuto zdrojovou cestu jako režim jen pro čtení nebo ne. Výchozí hodnota je false (režim čtení a zápisu). |
source |
Cestu, která se připojí k zákazníkovi kontejneru, může vybrat. |
ContainerHostDataPath
Cesty, které budou připojeny ke kontejneru úlohy kontejneru.
Name | Typ | Description |
---|---|---|
Applications |
string |
Cesta k aplikacím. |
JobPrep |
string |
Cesta úkolu přípravy úlohy. |
Shared |
string |
Cesta pro úlohu s více instancemi ke sdílení souborů. |
Startup |
string |
Cesta ke spouštěcímu úkolu. |
Task |
string |
Cesta k úkolu. |
VfsMounts |
string |
Cesta obsahuje všechny virtuální systémy souborů, které jsou připojené k tomuto uzlu. |
ContainerRegistry
Privátní registr kontejneru.
Name | Typ | Description |
---|---|---|
identityReference |
Odkaz na identitu přiřazenou uživatelem, která se má použít pro přístup ke službě 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 úlohy kontejneru.
Name | Typ | Description |
---|---|---|
containerImageDefault |
string |
Použijte pracovní adresář definovaný v imagi kontejneru. Mějte na pozor, že tento adresář nebude obsahovat soubory prostředků stažené službou Batch. |
taskWorkingDirectory |
string |
Použijte standardní pracovní adresář úlohy služby Batch, který bude obsahovat soubory zdrojů úkolů naplněné službou Batch. |
DependencyAction
Akce, kterou služba Batch provádí na úkolech závislých na tomto úkolu.
Name | Typ | Description |
---|---|---|
block |
string |
Blokuje úkoly čekající na tento úkol, což jim brání v naplánování. |
satisfy |
string |
Plnění úkolů čekajících na tento úkol; jakmile budou všechny závislosti splněné, bude úloha naplánována tak, aby se spustila. |
ElevationLevel
Úroveň zvýšení úrovně 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á se má nastavit v procesu úkolu.
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 vnitřní problém se serverem. |
usererror |
string |
Příčinou chyby je problém uživatele, například chybná konfigurace. |
ErrorMessage
V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.
Name | Typ | Description |
---|---|---|
lang |
string |
Kód jazyka chybové zprávy |
value |
string |
Text zprávy. |
ExitCodeMapping
Jak by služba Batch měla reagovat, pokud úloha skončí s konkrétním ukončovacím kódem.
Name | Typ | Description |
---|---|---|
code |
integer |
Ukončovací kód procesu. |
exitOptions |
Jak by služba Batch měla reagovat, pokud úloha skončí s tímto ukončovacím kódem. |
ExitCodeRangeMapping
Rozsah ukončovací kódy a způsob reakce služby Batch na ukončovací kódy v daném rozsahu.
Name | Typ | Description |
---|---|---|
end |
integer |
Poslední ukončovací kód v rozsahu. |
exitOptions |
Jak by služba Batch měla reagovat, pokud úloha skončí s ukončovacím kódem v rozsahu od začátku do konce (včetně). |
|
start |
integer |
První ukončovací kód v oblasti. |
ExitConditions
Určuje, jak má služba Batch reagovat po dokončení úlohy.
Name | Typ | Description |
---|---|---|
default |
Jak by služba Batch měla reagovat, pokud úloha selže s výstupní podmínkou, na kterou se nevztahuje žádná z ostatních vlastností. |
|
exitCodeRanges |
Seznam oblastí ukončovacího kódu úkolu a způsob reakce služby Batch na ně |
|
exitCodes |
Seznam jednotlivých ukončovacích kódů úkolů a způsob reakce služby Batch na ně |
|
fileUploadError |
Jak by služba Batch měla reagovat, pokud dojde k chybě nahrávání souboru. |
|
preProcessingError |
Jak by služba Batch měla reagovat, pokud se úloha nespustí kvůli chybě. |
ExitOptions
Určuje, jak služba Batch reaguje na konkrétní výstupní podmínku.
Name | Typ | Description |
---|---|---|
dependencyAction |
Akce, kterou služba Batch provádí na úkolech závislých na tomto úkolu. |
|
jobAction |
Akce, která se má provést u úlohy obsahující úkol, pokud úkol dokončí s danou podmínkou ukončení a vlastnost Job onTaskFailed je performExitOptionsJobAction. |
HttpHeader
Pár název-hodnota hlavičky HTTP
Name | Typ | Description |
---|---|---|
name |
string |
Název hlavičky bez rozlišování malých a velkých písmen, který se má použít při nahrávání výstupních souborů |
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 u úlohy obsahující úkol, pokud úkol dokončí s danou podmínkou ukončení a vlastnost Job onTaskFailed je performExitOptionsJobAction.
Name | Typ | Description |
---|---|---|
disable |
string |
Zakažte úlohu. To je ekvivalent volání rozhraní API pro zakázání úlohy s hodnotou disableTasks requeue. |
none |
string |
Proveďte žádnou akci. |
terminate |
string |
Ukončete úlohu. Funkce terminateReason v sadě Job's executionInfo je nastavena na "TaskFailed". |
MultiInstanceSettings
Nastavení, která určují, 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 koordinace. |
|
coordinationCommandLine |
string |
Příkazový řádek, který se má spustit na všech výpočetních uzlech, aby bylo možné je koordinovat, když primární spustí hlavní příkaz Úlohy. |
numberOfInstances |
integer |
Počet výpočetních uzlů vyžadovaných úlohou |
NameValuePair
Představuje dvojici název-hodnota.
Name | Typ | Description |
---|---|---|
name |
string |
Název v páru name-value. |
value |
string |
Hodnota v páru name-value. |
OutputFile
Specifikace pro nahrání souborů z výpočetního uzlu Služby Azure Batch do jiného umístění po dokončení provádění procesu úlohy
Name | Typ | Description |
---|---|---|
destination |
Cíl výstupních souborů |
|
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 nahrání souboru v kontejneru úložiště objektů blob v Azure.
Name | Typ | Description |
---|---|---|
containerUrl |
string |
Adresa URL kontejneru ve službě 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 ke službě Azure Blob Storage určenou pomocí containerUrl |
|
path |
string |
Cílový objekt blob nebo virtuální adresář v rámci kontejneru Azure Storage. |
uploadHeaders |
Seznam párů 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 soubory nahrají. |
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 úkolu nahrajte soubory bez ohledu na to, co byl ukončovací kód. |
taskfailure |
string |
Nahrajte soubory až po ukončení procesu úkolu s nenulovým ukončovacím kódem. |
tasksuccess |
string |
Nahrajte soubory až po ukončení procesu úkolu 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á nahrát výstupní soubor úkolu nebo sada souborů. |
ResourceFile
Jeden soubor nebo více souborů, které se mají stáhnout 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í souboru v osmičkovém formátu. |
filePath |
string |
Umístění na výpočetním uzlu, ke kterému chcete stáhnout soubory vzhledem k pracovnímu adresáři úlohy. |
httpUrl |
string |
Adresa URL souboru, který chcete stáhnout. |
identityReference |
Odkaz na identitu přiřazenou uživatelem pro přístup ke službě Azure Blob Storage určené službou storageContainerUrl nebo httpUrl |
|
storageContainerUrl |
string |
Adresa URL kontejneru objektů blob v rámci služby Azure Blob Storage. |
TaskConstraints
Omezení provádění, která se mají použít pro úlohu.
Name | Typ | Description |
---|---|---|
maxTaskRetryCount |
integer |
Maximální počet opakování úkolu. Služba Batch opakuje úlohu, pokud je jeho 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čí v časovém limitu, služba Batch ji ukončí. |
retentionTime |
string |
Minimální doba uchovávání adresáře úloh na výpočetním uzlu, na kterém byl spuštěný, od okamžiku dokončení provádění. Po této době může služba Batch odstranit adresář úloh a veškerý jeho obsah. |
TaskContainerExecutionInformation
Obsahuje informace o kontejneru, který spouští úloha.
Name | Typ | Description |
---|---|---|
containerId |
string |
ID kontejneru. |
error |
string |
Podrobné informace o chybě kontejneru |
state |
string |
Stav kontejneru. |
TaskContainerSettings
Nastavení kontejneru pro úlohu.
Name | Typ | Description |
---|---|---|
containerHostBatchBindMounts |
Cesty, které chcete připojit k úloze kontejneru. |
|
containerRunOptions |
string |
Další možnosti příkazu create kontejneru |
imageName |
string |
Image, která se má použít k vytvoření kontejneru, ve kterém se úloha spustí. |
registry |
Privátní registr, který obsahuje image kontejneru. |
|
workingDirectory |
Umístění pracovního adresáře úlohy kontejneru. |
TaskDependencies
Určuje všechny závislosti úkolu. Všechny úlohy, které jsou explicitně zadány nebo v rámci rozsahu závislostí musí být dokončeny před naplánování závislého úkolu.
Name | Typ | Description |
---|---|---|
taskIdRanges |
Seznam rozsahů ID úkolu, na které tento úkol závisí. Všechny úkoly ve všech oblastech musí být úspěšně dokončeny, aby bylo možné naplánovat závislý úkol. |
|
taskIds |
string[] |
Seznam ID úkolů, na které tento úkol závisí. Všechny úkoly v tomto seznamu musí být úspěšně dokončeny, aby bylo možné naplánovat závislý úkol. |
TaskExecutionInformation
Informace o provádění úlohy.
Name | Typ | Description |
---|---|---|
containerInfo |
Informace o kontejneru, pod 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 |
Nejnovější čas, kdy služba Batch v důsledku požadavku uživatele znovu vytáhla úlohu do fronty. |
lastRetryTime |
string |
Poslední čas, kdy se spustil opakovaný pokus úlohy. |
requeueCount |
integer |
Kolikrát služba Batch v důsledku požadavku uživatele znovu vyčíslila pořadí úkolu. |
result |
Výsledek provádění úlohy. |
|
retryCount |
integer |
Počet opakování úlohy službou Batch |
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 chybě 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 byla úspěšně spuštěna. |
TaskFailureInformation
Informace o selhání úlohy
Name | Typ | Description |
---|---|---|
category |
Kategorie chyby úkolu. |
|
code |
string |
Identifikátor chyby úkolu. Kódy jsou invariantní a mají být využity 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, aby bylo možné naplánovat závislý úkol.
Name | Typ | Description |
---|---|---|
end |
integer |
Poslední ID úkolu v oblasti. |
start |
integer |
První ID úkolu v oblasti. |
TaskState
Stav úkolu.
Name | Typ | Description |
---|---|---|
active |
string |
Úloha se zařadí do fronty a může se spustit, ale aktuálně není přiřazená k výpočetnímu uzlu. Úkol zadá tento stav při jeho vytvoření, když je povolen po zakázání nebo když čeká na opakování po neúspěšném spuštění. |
completed |
string |
Úkol už nemá nárok na spuštění, obvykle proto, že úkol byl úspěšně dokončen nebo úkol úspěšně dokončil a vyčerpal limit opakování. Úkol je také označen jako dokončený, pokud došlo k chybě při spuštění úkolu nebo při ukončení úkolu. |
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ý, úkol se přesune na spuštěný. 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 |
Úloha běží na výpočetním uzlu. To zahrnuje přípravu na úrovni úlohy, jako je stažení souborů prostředků nebo nasazení balíčků zadaných v úloze – 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 poslední aktualizace statistiky. 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í disku provedených úlohou |
startTime |
string |
Počáteční čas časového rozsahu, na který se vztahuje statistika. |
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í úkolu. Doba čekání na úkol je definována jako uplynulý čas mezi vytvořením úkolu a spuštěním úkolu. (Pokud se úloha opakuje kvůli chybám, doba čekání je čas na poslední spuštění úlohy.) |
wallClockTime |
string |
Celkový čas hodin zdí úkolu. |
writeIOGiB |
number |
Celkový počet gibibajtů zapsaných na disk úlohou. |
writeIOps |
integer |
Celkový počet operací zápisu disku 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. |