Pool - Update Properties

Service:

Batch Service

API Version:

2023-11-01.18.0

Frissítések a megadott készlet tulajdonságait.
Ez teljes mértékben lecseréli a készlet összes frissíthető tulajdonságát. Ha például a készlethez egy StartTask van társítva, és a StartTask nincs megadva ezzel a kéréssel, akkor a Batch szolgáltatás eltávolítja a meglévő StartTaskot.

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

With optional parameters:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
batchUrl	path	True	string	Az összes Azure Batch szolgáltatáskérés alap URL-címe.
poolId	path	True	string	A frissíteni kívánt készlet azonosítója.
api-version	query	True	string	Ügyfél API-verziója.
timeout	query		integer int32	A kérés feldolgozásának maximális időtartama másodpercben. Az alapértelmezett érték 30 mp.

Kérelem fejléce

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

Name	Kötelező	Típus	Description
client-request-id		string uuid	A hívó által generált kérési identitás, olyan GUID formátumban, amely nem rendelkezik díszítéssel, például kapcsos zárójelekkel, például 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Azt határozza meg, hogy a kiszolgálónak vissza kell-e küldenie a válaszban szereplő client-request-id azonosítót.
ocp-date		string date-time-rfc1123	A kérelem kiállításának időpontja. Az ügyfélkódtárak ezt általában az aktuális rendszeróraidőre állítják be; állítsa be explicit módon, ha a REST API-t közvetlenül hívja meg.

Kérelem törzse

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

Name	Kötelező	Típus	Description
applicationPackageReferences	True	ApplicationPackageReference[]	A készlet egyes számítási csomópontjaira telepíteni kívánt alkalmazáscsomagok listája. A lista lecseréli a készleten lévő meglévő alkalmazáscsomag-hivatkozásokat. Az alkalmazáscsomag-hivatkozások módosítása hatással van a készlethez csatlakozó összes új számítási csomópontra, de a készletben lévő számítási csomópontokat csak újraindításuk vagy újragondolásuk után érinti. Egy adott készleten legfeljebb 10 alkalmazáscsomag-hivatkozás található. Ha nincs megadva, vagy üres gyűjteményt ad meg, a meglévő alkalmazáscsomag-hivatkozások törlődnek a készletből. Egy adott készleten legfeljebb 10 hivatkozás adható meg.
certificateReferences	True	CertificateReference[]	A készlet egyes számítási csomópontjaira telepíteni kívánt tanúsítványok listája. Ez a lista lecseréli a készleten konfigurált meglévő tanúsítványhivatkozásokat. Ha üres gyűjteményt ad meg, a meglévő tanúsítványhivatkozások törlődnek a készletből. Windows-csomópontok esetén a Batch szolgáltatás telepíti a tanúsítványokat a megadott tanúsítványtárolóba és helyre. Linux számítási csomópontok esetén a tanúsítványok a Feladat munkakönyvtárában található könyvtárban vannak tárolva, és a rendszer egy környezeti változót AZ_BATCH_CERTIFICATES_DIR a feladatnak, amely lekérdezi ezt a helyet. A "remoteUser" láthatóságú tanúsítványok esetében a rendszer létrehoz egy "tanúsítvány" könyvtárat a felhasználó kezdőkönyvtárában (pl. /home/{user-name}/certs), és a tanúsítványok ebben a könyvtárban vannak elhelyezve. Figyelmeztetés: Ez a tulajdonság elavult, és 2024 februárja után törlődik. Használja inkább az Azure KeyVault bővítményt .
metadata	True	MetadataItem[]	A készlethez metaadatként társított név-érték párok listája. Ez a lista lecseréli a készleten konfigurált meglévő metaadatokat. Ha nincs megadva, vagy üres gyűjteményt ad meg, a meglévő metaadatok el lesznek távolítva a készletből.
startTask		StartTask	A készlethez való csatlakozáskor az egyes számítási csomópontokon futtatandó feladat. A feladat akkor fut, amikor a számítási csomópont hozzá van adva a készlethez, vagy amikor a számítási csomópont újraindul. Ha ez az elem jelen van, felülírja a meglévő StartTaskot. Ha nincs megadva, a rendszer eltávolítja a meglévő StartTaskot a készletből.
targetNodeCommunicationMode		NodeCommunicationMode	A készlet kívánt csomópontkommunikációs módja. Ez a beállítás lecseréli a készleten meglévő targetNodeCommunication beállítást. Ha nincs megadva, a meglévő beállítás alapértelmezett.

Válaszok

Name	Típus	Description
204 No Content		A Batch szolgáltatásnak küldött kérés sikeres volt. Headers client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	A Batch szolgáltatás hibája.

Biztonság

azure_auth

Microsoft Entra OAuth 2.0 hitelesítési kódfolyamata

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

Scopes

Name	Description
user_impersonation	A felhasználói fiók megszemélyesítése

Authorization

Type: apiKey
In: header

Példák

Pool update

Sample Request

HTTP

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



{
  "startTask": {
    "commandLine": "/bin/bash -c 'echo start task'"
  },
  "certificateReferences": [],
  "applicationPackageReferences": [],
  "metadata": []
}

Sample Response

Status code:

204

Definíciók

Name	Description
ApplicationPackageReference	A számítási csomópontokon üzembe helyezendő csomagra mutató hivatkozás.
AutoUserScope	Az automatikus felhasználó hatóköre
AutoUserSpecification	A Batch szolgáltatásban feladatot futtató automatikus felhasználó paramétereit adja meg.
BatchError	Hibaválasz érkezett a Azure Batch szolgáltatástól.
BatchErrorDetail	A Azure Batch hibaválaszban szereplő további információk egy eleme.
CertificateReference	Hivatkozás egy készlet számítási csomópontjaira telepíteni kívánt tanúsítványra.
CertificateStoreLocation	A tanúsítványtároló helye a számítási csomóponton, ahová a tanúsítványt telepíteni szeretné.
CertificateVisibility	A számítási csomóponton található felhasználói fiókoknak hozzáféréssel kell rendelkezniük a tanúsítvány személyes adataihoz.
ComputeNodeIdentityReference	A számítási csomópont által használt Batch-készlethez társított felhasználó által hozzárendelt identitásra mutató hivatkozás.
ContainerRegistry	Egy privát tárolóregisztrációs adatbázis.
ContainerWorkingDirectory	A tároló Feladat munkakönyvtárának helye.
ElevationLevel	A felhasználó szintemelési szintje.
EnvironmentSetting	Egy tevékenységfolyamathoz beállítandó környezeti változó.
ErrorMessage	Hibaüzenet érkezett egy Azure Batch hibaválaszban.
MetadataItem	Egy Batch-szolgáltatáserőforráshoz társított név-érték pár.
NodeCommunicationMode	Meghatározza, hogy a készlet hogyan kommunikál a Batch szolgáltatással.
PoolUpdatePropertiesParameter	A készleten végrehajtott módosítások halmaza.
ResourceFile	Egy vagy több fájl, amely egy számítási csomópontra tölthető le.
StartTask	Olyan feladat, amely akkor fut, amikor egy csomópont csatlakozik egy készlethez a Azure Batch szolgáltatásban, vagy amikor a számítási csomópont újraindul vagy újra létre lesz hozva.
TaskContainerSettings	A feladat tárolóbeállításai.
UserIdentity	Annak a felhasználói identitásnak a definíciója, amely alatt a feladat fut.

ApplicationPackageReference

A számítási csomópontokon üzembe helyezendő csomagra mutató hivatkozás.

Name	Típus	Description
applicationId	string	Az üzembe helyezni kívánt alkalmazás azonosítója. Készlet létrehozásakor a csomag alkalmazásazonosítójának teljes mértékben minősítettnek kell lennie (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).
version	string	Az üzembe helyezendő alkalmazás verziója. Ha nincs megadva, az alapértelmezett verzió lesz üzembe helyezve. Ha ez nincs megadva egy készletben, és nincs megadva alapértelmezett verzió ehhez az alkalmazáshoz, a kérés invalidApplicationPackageReferences hibakóddal és 409-es HTTP-állapotkóddal meghiúsul. Ha ez nincs megadva egy tevékenységen, és nincs megadva alapértelmezett verzió ehhez az alkalmazáshoz, a feladat egy előfeldolgozási hibával meghiúsul.

AutoUserScope

Az automatikus felhasználó hatóköre

Name	Típus	Description
pool	string	Megadja, hogy a feladat a készlet minden számítási csomópontján létrehozott közös automatikus felhasználói fiókként fusson.
task	string	Megadja, hogy a szolgáltatásnak létre kell hoznia egy új felhasználót a feladathoz.

AutoUserSpecification

A Batch szolgáltatásban feladatot futtató automatikus felhasználó paramétereit adja meg.

Name	Típus	Description
elevationLevel	ElevationLevel	Az automatikus felhasználó jogosultságszintje. Az alapértelmezett érték a nonAdmin.
scope	AutoUserScope	Az automatikus felhasználó hatóköre Az alapértelmezett érték a készlet. Ha a készlet Windows rendszert futtat, a Tevékenység értéket kell megadni, ha szigorúbb elkülönítésre van szükség a tevékenységek között. Ha például a feladat úgy mutálja a beállításjegyzéket, hogy az hatással lehet más tevékenységekre, vagy olyan tanúsítványokat adott meg a készletben, amelyeknek nem lehetnek elérhetők a normál tevékenységek, de a StartTasksnak elérhetővé kell tenniük.

BatchError

Hibaválasz érkezett a Azure Batch szolgáltatástól.

Name	Típus	Description
code	string	A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.
message	ErrorMessage	A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.
values	BatchErrorDetail[]	Kulcs-érték párok gyűjteménye, amely további részleteket tartalmaz a hibáról.

BatchErrorDetail

A Azure Batch hibaválaszban szereplő további információk egy eleme.

Name	Típus	Description
key	string	Az Érték tulajdonság jelentését meghatározó azonosító.
value	string	A hibaválaszban szereplő további információk.

CertificateReference

Hivatkozás egy készlet számítási csomópontjaira telepíteni kívánt tanúsítványra.

Name	Típus	Description
storeLocation	CertificateStoreLocation	A tanúsítványtároló helye a számítási csomóponton, ahová a tanúsítványt telepíteni szeretné. Az alapértelmezett érték a currentuser. Ez a tulajdonság csak a Windows számítási csomópontokkal konfigurált készletekre vonatkozik (azaz a cloudServiceConfiguration használatával vagy a virtualMachineConfiguration használatával, Windows rendszerkép-referencia használatával). Linux számítási csomópontok esetén a tanúsítványok a Tevékenység munkakönyvtárban található könyvtárban vannak tárolva, és a rendszer egy környezeti változót AZ_BATCH_CERTIFICATES_DIR a feladatnak, amely lekérdezi ezt a helyet. A "remoteUser" láthatóságú tanúsítványok esetében a rendszer létrehoz egy tanúsítványkönyvtárat a felhasználó kezdőkönyvtárában (például /home/{user-name}/certs), és a tanúsítványok ebben a könyvtárban vannak elhelyezve.
storeName	string	Annak a számítási csomópontnak a tanúsítványtárolója, amelybe telepíteni szeretné a tanúsítványt. Ez a tulajdonság csak a Windows számítási csomópontokkal konfigurált készletekre vonatkozik (azaz a cloudServiceConfiguration használatával vagy a virtualMachineConfiguration használatával, Windows rendszerkép-referencia használatával). Az áruházak gyakori nevei a következők: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, de bármilyen egyéni tárolónév is használható. Az alapértelmezett érték a Saját.
thumbprint	string	A tanúsítvány ujjlenyomata.
thumbprintAlgorithm	string	Az algoritmus, amelyhez az ujjlenyomat társítva van. Ennek sha1-nek kell lennie.
visibility	CertificateVisibility[]	A számítási csomóponton található felhasználói fiókoknak hozzáféréssel kell rendelkezniük a tanúsítvány személyes adataihoz. Ebben a gyűjteményben több láthatóságot is megadhat. Az alapértelmezett érték az összes fiók.

CertificateStoreLocation

A tanúsítványtároló helye a számítási csomóponton, ahová a tanúsítványt telepíteni szeretné.

Name	Típus	Description
currentuser	string	A tanúsítványokat a CurrentUser tanúsítványtárolóba kell telepíteni.
localmachine	string	A tanúsítványokat a LocalMachine tanúsítványtárolóba kell telepíteni.

CertificateVisibility

A számítási csomóponton található felhasználói fiókoknak hozzáféréssel kell rendelkezniük a tanúsítvány személyes adataihoz.

Name	Típus	Description
remoteuser	string	A tanúsítványnak láthatónak kell lennie azon felhasználói fiókok számára, amelyek alatt a felhasználók távolról hozzáférnek a számítási csomóponthoz.
starttask	string	A tanúsítványnak láthatónak kell lennie annak a felhasználói fióknak, amely alatt a StartTask fut. Vegye figyelembe, hogy ha az Automatikusfelhasználó hatóköre a StartTask és a Tevékenység készlete, akkor ez a tanúsítvány a tevékenység számára is látható lesz.
task	string	A tanúsítványnak láthatónak kell lennie azokhoz a felhasználói fiókokhoz, amelyeken a feladatfeladatok futnak.

ComputeNodeIdentityReference

A számítási csomópont által használt Batch-készlethez társított felhasználó által hozzárendelt identitásra mutató hivatkozás.

Name	Típus	Description
resourceId	string	A felhasználó által hozzárendelt identitás ARM-erőforrás-azonosítója.

ContainerRegistry

Egy privát tárolóregisztrációs adatbázis.

Name	Típus	Description
identityReference	ComputeNodeIdentityReference	A felhasználó által hozzárendelt identitásra mutató hivatkozás, a felhasználónév és a jelszó helyett egy Azure Container Registry eléréséhez. A számítási csomópont által használt Batch-készlethez társított felhasználó által hozzárendelt identitásra mutató hivatkozás.
password	string	A beállításjegyzék-kiszolgálóra való bejelentkezéshez megadott jelszó.
registryServer	string	A beállításjegyzék URL-címe. Ha nincs megadva, az alapértelmezett érték a "docker.io".
username	string	A beállításjegyzék-kiszolgálóra való bejelentkezéshez megadott felhasználónév.

ContainerWorkingDirectory

A tároló Feladat munkakönyvtárának helye.

Name	Típus	Description
containerImageDefault	string	Használja a tároló lemezképében definiált munkakönyvtárat. Ne feledje, hogy ez a könyvtár nem tartalmazza a Batch által letöltött erőforrásfájlokat.
taskWorkingDirectory	string	Használja a Batch szolgáltatás szokásos tevékenység munkakönyvtárát, amely tartalmazza a Batch által kitöltött tevékenységerőforrás-fájlokat.

ElevationLevel

A felhasználó szintemelési szintje.

Name	Típus	Description
admin	string	A felhasználó emelt szintű hozzáféréssel rendelkező felhasználó, és teljes rendszergazdai engedélyekkel rendelkezik.
nonadmin	string	A felhasználó egy emelt szintű hozzáféréssel nem rendelkező standard felhasználó.

EnvironmentSetting

Egy tevékenységfolyamathoz beállítandó környezeti változó.

Name	Típus	Description
name	string	A környezeti változó neve.
value	string	A környezeti változó értéke.

ErrorMessage

Hibaüzenet érkezett egy Azure Batch hibaválaszban.

Name	Típus	Description
lang	string	A hibaüzenet nyelvkódja
value	string	Az üzenet szövege.

MetadataItem

Egy Batch-szolgáltatáserőforráshoz társított név-érték pár.

Name	Típus	Description
name	string	A metaadatelem neve.
value	string	A metaadatelem értéke.

NodeCommunicationMode

Meghatározza, hogy a készlet hogyan kommunikál a Batch szolgáltatással.

Name	Típus	Description
classic	string	A klasszikus kommunikációs módot használó csomópontok bejövő TCP-kommunikációt igényelnek a "BatchNodeManagement" 29876-os és 29877-es porton. {region}" szolgáltatáscímke és kimenő TCP-kommunikáció a 443-as porton a "Storage.region" és a "BatchNodeManagement" felé. {region}" szolgáltatáscímkék.
default	string	A csomópont kommunikációs módját a Batch szolgáltatás automatikusan beállítja.
simplified	string	Az egyszerűsített kommunikációs módot használó csomópontok kimenő TCP-kommunikációt igényelnek a 443-es porton a "BatchNodeManagement" felé. {region}" szolgáltatáscímke. Nincs szükség nyitott bejövő portra.

PoolUpdatePropertiesParameter

A készleten végrehajtott módosítások halmaza.

Name	Típus	Description
applicationPackageReferences	ApplicationPackageReference[]	A készlet egyes számítási csomópontjaira telepíteni kívánt alkalmazáscsomagok listája. A lista lecseréli a készleten meglévő alkalmazáscsomag-hivatkozásokat. Az alkalmazáscsomag-hivatkozások módosítása hatással van a készlethez csatlakozó összes új számítási csomópontra, de nem érinti a készletben lévő számítási csomópontokat, amíg újra nem indítják vagy újra nem alakítják őket. Egy adott készleten legfeljebb 10 alkalmazáscsomag-hivatkozás található. Ha nincs megadva, vagy üres gyűjteményt ad meg, a meglévő alkalmazáscsomag-hivatkozások törlődnek a készletből. Egy adott készletben legfeljebb 10 hivatkozás adható meg.
certificateReferences	CertificateReference[]	A készlet egyes számítási csomópontjaira telepíteni kívánt tanúsítványok listája. Ez a lista lecseréli a készleten konfigurált meglévő tanúsítványhivatkozásokat. Ha üres gyűjteményt ad meg, a meglévő tanúsítványhivatkozások törlődnek a készletből. Windows-csomópontok esetén a Batch szolgáltatás telepíti a tanúsítványokat a megadott tanúsítványtárolóba és helyre. Linux számítási csomópontok esetén a tanúsítványok a Tevékenység munkakönyvtárban található könyvtárban vannak tárolva, és a rendszer egy környezeti változót AZ_BATCH_CERTIFICATES_DIR a feladatnak, amely lekérdezi ezt a helyet. A "remoteUser" láthatóságú tanúsítványok esetében a rendszer létrehoz egy tanúsítványkönyvtárat a felhasználó kezdőkönyvtárában (például /home/{user-name}/certs), és a tanúsítványok ebben a könyvtárban vannak elhelyezve. Figyelmeztetés: Ez a tulajdonság elavult, és 2024 februárja után el lesz távolítva. Használja helyette az Azure KeyVault bővítményt .
metadata	MetadataItem[]	A készlethez metaadatként társított név-érték párok listája. Ez a lista lecseréli a készleten konfigurált meglévő metaadatokat. Ha nincs megadva, vagy üres gyűjteményt ad meg, a meglévő metaadatok el lesznek távolítva a készletből.
startTask	StartTask	Az egyes számítási csomópontokon a készlethez való csatlakozáskor futtatandó feladat. A feladat akkor fut, amikor a számítási csomópontot hozzáadják a készlethez, vagy amikor a számítási csomópont újraindul. Ha ez az elem jelen van, felülírja a meglévő StartTask-elemeket. Ha nincs megadva, a rendszer eltávolítja a meglévő StartTask elemeket a készletből.
targetNodeCommunicationMode	NodeCommunicationMode	A készlet kívánt csomópontkommunikációs módja. Ez a beállítás lecseréli a készleten meglévő targetNodeCommunication beállítást. Ha nincs megadva, a meglévő beállítás alapértelmezett.

ResourceFile

Egy vagy több fájl, amely egy számítási csomópontra tölthető le.

Name	Típus	Description
autoStorageContainerName	string	A tároló neve az automatikus tárfiókban. Az autoStorageContainerName, storageContainerUrl és httpUrl tulajdonságok kölcsönösen kizárják egymást, és az egyiket meg kell adni.
blobPrefix	string	A blobok Azure Storage-tárolóból való letöltésekor használandó blobelőtag. Csak azok a blobok töltődnek le, amelyeknek a neve a megadott előtaggal kezdődik. A tulajdonság csak az autoStorageContainerName vagy storageContainerUrl használatakor érvényes. Ez az előtag lehet részleges fájlnév vagy alkönyvtár. Ha nincs megadva előtag, a rendszer letölti a tárolóban lévő összes fájlt.
fileMode	string	A fájlengedélyezési mód attribútuma oktális formátumban. Ez a tulajdonság csak a Linux számítási csomópontokra letöltött fájlokra vonatkozik. A rendszer figyelmen kívül hagyja, ha egy erőforráshoz van megadvaFile, amelyet a rendszer letölt egy Windows számítási csomópontra. Ha ez a tulajdonság nincs megadva linuxos számítási csomóponthoz, akkor a rendszer egy alapértelmezett 0770-es értéket alkalmaz a fájlra.
filePath	string	A számítási csomópont azon helye, amelyre a fájlt le szeretné tölteni a tevékenység munkakönyvtárához képest. Ha a httpUrl tulajdonság meg van adva, a filePath megadása kötelező, és ismerteti a fájl letöltési útvonalát, beleértve a fájlnevet is. Ellenkező esetben, ha az autoStorageContainerName vagy storageContainerUrl tulajdonság meg van adva, a filePath megadása nem kötelező, és az a könyvtár, amelyre a fájlokat le szeretné tölteni. Abban az esetben, ha a filePath könyvtárként van használatban, a bemeneti adatokhoz már társított könyvtárstruktúrák teljes mértékben megmaradnak, és hozzá lesznek fűzve a megadott filePath-könyvtárhoz. A megadott relatív elérési út nem bontható ki a tevékenység munkakönyvtárából (például a ".." használatával).
httpUrl	string	A letölteni kívánt fájl URL-címe. Az autoStorageContainerName, storageContainerUrl és httpUrl tulajdonságok kölcsönösen kizárják egymást, és az egyiket meg kell adni. Ha az URL-cím Azure Blob Storage mutat, akkor a számítási csomópontokról olvashatónak kell lennie. Az Azure Storage-beli blobok URL-címének lekérése három módon lehetséges: tartalmazzon egy közös hozzáférésű jogosultságkódot (SAS), amely olvasási engedélyeket ad a blobhoz, használjon egy olvasási engedéllyel rendelkező felügyelt identitást, vagy állítsa be a blob vagy a tároló ACL-jét a nyilvános hozzáférés engedélyezésére.
identityReference	ComputeNodeIdentityReference	A storageContainerUrl vagy a httpUrl által megadott Azure Blob Storage eléréséhez használni kívánt felhasználó által hozzárendelt identitásra mutató hivatkozás A számítási csomópont által használt Batch-készlethez társított felhasználó által hozzárendelt identitásra mutató hivatkozás.
storageContainerUrl	string	A blobtároló URL-címe a Azure Blob Storage belül. Az autoStorageContainerName, storageContainerUrl és httpUrl tulajdonságok kölcsönösen kizárják egymást, és az egyiket meg kell adni. Ennek az URL-címnek olvashatónak és listázhatónak kell lennie a számítási csomópontokról. Az Ilyen URL-címeket háromféleképpen lehet lekérni az Azure Storage-tárolókhoz: tartalmazzon egy közös hozzáférésű jogosultságkódot (SAS), amely olvasási és listázási engedélyeket ad a tárolóhoz, használjon egy felügyelt identitást olvasási és listaengedélyekkel, vagy állítsa be a tároló ACL-ét a nyilvános hozzáférés engedélyezéséhez.

StartTask

Olyan feladat, amely akkor fut, amikor egy csomópont csatlakozik egy készlethez a Azure Batch szolgáltatásban, vagy amikor a számítási csomópont újraindul vagy újra létre lesz hozva.

Name	Típus	Description
commandLine	string	A StartTask parancssora. A parancssor nem rendszerhéj alatt fut, ezért nem tudja kihasználni a rendszerhéj olyan funkcióit, mint a környezeti változók bővítése. Ha ki szeretné használni az ilyen funkciókat, hívja meg a rendszerhéjat a parancssorban, például a windowsos "cmd /c MyCommand" vagy a "/bin/sh -c MyCommand" parancsmagot Linuxon. Ha a parancssor fájlelérési utakra hivatkozik, relatív elérési utat kell használnia (a Tevékenység munkakönyvtárhoz viszonyítva), vagy a Batch által megadott környezeti változót (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).
containerSettings	TaskContainerSettings	Annak a tárolónak a beállításai, amelyek alatt a StartTask fut. Ha ez a beállítás meg van adva, a AZ_BATCH_NODE_ROOT_DIR alatti összes címtár (a csomóponton Azure Batch könyvtárak gyökere) a tárolóba lesz leképezve, az összes tevékenységkörnyezeti változó a tárolóba lesz leképezve, a Feladat parancssor pedig a tárolóban lesz végrehajtva. Előfordulhat, hogy a tárolóban a AZ_BATCH_NODE_ROOT_DIR kívül létrehozott fájlok nem jelennek meg a gazdalemezen, ami azt jelenti, hogy a Batch-fájl API-k nem fogják tudni elérni ezeket a fájlokat.
environmentSettings	EnvironmentSetting[]	A StartTask környezeti változóbeállításainak listája.
maxTaskRetryCount	integer	A tevékenység újrapróbálkozásának maximális száma. A Batch szolgáltatás újrapróbál egy feladatot, ha a kilépési kódja nem nulla. Vegye figyelembe, hogy ez az érték kifejezetten az újrapróbálkozások számát szabályozza. A Batch szolgáltatás egyszer próbálja meg a feladatot, majd megpróbálkozhat ezzel a korláttal. Ha például a maximális újrapróbálkozások száma 3, a Batch legfeljebb 4 alkalommal próbálja meg a feladatot (egy kezdeti próbálkozás és 3 újrapróbálkozás). Ha az újrapróbálkozás maximális száma 0, a Batch szolgáltatás nem próbálkozik újra a feladattal. Ha a maximális újrapróbálkozások száma -1, a Batch szolgáltatás korlátozás nélkül újrapróbálkozott a tevékenységtel, de ez nem ajánlott indítási tevékenységhez vagy tevékenységhez. Az alapértelmezett érték a 0 (nincs újrapróbálkozás).
resourceFiles	ResourceFile[]	Azon fájlok listája, amelyeket a Batch szolgáltatás letölt a számítási csomópontra a parancssor futtatása előtt. Az erőforrásfájlok listájának maximális mérete van. Ha túllépi a maximális méretet, a kérés sikertelen lesz, és a válasz hibakódja RequestEntityTooLarge lesz. Ha ez történik, a ResourceFiles gyűjteményét méretben kell csökkenteni. Ez .zip fájlok, alkalmazáscsomagok vagy Docker-tárolók használatával érhető el. Az elem alatt felsorolt fájlok a tevékenység munkakönyvtárában találhatók.
userIdentity	UserIdentity	Az a felhasználói identitás, amely alatt a StartTask fut. Ha nincs megadva, a tevékenység a tevékenységre egyedi, nem rendszergazdai felhasználóként fut.
waitForSuccess	boolean	Meg kell-e várnia a Batch szolgáltatásnak, hogy a StartTask sikeresen befejeződjön (azaz a 0-s kilépési kóddal lépjen ki) a számítási csomóponton lévő tevékenységek ütemezése előtt. Ha igaz, és a StartTask meghiúsul egy csomóponton, a Batch szolgáltatás újrapróbálkozásokat kezdeményez a StartTask maximális újrapróbálkozások számával (maxTaskRetryCount). Ha a tevékenység az összes újrapróbálkozás után sem fejeződött be sikeresen, akkor a Batch szolgáltatás használhatatlanként jelöli meg a csomópontot, és nem ütemezi hozzá a Tevékenységeket. Ez a feltétel a számítási csomópont állapotán és a hibainformációkon keresztül észlelhető. Ha hamis, a Batch szolgáltatás nem várja meg, amíg a StartTask befejeződik. Ebben az esetben más feladatok is megkezdhetik a végrehajtást a számítási csomóponton, amíg a StartTask még fut; és akkor is, ha a StartTask meghiúsul, az új tevékenységek továbbra is ütemezve lesznek a számítási csomóponton. Az alapértelmezett érték igaz.

TaskContainerSettings

A feladat tárolóbeállításai.

Name	Típus	Description
containerRunOptions	string	További lehetőségek a tároló létrehozása parancshoz. Ezek a további lehetőségek a "docker create" parancs argumentumaiként vannak megadva a Batch szolgáltatás által szabályozottak mellett.
imageName	string	A tároló létrehozásához használni kívánt rendszerkép, amelyben a feladat futni fog. Ez a teljes rendszerkép-hivatkozás, ahogyan a "docker pull" esetében meg van adva. Ha a Rendszerkép neve nem tartalmaz címkét, a rendszer alapértelmezés szerint a "latest" címkét használja.
registry	ContainerRegistry	A rendszerkép tárolót tartalmazó privát beállításjegyzék. Ez a beállítás kihagyható, ha már meg lett adva a készlet létrehozásakor.
workingDirectory	ContainerWorkingDirectory	A tároló Feladat munkakönyvtárának helye. Az alapértelmezett érték a "taskWorkingDirectory".

UserIdentity

Annak a felhasználói identitásnak a definíciója, amely alatt a feladat fut.

Name	Típus	Description
autoUser	AutoUserSpecification	Az automatikus felhasználó, amely alatt a feladat fut. A userName és az autoUser tulajdonságok kölcsönösen kizárják egymást; meg kell adnia egyet, de nem mindkettőt.
username	string	Annak a felhasználói identitásnak a neve, amely alatt a feladat fut. A userName és az autoUser tulajdonságok kölcsönösen kizárják egymást; meg kell adnia egyet, de nem mindkettőt.