Pool - Patch

Service:

Batch Service

API Version:

2023-11-01.18.0

Aktualizace vlastnosti zadaného fondu.
Tím se nahradí pouze vlastnosti fondu zadané v požadavku. Pokud má například fond přidružený StartTask a požadavek nezadá element StartTask, pak fond zachová existující StartTask.

PATCH {batchUrl}/pools/{poolId}?api-version=2023-11-01.18.0

With optional parameters:

PATCH {batchUrl}/pools/{poolId}?timeout={timeout}&api-version=2023-11-01.18.0

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
batchUrl	path	True	string	Základní adresa URL pro všechny požadavky služby Azure Batch.
poolId	path	True	string	ID fondu, který se má aktualizovat.
api-version	query	True	string	Verze klientského rozhraní API.
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.

Text požadavku

Media Types: "application/json; odata=minimalmetadata"

Name	Typ	Description
applicationPackageReferences	ApplicationPackageReference[]	Seznam balíčků, které se mají nainstalovat na každý výpočetní uzel ve fondu. Změny odkazů na balíčky mají vliv na všechny nové uzly, které se připojují k fondu, ale nemají vliv na výpočetní uzly, které už jsou ve fondu, dokud se nerestartují nebo nereimagují. Pokud je tento prvek k dispozici, nahradí všechny existující odkazy na balíček. Pokud zadáte prázdnou kolekci, odeberou se z fondu všechny odkazy na balíčky. Pokud je vynechán, všechny existující odkazy na balíčky zůstanou beze změny.
certificateReferences	CertificateReference[]	Seznam certifikátů, které se mají nainstalovat na každý výpočetní uzel ve fondu. Pokud je tento prvek k dispozici, nahradí všechny existující odkazy na certifikáty nakonfigurované ve fondu. Pokud je vynechán, všechny existující odkazy na certifikát zůstanou beze změny. U uzlů Windows služba Batch nainstaluje certifikáty do zadaného úložiště certifikátů a umístění. V případě linuxových výpočetních uzlů se certifikáty ukládají v adresáři v pracovním adresáři úlohy a do úlohy se zadává proměnná prostředí, AZ_BATCH_CERTIFICATES_DIR se má dotazovat na toto umístění. U certifikátů s viditelností remoteUser se v domovském adresáři uživatele vytvoří adresář certs (např. /home/{user-name}/certs) a certifikáty se umístí do tohoto adresáře. Upozornění: Tato vlastnost je zastaralá a po únoru 2024 se odebere. Místo toho použijte rozšíření Azure KeyVault .
metadata	MetadataItem[]	Seznam párů název-hodnota přidružených k fondu jako metadata. Pokud je tento prvek k dispozici, nahradí všechna existující metadata nakonfigurovaná ve fondu. Pokud zadáte prázdnou kolekci, odeberou se z fondu všechna metadata. Pokud je vynecháte, všechna existující metadata zůstanou beze změny.
startTask	StartTask	Úloha, která se má spustit na každém výpočetním uzlu při připojení k fondu. Úloha se spustí při přidání výpočetního uzlu do fondu nebo při restartování výpočetního uzlu. Pokud je tento prvek k dispozici, přepíše všechny existující StartTask. Pokud je vynechán, všechny existující startTask zůstanou beze změny.
targetNodeCommunicationMode	NodeCommunicationMode	Požadovaný režim komunikace uzlu pro fond. Pokud je tento prvek k dispozici, nahradí existující targetNodeCommunicationMode nakonfigurovaný ve fondu. Pokud je vynecháte, všechna existující metadata zůstanou beze změny.

Odpovědi

Name	Typ	Description
200 OK		Požadavek na službu Batch byl úspěšný. Headers client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	Chyba ze služby Batch.

Zabezpečení

azure_auth

Microsoft Entra tok kódu ověřování OAuth 2.0

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	Zosobnění uživatelského účtu

Authorization

Type: apiKey
In: header

Příklady

Patch the Pool

Sample Request

HTTP

PATCH account.region.batch.azure.com/pools/poolId?api-version=2023-11-01.18.0



{
  "startTask": {
    "commandLine": "/bin/bash -c 'echo start task'"
  }
}

Sample Response

Status code:

200

Definice

Name	Description
ApplicationPackageReference	Odkaz na balíček, který se má nasadit do výpočetních uzlů.
AutoUserScope	Obor automatického uživatele
AutoUserSpecification	Určuje parametry pro automatického uživatele, který spouští úlohu ve službě Batch.
BatchError	Ze služby Azure Batch byla přijata chybová odpověď.
BatchErrorDetail	Položka s dalšími informacemi, které jsou součástí Azure Batch odpovědi na chybu.
CertificateReference	Odkaz na certifikát, který se má nainstalovat do výpočetních uzlů ve fondu.
CertificateStoreLocation	Umístění úložiště certifikátů na výpočetním uzlu, do kterého se má certifikát nainstalovat.
CertificateVisibility	Které uživatelské účty na výpočetním uzlu by měly mít přístup k privátním datům certifikátu.
ComputeNodeIdentityReference	Odkaz na identitu přiřazenou uživatelem přidruženou k fondu služby Batch, který bude používat výpočetní uzel.
ContainerRegistry	Privátní registr kontejneru.
ContainerWorkingDirectory	Umístění pracovního adresáře úloh kontejneru.
ElevationLevel	Úroveň zvýšení oprávnění uživatele.
EnvironmentSetting	Proměnná prostředí, která se má nastavit v procesu úlohy.
ErrorMessage	Chybová zpráva přijatá v Azure Batch odpověď na chybu.
MetadataItem	Pár název-hodnota přidružený k prostředku služby Batch.
NodeCommunicationMode	Určuje, jak fond komunikuje se službou Batch.
PoolPatchParameter	Sada změn, které se mají provést ve fondu.
ResourceFile	Jeden soubor nebo více souborů ke stažení do výpočetního uzlu
StartTask	Úloha, která se spustí při připojení uzlu k fondu ve službě Azure Batch nebo při restartování nebo opětovném nastavení výpočetního uzlu.
TaskContainerSettings	Nastavení kontejneru pro úlohu.
UserIdentity	Definice identity uživatele, pod kterou je úloha 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. Při vytváření fondu musí být ID aplikace balíčku plně kvalifikované (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).
version	string	Verze aplikace, která se má nasadit. Pokud ji vynecháte, nasadí se výchozí verze. Pokud je tato možnost ve fondu vynechána a pro tuto aplikaci není zadána žádná výchozí verze, požadavek selže s kódem chyby InvalidApplicationPackageReferences a stavovým kódem HTTP 409. Pokud je tato možnost u úlohy vynechána a pro tuto aplikaci není zadána žádná výchozí verze, úloha selže s chybou předběžného zpracování.

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	ElevationLevel	Úroveň zvýšení oprávnění automatického uživatele. Výchozí hodnota je nonAdmin.
scope	AutoUserScope	Obor automatického uživatele Výchozí hodnota je fond. Pokud fond používá Systém Windows, měla by být zadána hodnota Úloha, pokud je vyžadována přísnější izolace mezi úkoly. Pokud například úloha zmutuje registr způsobem, který by mohl mít vliv na jiné úlohy, nebo pokud byly ve fondu zadány certifikáty, které by neměly být přístupné normálním úkolům, ale měly by být přístupné pomocí startTasks.

BatchError

Ze služby Azure Batch byla přijata chybová odpověď.

Name	Typ	Description
code	string	Identifikátor chyby. Kódy jsou invariantní a mají být využívány programově.
message	ErrorMessage	Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.
values	BatchErrorDetail[]	Kolekce párů klíč-hodnota obsahující další podrobnosti o chybě.

BatchErrorDetail

Položka s dalšími informacemi, které jsou součástí Azure Batch odpovědi na chybu.

Name	Typ	Description
key	string	Identifikátor určující význam vlastnosti Value.
value	string	Další informace zahrnuté v chybové odpovědi.

CertificateReference

Odkaz na certifikát, který se má nainstalovat do výpočetních uzlů ve fondu.

Name	Typ	Description
storeLocation	CertificateStoreLocation	Umístění úložiště certifikátů na výpočetním uzlu, do kterého se má certifikát nainstalovat. Výchozí hodnota je currentuser. Tato vlastnost se vztahuje pouze na fondy nakonfigurované s výpočetními uzly Windows (to znamená vytvořené pomocí cloudServiceConfiguration nebo virtualMachineConfiguration pomocí odkazu na image Windows). V případě linuxových výpočetních uzlů se certifikáty ukládají v adresáři v pracovním adresáři úlohy a do úlohy se zadává proměnná prostředí, AZ_BATCH_CERTIFICATES_DIR se má dotazovat na toto umístění. U certifikátů s viditelností remoteUser se v domovském adresáři uživatele vytvoří adresář certs (např. /home/{user-name}/certs) a certifikáty se umístí do tohoto adresáře.
storeName	string	Název úložiště certifikátů na výpočetním uzlu, do kterého se má certifikát nainstalovat. Tato vlastnost se vztahuje pouze na fondy nakonfigurované s výpočetními uzly Windows (to znamená vytvořené pomocí cloudServiceConfiguration nebo virtualMachineConfiguration pomocí odkazu na image Windows). Mezi běžné názvy obchodů patří: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ale můžete použít i jakýkoliv vlastní název obchodu. Výchozí hodnota je My.
thumbprint	string	Kryptografický otisk certifikátu.
thumbprintAlgorithm	string	Algoritmus, ke kterému je kryptografický otisk přidružený. To musí být sha1.
visibility	CertificateVisibility[]	Které uživatelské účty na výpočetním uzlu by měly mít přístup k privátním datům certifikátu. V této kolekci můžete zadat více než jednu viditelnost. Výchozí hodnota je všechny účty.

CertificateStoreLocation

Umístění úložiště certifikátů na výpočetním uzlu, do kterého se má certifikát nainstalovat.

Name	Typ	Description
currentuser	string	Certifikáty by se měly nainstalovat do úložiště certifikátů CurrentUser.
localmachine	string	Certifikáty by se měly nainstalovat do úložiště certifikátů LocalMachine.

CertificateVisibility

Které uživatelské účty na výpočetním uzlu by měly mít přístup k privátním datům certifikátu.

Name	Typ	Description
remoteuser	string	Certifikát by měl být viditelný pro uživatelské účty, pod kterými uživatelé vzdáleně přistupují k výpočetnímu uzlu.
starttask	string	Certifikát by měl být viditelný pro uživatelský účet, pod kterým se spouští StartTask. Všimněte si, že pokud je obor automatického uživatele fond pro startTask i úkol, bude tento certifikát viditelný i pro úkol.
task	string	Certifikát by měl být viditelný pro uživatelské účty, pod kterými se spouští úlohy.

ComputeNodeIdentityReference

Odkaz na identitu přiřazenou uživatelem přidruženou k fondu služby Batch, který bude používat výpočetní uzel.

Name	Typ	Description
resourceId	string	ID prostředku ARM identity přiřazené uživatelem.

ContainerRegistry

Privátní registr kontejneru.

Name	Typ	Description
identityReference	ComputeNodeIdentityReference	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. Odkaz na identitu přiřazenou uživatelem přidruženou k fondu služby Batch, který bude používat výpočetní uzel.
password	string	Heslo pro přihlášení k serveru registru.
registryServer	string	Adresa URL registru. Pokud je vynechán, výchozí hodnota je "docker.io".
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 kontejneru Image. Mějte na pozoru, že tento adresář nebude obsahovat soubory prostředků stažené službou Batch.
taskWorkingDirectory	string	Použijte standardní pracovní adresář úloh služby Batch, který bude obsahovat soubory zdrojů úkolů vyplněné službou Batch.

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á se má nastavit v procesu úlohy.

Name	Typ	Description
name	string	Název proměnné prostředí.
value	string	Hodnota proměnné prostředí.

ErrorMessage

Chybová zpráva přijatá v Azure Batch odpověď na chybu.

Name	Typ	Description
lang	string	Kód jazyka chybové zprávy
value	string	Text zprávy.

MetadataItem

Pár název-hodnota přidružený k prostředku služby Batch.

Name	Typ	Description
name	string	Název položky metadat.
value	string	Hodnota položky metadat.

NodeCommunicationMode

Určuje, jak fond komunikuje se službou Batch.

Name	Typ	Description
classic	string	Uzly používající klasický režim komunikace vyžadují příchozí komunikaci TCP na portech 29876 a 29877 z rutiny BatchNodeManagement. Značka služby {region} a odchozí komunikace TCP na portu 443 do "Storage.region" a "BatchNodeManagement. Značky služby {region}".
default	string	Režim komunikace uzlu je automaticky nastaven službou Batch.
simplified	string	Uzly používající zjednodušený režim komunikace vyžadují odchozí komunikaci TCP na portu 443 do BatchNodeManagement. Značka služby {region}" Nejsou vyžadovány žádné otevřené příchozí porty.

PoolPatchParameter

Sada změn, které se mají provést ve fondu.

Name	Typ	Description
applicationPackageReferences	ApplicationPackageReference[]	Seznam balíčků, které se mají nainstalovat na každý výpočetní uzel ve fondu. Změny odkazů na balíčky mají vliv na všechny nové uzly, které se připojují k fondu, ale nemají vliv na výpočetní uzly, které už jsou ve fondu, dokud se nerestartují nebo nereimagují. Pokud je tento prvek k dispozici, nahradí všechny existující odkazy na balíček. Pokud zadáte prázdnou kolekci, odeberou se z fondu všechny odkazy na balíčky. Pokud je vynechán, všechny existující odkazy na balíčky zůstanou beze změny.
certificateReferences	CertificateReference[]	Seznam certifikátů, které se mají nainstalovat na každý výpočetní uzel ve fondu. Pokud je tento prvek k dispozici, nahradí všechny existující odkazy na certifikáty nakonfigurované ve fondu. Pokud je vynechán, všechny existující odkazy na certifikát zůstanou beze změny. U uzlů Windows služba Batch nainstaluje certifikáty do zadaného úložiště certifikátů a umístění. V případě linuxových výpočetních uzlů se certifikáty ukládají v adresáři v pracovním adresáři úlohy a do úlohy se zadává proměnná prostředí, AZ_BATCH_CERTIFICATES_DIR se má dotazovat na toto umístění. U certifikátů s viditelností remoteUser se v domovském adresáři uživatele vytvoří adresář certs (např. /home/{user-name}/certs) a certifikáty se umístí do tohoto adresáře. Upozornění: Tato vlastnost je zastaralá a po únoru 2024 se odebere. Místo toho použijte rozšíření Azure KeyVault .
metadata	MetadataItem[]	Seznam párů název-hodnota přidružených k fondu jako metadata. Pokud je tento prvek k dispozici, nahradí všechna existující metadata nakonfigurovaná ve fondu. Pokud zadáte prázdnou kolekci, odeberou se z fondu všechna metadata. Pokud je vynecháte, všechna existující metadata zůstanou beze změny.
startTask	StartTask	Úloha, která se má spustit na každém výpočetním uzlu při připojení k fondu. Úloha se spustí při přidání výpočetního uzlu do fondu nebo při restartování výpočetního uzlu. Pokud je tento prvek k dispozici, přepíše všechny existující StartTask. Pokud je vynechán, všechny existující startTask zůstanou beze změny.
targetNodeCommunicationMode	NodeCommunicationMode	Požadovaný režim komunikace uzlu pro fond. Pokud je tento prvek k dispozici, nahradí existující targetNodeCommunicationMode nakonfigurovaný ve fondu. Pokud je vynecháte, všechna existující metadata zůstanou beze změny.

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ě. Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a jedna z nich musí být zadána.
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. Vlastnost je platná pouze při použití autoStorageContainerName nebo storageContainerUrl. Tato předpona může být částečný název souboru nebo podadresář. Pokud není předpona zadána, stáhnou se všechny soubory v kontejneru.
fileMode	string	Atribut režimu oprávnění k souboru v osmičkovém formátu. Tato vlastnost se vztahuje pouze na soubory stahované do výpočetních uzlů s Linuxem. Pokud je zadaný pro resourceFile, který se stáhne do výpočetního uzlu Windows, bude ignorován. Pokud tato vlastnost není pro výpočetní uzel s Linuxem zadaná, použije se pro soubor výchozí hodnota 0770.
filePath	string	Umístění na výpočetním uzlu, do kterého se mají stáhnout soubory, vzhledem k pracovnímu adresáři úlohy. Pokud je zadána vlastnost httpUrl, filePath je povinný a popisuje cestu, do které bude soubor stažen, včetně názvu souboru. Jinak pokud je zadána vlastnost autoStorageContainerName nebo storageContainerUrl, filePath je nepovinný a je adresář ke stažení souborů do. V případě použití filePath jako adresáře se veškerá adresářová struktura, která je již přidružená ke vstupním datům, zachovají v plném rozsahu a připojí se k zadanému adresáři filePath. Zadaná relativní cesta nemůže být oddělena od pracovního adresáře úlohy (například pomocí ..).
httpUrl	string	Adresa URL souboru, který chcete stáhnout. Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a jedna z nich musí být zadána. Pokud adresa URL odkazuje na Azure Blob Storage, musí být čitelná z výpočetních uzlů. Existují tři způsoby, jak získat takovou adresu URL pro objekt blob ve službě Azure Storage: patří sdílený přístupový podpis (SAS) udělující oprávnění ke čtení objektu blob, použití spravované identity s oprávněním ke čtení nebo nastavení seznamu ACL pro objekt blob nebo jeho kontejner tak, aby umožňoval veřejný přístup.
identityReference	ComputeNodeIdentityReference	Odkaz na identitu přiřazenou uživatelem, která se má použít pro přístup k Azure Blob Storage určené pomocí storageContainerUrl nebo httpUrl Odkaz na identitu přiřazenou uživatelem přidruženou k fondu služby Batch, který bude používat výpočetní uzel.
storageContainerUrl	string	Adresa URL kontejneru objektů blob v rámci Azure Blob Storage. Vlastnosti autoStorageContainerName, storageContainerUrl a httpUrl se vzájemně vylučují a jedna z nich musí být zadána. Tato adresa URL musí být čitelná a vypsatelná z výpočetních uzlů. Existují tři způsoby, jak takovou adresu URL pro kontejner ve službě Azure Storage získat: můžete zahrnout sdílený přístupový podpis (SAS) udělující oprávnění ke čtení a seznamu v kontejneru, použít spravovanou identitu s oprávněními ke čtení a seznamu seznamů nebo nastavit seznam ACL pro kontejner tak, aby umožňoval veřejný přístup.

StartTask

Úloha, která se spustí při připojení uzlu k fondu ve službě Azure Batch nebo při restartování nebo opětovném nastavení výpočetního uzlu.

Name	Typ	Description
commandLine	string	Příkazový řádek StartTask. Příkazový řádek se nespouští v prostředí, a proto nemůže využívat funkce prostředí, jako je rozšíření proměnné prostředí. Pokud chcete tyto funkce využít, měli byste vyvolat prostředí v příkazovém řádku, například pomocí příkazu "cmd /c MyCommand" ve Windows nebo "/bin/sh -c MyCommand" v Linuxu. Pokud příkazový řádek odkazuje na cesty k souborům, měl by použít relativní cestu (vzhledem k pracovnímu adresáři Úloh) nebo proměnnou prostředí poskytovanou službou Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).
containerSettings	TaskContainerSettings	Nastavení kontejneru, ve kterém běží StartTask. Když je tato možnost zadána, všechny adresáře rekurzivně pod AZ_BATCH_NODE_ROOT_DIR (kořen Azure Batch adresářů na uzlu) se mapují do kontejneru, všechny proměnné prostředí úloh se mapují do kontejneru a příkazový řádek úlohy se spustí v kontejneru. Soubory vytvořené v kontejneru mimo AZ_BATCH_NODE_ROOT_DIR se nemusí projevit na disku hostitele, což znamená, že rozhraní API služby Batch nebudou mít k těmto souborům přístup.
environmentSettings	EnvironmentSetting[]	Seznam nastavení proměnných prostředí pro StartTask.
maxTaskRetryCount	integer	Maximální počet opakování úkolu. Služba Batch opakuje úlohu, pokud její ukončovací kód není nenulový. Všimněte si, že tato hodnota konkrétně řídí počet opakování. Služba Batch tuto úlohu jednou vyzkouší a až do tohoto limitu se může zkusit znovu. Pokud je například maximální počet opakování 3, služba Batch zkusí úlohu až 4krát (jeden počáteční pokus a 3 opakování). Pokud je maximální počet opakování 0, služba Batch nezkusí úlohu zopakovat. Pokud je maximální počet opakování -1, služba Batch opakuje úlohu bez omezení, ale nedoporučuje se to pro spouštěcí úkol ani žádný úkol. Výchozí hodnota je 0 (bez opakování).
resourceFiles	ResourceFile[]	Seznam souborů, které služba Batch stáhne do výpočetního uzlu před spuštěním příkazového řádku. Seznam souborů prostředků má maximální velikost. Při překročení maximální velikosti požadavek selže a kód chyby odpovědi bude RequestEntityTooLarge. Pokud k tomu dojde, musí se zmenšit velikost kolekce ResourceFiles. Toho můžete dosáhnout pomocí souborů .zip, balíčků aplikací nebo kontejnerů Dockeru. Soubory uvedené v tomto prvku jsou umístěny v pracovním adresáři úlohy.
userIdentity	UserIdentity	Identita uživatele, pod kterou běží StartTask. Pokud je úloha vynechána, spustí se jako uživatel bez oprávnění správce, který je jedinečný pro danou úlohu.
waitForSuccess	boolean	Jestli má služba Batch čekat na úspěšné dokončení startTask (tj. na ukončení s ukončovacím kódem 0) před plánováním úkolů na výpočetním uzlu. Pokud je hodnota true a startTask selže na uzlu, služba Batch opakuje startTask až do maximálního počtu opakování (maxTaskRetryCount). Pokud se úloha ani po všech opakováních úspěšně nedokončila, služba Batch označí uzel jako nepoužitelný a nebude na něj plánovat úkoly. Tuto podmínku je možné zjistit prostřednictvím podrobností o stavu výpočetního uzlu a informací o selhání. Pokud je hodnota false, služba Batch nebude čekat na dokončení startTask. V tomto případě se na výpočetním uzlu mohou spustit jiné úlohy, zatímco startTask je stále spuštěný. a i když startTask selže, budou se nové úkoly dál plánovat na výpočetním uzlu. Výchozí hodnota je true.

TaskContainerSettings

Nastavení kontejneru pro úlohu.

Name	Typ	Description
containerRunOptions	string	Další možnosti příkazu container create Tyto další možnosti jsou kromě možností řízených službou Batch k dispozici jako argumenty příkazu docker create.
imageName	string	Image, která se má použít k vytvoření kontejneru, ve kterém bude úloha spuštěna. Toto je úplný odkaz na image, který by byl zadán pro "docker pull". Pokud jako součást názvu obrázku není uvedena žádná značka, použije se jako výchozí značka ":latest".
registry	ContainerRegistry	Privátní registr, který obsahuje image kontejneru. Toto nastavení je možné vynechat, pokud už jste ho zadali při vytváření fondu.
workingDirectory	ContainerWorkingDirectory	Umístění pracovního adresáře úloh kontejneru. Výchozí hodnota je taskWorkingDirectory.

UserIdentity

Definice identity uživatele, pod kterou je úloha spuštěna.

Name	Typ	Description
autoUser	AutoUserSpecification	Automatický uživatel, pod kterým je úloha spuštěna. Vlastnosti userName a autoUser se vzájemně vylučují; musíte zadat jeden, ale ne oba.
username	string	Název identity uživatele, pod kterou je úloha spuštěna. Vlastnosti userName a autoUser se vzájemně vylučují; musíte zadat jeden, ale ne oba.