Task - Add

Service:

Batch Service

API Version:

2023-11-01.18.0

Hozzáad egy tevékenységet a megadott feladathoz.
A tevékenységek maximális élettartama a befejezéstől számítva 180 nap. Ha egy tevékenység a hozzáadást követő 180 napon belül nem fejeződik be, a Batch szolgáltatás leállítja, és bármilyen állapotban marad abban az időben.

POST {batchUrl}/jobs/{jobId}/tasks?api-version=2023-11-01.18.0

With optional parameters:

POST {batchUrl}/jobs/{jobId}/tasks?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.
jobId	path	True	string	Annak a feladatnak az azonosítója, amelyhez a tevékenységet hozzá szeretné adni.
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
commandLine	True	string	A Feladat parancssora. Többpéldányos feladatok esetén a parancssor elsődleges feladatként lesz végrehajtva, miután az elsődleges tevékenység és az összes altevékenység befejezte a koordinációs parancssor végrehajtását. 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).
id	True	string	Egy sztring, amely egyedileg azonosítja a feladatot a feladaton belül. Az azonosító tartalmazhat alfanumerikus karakterek bármilyen kombinációját, beleértve a kötőjeleket és az aláhúzásjeleket, és legfeljebb 64 karaktert tartalmazhat. Az azonosító kis- és nagybetűket nem különböztet meg (vagyis előfordulhat, hogy nem rendelkezik két azonosítóval egy feladaton belül, amelyek csak esetenként különböznek).
affinityInfo		AffinityInformation	A Batch szolgáltatás által egy olyan számítási csomópont kiválasztására használható helymutató, amelyen az új feladatot el szeretné indítani.
applicationPackageReferences		ApplicationPackageReference[]	Azon csomagok listája, amelyeket a Batch szolgáltatás üzembe helyez a számítási csomóponton a parancssor futtatása előtt. Az alkalmazáscsomagokat a rendszer egy megosztott könyvtárba tölti le és helyezi üzembe, nem pedig a Feladat munkakönyvtárba. Ezért ha egy hivatkozott csomag már megtalálható a Csomóponton, és naprakész, akkor nem tölti le újra; A rendszer a számítási csomópont meglévő példányát használja. Ha egy hivatkozott csomag nem telepíthető, például a csomag törlése vagy a letöltés sikertelensége miatt, a feladat meghiúsul.
authenticationTokenSettings		AuthenticationTokenSettings	A hitelesítési jogkivonat beállításai, amelyekkel a feladat Batch-szolgáltatásműveleteket hajthat végre. Ha ez a tulajdonság be van állítva, a Batch szolgáltatás egy hitelesítési jogkivonatot biztosít a feladatnak, amely a Batch szolgáltatás műveleteinek hitelesítésére használható fiókhozzáférési kulcs megkövetelése nélkül. A jogkivonatot a AZ_BATCH_AUTHENTICATION_TOKEN környezeti változó biztosítja. A beállításoktól függ, hogy a tevékenység milyen műveleteket hajthat végre a jogkivonat használatával. Egy tevékenység például feladatengedélyeket kérhet, hogy más tevékenységeket vegyen fel a feladatba, vagy ellenőrizze a feladat vagy a feladat alatti egyéb tevékenységek állapotát.
constraints		TaskConstraints	A tevékenységre vonatkozó végrehajtási korlátozások. Ha nem ad meg korlátozásokat, a maxTaskRetryCount a feladathoz megadott maxTaskRetryCount, a maxWallClockTime végtelen, a retentionTime pedig 7 nap.
containerSettings		TaskContainerSettings	Annak a tárolónak a beállításai, amelyek alatt a feladat fut. Ha a feladatot futtató készlet tárolókonfigurálási készlettel rendelkezik, ezt is be kell állítani. Ha a feladatot futtató készlet nem rendelkezik tárolókOnfigurálás beállításával, ezt nem szabad beállítani. 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.
dependsOn		TaskDependencies	Azok a tevékenységek, amelyektől ez a tevékenység függ. Ez a tevékenység csak akkor lesz ütemezve, ha az összes olyan tevékenység sikeresen befejeződött, amelytől függ. Ha bármelyik tevékenység sikertelen, és kimeríti az újrapróbálkozások számát, ez a tevékenység soha nem lesz ütemezve. Ha a feladat nem rendelkezik true (igaz) értékre állított UsesTaskDependencies értékekkel, és ez az elem jelen van, a kérés a TaskDependenciesNotSpecifiedOnJob hibakóddal hiúsul meg.
displayName		string	A feladat megjelenítendő neve. A megjelenítendő névnek nem kell egyedinek lennie, és legfeljebb 1024 karakter hosszúságú Unicode-karaktereket tartalmazhat.
environmentSettings		EnvironmentSetting[]	A tevékenység környezeti változóbeállításainak listája.
exitConditions		ExitConditions	Meghatározza, hogy a Batch szolgáltatás hogyan válaszoljon a feladat befejezésekor. Hogyan reagáljon a Batch szolgáltatás a feladat befejezésekor?
multiInstanceSettings		MultiInstanceSettings	Egy objektum, amely azt jelzi, hogy a tevékenység többpéldányos feladat, és információt tartalmaz a többpéldányos feladat futtatásáról. A többpéldányos feladatokat általában az MPI-feladatok támogatására használják. Az MPI esetében, ha az altevékenységek bármelyike meghiúsul (például egy nem nulla kilépési kóddal való kilépés miatt), a teljes többpéldányos feladat meghiúsul. A többpéldányos feladat ezután leáll, és újrapróbálkozott, egészen az újrapróbálkozás korlátig.
outputFiles		OutputFile[]	Azon fájlok listája, amelyeket a Batch szolgáltatás feltölt a számítási csomópontról a parancssor futtatása után. Többpéldányos feladatok esetén a fájlok csak abból a számítási csomópontból lesznek feltöltve, amelyen az elsődleges tevékenység végrehajtása történik.
requiredSlots		integer	Az ütemezési pontok száma, amelyeket a feladatnak futtatnia kell. Az alapértelmezett érték 1. Egy tevékenység csak akkor ütemezhető úgy, hogy egy számítási csomóponton fusson, ha a csomópont elegendő szabad ütemezési hellyel rendelkezik. Többpéldányos feladatok esetén ennek 1-nek kell lennie.
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. Többpéldányos feladatok esetén az erőforrásfájlok csak arra a számítási csomópontra lesznek letöltve, amelyen az elsődleges tevékenység végrehajtása történik. 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.
userIdentity		UserIdentity	A felhasználói identitás, amely alatt a feladat fut. Ha nincs megadva, a tevékenység a tevékenységre egyedi, nem rendszergazdai felhasználóként fut.

Válaszok

Name	Típus	Description
201 Created		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

Add a basic task

Add a task with container settings

Add a task with exit conditions

Add a task with extra slot requirement

Add a basic task

Sample Request

HTTP

POST account.region.batch.azure.com/jobs/jobId/tasks?api-version=2023-11-01.18.0



{
  "id": "task1",
  "commandLine": "cmd /c echo task1"
}

Sample Response

Status code:

201

Add a task with container settings

Sample Request

HTTP

POST account.region.batch.azure.com/jobs/jobId/tasks?api-version=2023-11-01.18.0



{
  "id": "taskId",
  "commandLine": "bash -c 'echo hello'",
  "containerSettings": {
    "imageName": "ubuntu",
    "containerRunOptions": "--rm"
  },
  "userIdentity": {
    "autoUser": {
      "scope": "task",
      "elevationLevel": "nonadmin"
    }
  }
}

Sample Response

Status code:

201

Add a task with exit conditions

Sample Request

HTTP

POST account.region.batch.azure.com/jobs/jobId/tasks?api-version=2023-11-01.18.0



{
  "id": "taskId",
  "commandLine": "cmd /c exit 3",
  "exitConditions": {
    "exitCodeRanges": [
      {
        "start": 2,
        "end": 4,
        "exitOptions": {
          "jobAction": "terminate"
        }
      }
    ]
  },
  "userIdentity": {
    "autoUser": {
      "scope": "task",
      "elevationLevel": "nonadmin"
    }
  }
}

Sample Response

Status code:

201

Add a task with extra slot requirement

Sample Request

HTTP

POST account.region.batch.azure.com/jobs/jobId/tasks?api-version=2023-11-01.18.0



{
  "id": "task1",
  "requiredSlots": 2,
  "commandLine": "cmd /c echo task1"
}

Sample Response

Status code:

201

Definíciók

Name	Description
AccessScope	Azok a Batch-erőforrások, amelyekhez a jogkivonat hozzáférést biztosít.
AffinityInformation	A Batch szolgáltatás által a tevékenység indításához használt számítási csomópont kiválasztásához használható helymutató.
ApplicationPackageReference	A számítási csomópontokon üzembe helyezendő csomagra mutató hivatkozás.
AuthenticationTokenSettings	Egy hitelesítési jogkivonat beállításai, amelyeket a feladat a Batch-szolgáltatásműveletek végrehajtásához használhat.
AutoUserScope	Az automatikus felhasználó hatóköre
AutoUserSpecification	Megadja a Batch szolgáltatásban feladatot futtató automatikus felhasználó paramétereit.
BatchError	A Azure Batch szolgáltatástól kapott hibaválasz.
BatchErrorDetail	Egy Azure Batch hibaválaszban szereplő további információk egy eleme.
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.
DependencyAction	A Batch szolgáltatás által a tevékenységtől függő tevékenységeken végrehajtott művelet.
ElevationLevel	A felhasználó jogosultságszintje.
EnvironmentSetting	Egy tevékenységfolyamathoz beállítandó környezeti változó.
ErrorMessage	Hibaüzenet érkezett egy Azure Batch hibaválaszban.
ExitCodeMapping	Hogyan reagáljon a Batch szolgáltatás, ha egy tevékenység egy adott kilépési kóddal lép ki.
ExitCodeRangeMapping	A kilépési kódok egy tartománya, és hogy a Batch szolgáltatás hogyan reagáljon az adott tartományon belüli kilépési kódokra.
ExitConditions	Meghatározza, hogy a Batch szolgáltatás hogyan válaszoljon a feladat befejezésekor.
ExitOptions	Meghatározza, hogy a Batch szolgáltatás hogyan reagál egy adott kilépési feltételre.
HttpHeader	EGY HTTP-fejléc név-érték párja
JobAction	A tevékenységet tartalmazó feladaton végrehajtandó művelet, ha a tevékenység a megadott kilépési feltétellel fejeződik be, és a feladat onTaskFailed tulajdonsága "performExitOptionsJobAction".
MultiInstanceSettings	Többpéldányos feladat futtatásának módját meghatározó beállítások.
OutputFile	A fájlok Azure Batch számítási csomópontról egy másik helyre való feltöltésének specifikációja, miután a Batch szolgáltatás befejezte a feladatfolyamat végrehajtását.
OutputFileBlobContainerDestination	Egy Fájlfeltöltési célhelyet határoz meg egy Azure Blob Storage-tárolóban.
OutputFileDestination	Az a cél, ahová a fájlt fel kell tölteni.
OutputFileUploadCondition	Azok a feltételek, amelyek mellett a feladat kimeneti fájlját vagy fájlkészletét fel kell tölteni.
OutputFileUploadOptions	A kimeneti fájlfeltöltési művelet részletei, beleértve a feltöltés végrehajtásához szükséges feltételeket is.
ResourceFile	Egy vagy több fájl, amely egy számítási csomópontra tölthető le.
TaskAddParameter	Hozzáadandó Azure Batch tevékenység.
TaskConstraints	A tevékenységre alkalmazandó végrehajtási korlátozások.
TaskContainerSettings	A feladat tárolóbeállításai.
TaskDependencies	A tevékenység minden függőségét megadja. Az explicit módon megadott vagy függőségi tartományon belüli tevékenységeknek be kell fejeződniük a függő tevékenység ütemezése előtt.
TaskIdRange	Tevékenységazonosítók tartománya, amelyektől a tevékenység függhet. A függő tevékenység ütemezése előtt a tartományban lévő azonosítókkal rendelkező összes tevékenységnek sikeresen be kell fejeződnie.
UserIdentity	Annak a felhasználói identitásnak a definíciója, amely alatt a feladat fut.

AccessScope

Azok a Batch-erőforrások, amelyekhez a jogkivonat hozzáférést biztosít.

Name	Típus	Description
job	string	Hozzáférést biztosít a feladatot tartalmazó feladat összes műveletének végrehajtásához.

AffinityInformation

A Batch szolgáltatás által a tevékenység indításához használt számítási csomópont kiválasztásához használható helymutató.

Name	Típus	Description
affinityId	string	Egy olyan átlátszatlan sztring, amely egy korábban futtatott számítási csomópont vagy feladat helyét jelöli. A csomópont affinitási azonosítóját átadva jelezheti, hogy a tevékenységnek az adott számítási csomóponton kell futnia. Vegye figyelembe, hogy ez csak egy puha affinitás. Ha a cél számítási csomópont foglalt vagy nem érhető el a tevékenység ütemezésének időpontjában, akkor a tevékenység máshol lesz ütemezve.

ApplicationPackageReference

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

Name	Típus	Description
applicationId	string	Az üzembe helyezendő 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 az InvalidApplicationPackageReferences hibakóddal és a 409-es HTTP-állapotkóddal hiúsul meg. Ha ez nincs megadva egy tevékenységen, és nincs megadva alapértelmezett verzió ehhez az alkalmazáshoz, a feladat előfeldolgozási hibával meghiúsul.

AuthenticationTokenSettings

Egy hitelesítési jogkivonat beállításai, amelyeket a feladat a Batch-szolgáltatásműveletek végrehajtásához használhat.

Name	Típus	Description
access	AccessScope[]	Azok a Batch-erőforrások, amelyekhez a jogkivonat hozzáférést biztosít. A hitelesítési jogkivonat korlátozott Számú Batch-szolgáltatásművelethez biztosít hozzáférést. Jelenleg a hozzáférési tulajdonság egyetlen támogatott értéke a "feladat", amely hozzáférést biztosít a feladatot tartalmazó feladathoz kapcsolódó összes művelethez.

AutoUserScope

Az automatikus felhasználó hatóköre

Name	Típus	Description
pool	string	Megadja, hogy a feladat a készlet összes 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 új felhasználót kell létrehoznia a feladathoz.

AutoUserSpecification

Megadja a Batch szolgáltatásban feladatot futtató automatikus felhasználó paramétereit.

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 szabad a normál tevékenységek számára hozzáférhetőnek lenniük, de a StartTasksnak elérhetőnek kell lenniük.

BatchError

A Azure Batch szolgáltatástól kapott hibaválasz.

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

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

Name	Típus	Description
key	string	Egy azonosító, amely az Érték tulajdonság jelentését adja meg.
value	string	A hibaválaszban szereplő további információk.

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.

DependencyAction

A Batch szolgáltatás által a tevékenységtől függő tevékenységeken végrehajtott művelet.

Name	Típus	Description
block	string	Letiltja a tevékenységre várakozó tevékenységeket, megakadályozva az ütemezésüket.
satisfy	string	A feladatra várakozó feladatok kielégítése; Ha az összes függőség teljesül, a tevékenység az ütemezés szerint fog futni.

ElevationLevel

A felhasználó jogosultságszintje.

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 általános jogú, emelt szintű hozzáféréssel nem rendelkező 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.

ExitCodeMapping

Hogyan reagáljon a Batch szolgáltatás, ha egy tevékenység egy adott kilépési kóddal lép ki.

Name	Típus	Description
code	integer	Folyamat kilépési kódja.
exitOptions	ExitOptions	Hogyan reagáljon a Batch szolgáltatás, ha a feladat ezzel a kilépési kóddal lép ki.

ExitCodeRangeMapping

A kilépési kódok egy tartománya, és hogy a Batch szolgáltatás hogyan reagáljon az adott tartományon belüli kilépési kódokra.

Name	Típus	Description
end	integer	A tartomány utolsó kilépési kódja.
exitOptions	ExitOptions	Hogyan reagáljon a Batch szolgáltatás, ha a tevékenység kilép egy kilépési kóddal a tartományban (beleértve).
start	integer	A tartomány első kilépési kódja.

ExitConditions

Meghatározza, hogy a Batch szolgáltatás hogyan válaszoljon a feladat befejezésekor.

Name	Típus	Description
default	ExitOptions	Hogyan reagáljon a Batch szolgáltatás, ha a feladat olyan kilépési feltétellel meghiúsul, amelyet egyik tulajdonság sem fed le. Ezt az értéket akkor használja a rendszer, ha a feladat kilép az exitCodes vagy exitCodeRanges gyűjteményben nem szereplő, nem nulla kilépési kóddal, előfeldolgozási hibával, ha a preProcessingError tulajdonság nincs jelen, vagy fájlfeltöltési hibával, ha a fileUploadError tulajdonság nincs jelen. Ha nem alapértelmezett viselkedést szeretne a 0-s kilépési kódon, explicit módon fel kell sorolnia az exitCodes vagy az exitCodeRanges gyűjtemény használatával.
exitCodeRanges	ExitCodeRangeMapping[]	A tevékenység kilépési kódtartományainak listája, valamint az, hogy a Batch szolgáltatás hogyan reagáljon rájuk.
exitCodes	ExitCodeMapping[]	Az egyes tevékenységkilépési kódok listája, valamint az, hogy a Batch szolgáltatás hogyan reagáljon rájuk.
fileUploadError	ExitOptions	Hogyan reagáljon a Batch szolgáltatás fájlfeltöltési hiba esetén? Ha a feladat kilépési kóddal lépett ki, amelyet az exitCodes vagy az exitCodeRanges parancs használatával adott meg, majd fájlfeltöltési hibát észlelt, akkor a kilépési kód által megadott művelet elsőbbséget élvez.
preProcessingError	ExitOptions	Hogyan reagáljon a Batch szolgáltatás, ha a feladat hiba miatt nem indul el.

ExitOptions

Meghatározza, hogy a Batch szolgáltatás hogyan reagál egy adott kilépési feltételre.

Name	Típus	Description
dependencyAction	DependencyAction	A Batch szolgáltatás által a tevékenységtől függő tevékenységeken végrehajtott művelet. A lehetséges értékek a "megfelelő" (amely lehetővé teszi a függő tevékenységek előrehaladását) és a "blokk" (a függő tevékenységek továbbra is várakoznak). A Batch még nem támogatja a függő tevékenységek megszakítását.
jobAction	JobAction	Ha a feladat a megadott kilépési feltétellel fejeződik be, és a Feladat onTaskFailed tulajdonsága a "performExitOptionsJobAction", akkor a feladatot tartalmazó feladaton végrehajtandó művelet. Az alapértelmezett érték a 0-s kilépési kódnál nincs, és az összes többi kilépési feltételnél le van kapcsolva. Ha a feladat onTaskFailed tulajdonsága noaction, akkor a tulajdonság megadása hibát ad vissza, és a Feladat hozzáadása kérelem érvénytelen tulajdonságérték-hibával meghiúsul; Ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 400 (hibás kérés).

HttpHeader

EGY HTTP-fejléc név-érték párja

Name	Típus	Description
name	string	A kimeneti fájlok feltöltése során használandó fejléc kis- és nagybetűket nem megkülönböztető neve
value	string	A kimeneti fájlok feltöltése során használandó fejléc értéke

JobAction

A tevékenységet tartalmazó feladaton végrehajtandó művelet, ha a tevékenység a megadott kilépési feltétellel fejeződik be, és a feladat onTaskFailed tulajdonsága "performExitOptionsJobAction".

Name	Típus	Description
disable	string	Tiltsa le a feladatot. Ez egyenértékű a disable Job API meghívásával, a disableTasks requeue értékkel.
none	string	Ne tegyen semmilyen műveletet.
terminate	string	Állítsa le a feladatot. A feladat végrehajtásinfo szakaszában a terminateReason értéke "TaskFailed".

MultiInstanceSettings

Többpéldányos feladat futtatásának módját meghatározó beállítások.

Name	Típus	Description
commonResourceFiles	ResourceFile[]	Azon fájlok listája, amelyeket a Batch szolgáltatás letölt a koordinációs parancssor futtatása előtt. A közös erőforrásfájlok és a Tevékenység típusú erőforrásfájlok közötti különbség az, hogy a rendszer minden altevékenységhez letölti a közös erőforrásfájlokat, beleértve az elsődlegeset is, míg a tevékenység-erőforrásfájlok csak az elsődlegeshez lesznek letöltve. Azt is vegye figyelembe, hogy ezek az erőforrásfájlok nem a Tevékenység munkakönyvtárba töltődnek le, hanem a tevékenység gyökérkönyvtárába (a munkakönyvtár felett egy könyvtárba). 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ének méretét csökkenteni kell. Ez .zip fájlok, alkalmazáscsomagok vagy Docker-tárolók használatával érhető el.
coordinationCommandLine	string	Az összes számítási csomóponton futtatandó parancssor, amely lehetővé teszi számukra, hogy koordinálják, amikor az elsődleges futtatja a fő Feladat parancsot. Egy tipikus koordinációs parancssor elindít egy háttérszolgáltatást, és ellenőrzi, hogy a szolgáltatás készen áll-e a csomópontok közötti üzenetek feldolgozására.
numberOfInstances	integer	A tevékenység által igényelt számítási csomópontok száma. Ha nincs megadva, az alapértelmezett érték 1.

OutputFile

A fájlok Azure Batch számítási csomópontról egy másik helyre való feltöltésének specifikációja, miután a Batch szolgáltatás befejezte a feladatfolyamat végrehajtását.

Name	Típus	Description
destination	OutputFileDestination	A kimeneti fájl(ok) célhelye.
filePattern	string	A feltöltendő fájl(ok) mintája. A relatív és az abszolút elérési utak is támogatottak. A relatív elérési utak a Tevékenység munkakönyvtárhoz vannak viszonyítva. A következő helyettesítő karakterek támogatottak: * egyezik legalább 0 karakterrel (például az abc* minta megegyezik az abc-vel vagy az abcdef-lel), ** egyezik bármely könyvtárral, ? egyetlen karaktert, az [abc] a szögletes zárójelek egyik karakterét, az [a-c] pedig a tartomány egy karakterét. A szögletes zárójelek olyan negációt is tartalmazhatnak, amely egyezik a nem megadott karakterekkel (például a [!abc] bármely karakterrel megegyezik, kivéve az a, b vagy c karaktert). Ha egy fájlnév "." betűvel kezdődik, akkor a rendszer alapértelmezés szerint figyelmen kívül hagyja, de explicit módon megadhatja (például .gif nem egyezik a .a.gif, de a ..gif). Egy egyszerű példa: a ***.txt megegyezik minden olyan fájllal, amely nem a következőben kezdődik: ".", és .txt végződik a Tevékenység munkakönyvtárban vagy bármely alkönyvtárban. Ha a fájlnév helyettesítő karaktert tartalmaz, szögletes zárójelek használatával feloldható (például az abc[] egyezik az abc nevű fájllal). Vegye figyelembe, hogy a \ és a / is címtárelválasztóként van kezelve a Windowsban, de csak a / linuxos. A környezeti változók (Windowson%var% vagy Linuxon $var) a minta alkalmazása előtt ki vannak bontva.
uploadOptions	OutputFileUploadOptions	További lehetőségek a feltöltési művelethez, beleértve a feltöltés végrehajtásának feltételeit is.

OutputFileBlobContainerDestination

Egy Fájlfeltöltési célhelyet határoz meg egy Azure Blob Storage-tárolóban.

Name	Típus	Description
containerUrl	string	Annak a tárolónak az URL-címe Azure Blob Storage, ahová a fájlt fel szeretné tölteni. Ha nem használ felügyelt identitást, az URL-címnek tartalmaznia kell egy közös hozzáférésű jogosultságkódot (SAS), amely írási engedélyeket ad a tárolónak.
identityReference	ComputeNodeIdentityReference	A containerUrl által megadott Azure Blob Storage eléréséhez használandó felhasználó által hozzárendelt identitásra mutató hivatkozás Az identitásnak írási hozzáféréssel kell rendelkeznie a Azure Blob Storage tárolóhoz
path	string	A cél blob vagy virtuális könyvtár az Azure Storage-tárolóban. Ha a filePattern egy adott fájlra hivatkozik (azaz nem tartalmaz helyettesítő karaktereket), akkor az elérési út annak a blobnak a neve, amelybe a fájlt fel szeretné tölteni. Ha a filePattern egy vagy több helyettesítő karaktert tartalmaz (ezért több fájlnak is megfelelhet), akkor az elérési út annak a blob virtuális könyvtárnak a neve (amely minden blobnévhez elő van állítva), amelyre a fájl(oka)t fel szeretné tölteni. Ha nincs megadva, a rendszer feltölti a fájl(oka)t a tároló gyökerére a fájlnévnek megfelelő blobnévvel.
uploadHeaders	HttpHeader[]	A kimeneti fájlok feltöltéséhez használandó fejlécek név-érték párjainak listája Ezek a fejlécek akkor lesznek megadva, amikor fájlokat tölt fel az Azure Storage-ba. Hivatalos dokumentum az engedélyezett fejlécekről blobok feltöltésekor: https://docs.microsoft.com/en-us/rest/api/storageservices/put-blob#request-headers-all-blob-types

OutputFileDestination

Az a cél, ahová a fájlt fel kell tölteni.

Name	Típus	Description
container	OutputFileBlobContainerDestination	Egy hely az Azure Blob Storage-ban, ahová a fájlokat feltöltik.

OutputFileUploadCondition

Azok a feltételek, amelyek mellett a feladat kimeneti fájlját vagy fájlkészletét fel kell tölteni.

Name	Típus	Description
taskcompletion	string	Töltse fel a fájl(oka)t a feladatfolyamat bezárása után, függetlenül attól, hogy mi volt a kilépési kód.
taskfailure	string	A fájl(ok) feltöltése csak akkor történik meg, ha a feladatfolyamat kilép egy nem nulla kilépési kóddal.
tasksuccess	string	A fájl(ok) feltöltése csak akkor történik meg, ha a feladatfolyamat kilép a 0-s kilépési kóddal.

OutputFileUploadOptions

A kimeneti fájlfeltöltési művelet részletei, beleértve a feltöltés végrehajtásához szükséges feltételeket is.

Name	Típus	Description
uploadCondition	OutputFileUploadCondition	A feladat kimeneti fájljának vagy fájlkészletének feltöltésének feltételei. Az alapértelmezett érték a feladatkiegészítés.

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 meg kell adni közülük egyet.
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 tárolóban lévő összes fájl le lesz töltve.
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 meg van adva egy erőforrásfájlhoz, amely egy Windows számítási csomópontra lesz letöltve. 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, ahová a fájlt le szeretné tölteni a tevékenység munkakönyvtárához viszonyítva. Ha a httpUrl tulajdonság meg van adva, a filePath megadása kötelező, és leírja 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 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át a rendszer teljes egészében megőrzi, és hozzáfűzi 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 meg kell adni közülük egyet. Ha az URL-cím Azure Blob Storage mutat, akkor olvashatónak kell lennie a számítási csomópontokról. Egy blob ilyen URL-címének lekérése háromféleképpen lehetséges az Azure Storage-ban: tartalmazzon egy közös hozzáférésű jogosultságkódot (SAS), amely olvasási engedélyeket ad a blobhoz, használjon 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éhez.
identityReference	ComputeNodeIdentityReference	A storageContainerUrl vagy a httpUrl által meghatározott Azure Blob Storage eléréséhez használandó 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 Azure Blob Storage. Az autoStorageContainerName, storageContainerUrl és httpUrl tulajdonságok kölcsönösen kizárják egymást, és meg kell adni közülük egyet. Ennek az URL-címnek olvashatónak és listázhatónak kell lennie a számítási csomópontokról. Az Azure Storage-tárolókhoz háromféleképpen lehet ilyen URL-címet beszerezni: 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 olvasási és listázási engedélyekkel rendelkező felügyelt identitást, vagy állítsa be a tároló ACL-ét a nyilvános hozzáférés engedélyezéséhez.

TaskAddParameter

Hozzáadandó Azure Batch tevékenység.

Name	Típus	Description
affinityInfo	AffinityInformation	Egy helyi tipp, amelyet a Batch szolgáltatás használhat egy számítási csomópont kiválasztásához, amelyen az új feladatot el szeretné indítani.
applicationPackageReferences	ApplicationPackageReference[]	A Batch szolgáltatás által a számítási csomóponton üzembe helyezendő csomagok listája a parancssor futtatása előtt. Az alkalmazáscsomagokat a rendszer egy megosztott könyvtárba tölti le és helyezi üzembe, nem pedig a Feladat munkakönyvtárba. Ezért ha egy hivatkozott csomag már megtalálható a csomóponton, és naprakész, akkor nem tölti le újra; a számítási csomóponton található meglévő példányt használja a rendszer. Ha egy hivatkozott csomag nem telepíthető, például azért, mert a csomagot törölték, vagy mert a letöltés sikertelen volt, a feladat meghiúsul.
authenticationTokenSettings	AuthenticationTokenSettings	Egy hitelesítési jogkivonat beállításai, amelyeket a feladat a Batch-szolgáltatásműveletek végrehajtásához használhat. Ha ez a tulajdonság be van állítva, a Batch szolgáltatás egy hitelesítési jogkivonatot biztosít a feladatnak, amely a Batch-szolgáltatás műveleteinek hitelesítéséhez használható fiókhozzáférési kulcs megkövetelése nélkül. A jogkivonatot a AZ_BATCH_AUTHENTICATION_TOKEN környezeti változó biztosítja. A tevékenység által a jogkivonat használatával végrehajtott műveletek a beállításoktól függenek. Egy tevékenység például feladatengedélyeket kérhet, hogy más tevékenységeket is hozzáadhasson a feladathoz, vagy ellenőrizze a feladat vagy a feladat alatti egyéb tevékenységek állapotát.
commandLine	string	A feladat parancssora. Többpéldányos feladatok esetén a parancssor elsődleges feladatként lesz végrehajtva, miután az elsődleges tevékenység és az összes altevékenység befejezte a koordinációs parancssor végrehajtását. A parancssor nem rendszerhéj alatt fut, ezért nem tudja kihasználni a rendszerhéj funkcióit, például a környezeti változók bővítését. Ha ki szeretné használni az ilyen funkciókat, hívja meg a parancssorban a rendszerhéjat, például a windowsos "cmd /c MyCommand" vagy a "/bin/sh -c MyCommand" parancsot Linuxon. Ha a parancssor fájlelérési utakra hivatkozik, relatív elérési utat kell használnia (a Feladat munkakönyvtárához képest), vagy a Batch által megadott környezeti változót (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).
constraints	TaskConstraints	A tevékenységre vonatkozó végrehajtási korlátozások. Ha nem ad meg korlátozásokat, a maxTaskRetryCount a feladathoz megadott maxTaskRetryCount, a maxWallClockTime végtelen, a retentionTime pedig 7 nap.
containerSettings	TaskContainerSettings	Annak a tárolónak a beállításai, amelyek alatt a feladat fut. Ha a feladatot futtató készlet tárolókonfigurálási készlettel rendelkezik, ezt is be kell állítani. Ha a feladatot futtató készlet nem rendelkezik tárolókkonfigurálási beállításkészlettel, ezt nem szabad beállítani. Ha ez meg van adva, a AZ_BATCH_NODE_ROOT_DIR alatti összes címtárat (a csomóponton lévő Azure Batch címtárak gyökerét) a rendszer a tárolóba rendeli, a tevékenységkörnyezet összes változója a tárolóba van 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 előállított fájlok nem jelennek meg a gazdalemezen, ami azt jelenti, hogy a Batch-fájl API-k nem fognak tudni hozzáférni ezekhez a fájlokhoz.
dependsOn	TaskDependencies	Azokat a tevékenységeket, amelyektől ez a tevékenység függ. Ez a tevékenység csak akkor lesz ütemezve, ha az összes tevékenység, amelytől függ, sikeresen befejeződött. Ha bármelyik tevékenység meghiúsul, és kimeríti az újrapróbálkozások számát, ez a tevékenység soha nem lesz ütemezve. Ha a feladat nem használja a TskDependencies értéket igaz értékre, és ez az elem jelen van, a kérés a TaskDependenciesNotSpecifiedOnJob hibakóddal hiúsul meg.
displayName	string	A feladat megjelenítendő neve. A megjelenítendő névnek nem kell egyedinek lennie, és legfeljebb 1024 hosszúságú Unicode-karaktereket tartalmazhat.
environmentSettings	EnvironmentSetting[]	A tevékenység környezeti változóinak listája.
exitConditions	ExitConditions	Meghatározza, hogy a Batch szolgáltatás hogyan válaszoljon a feladat befejezésekor. A Batch szolgáltatás válasza a feladat befejezésekor.
id	string	Egy sztring, amely egyedileg azonosítja a feladatot a feladaton belül. Az azonosító tartalmazhat alfanumerikus karakterek tetszőleges kombinációját, beleértve a kötőjeleket és az aláhúzásokat, és legfeljebb 64 karaktert tartalmazhat. Az azonosító esetmegőrző és kis- és nagybetűket nem érzékelyítő (tehát előfordulhat, hogy egy feladaton belül nem rendelkezik két azonosítóval, amelyek csak esetenként különböznek).
multiInstanceSettings	MultiInstanceSettings	Egy objektum, amely azt jelzi, hogy a tevékenység többpéldányos tevékenység, és információkat tartalmaz a többpéldányos tevékenység futtatásáról. A többpéldányos feladatokat általában az MPI-feladatok támogatására használják. Az MPI-esetben, ha az altevékenységek bármelyike meghiúsul (például egy nem nulla kilépési kóddal való kilépés miatt), a teljes többpéldányos feladat meghiúsul. A többpéldányos feladat ezután leáll, és újrapróbálkozott, egészen az újrapróbálkozás korlátig.
outputFiles	OutputFile[]	Azon fájlok listája, amelyeket a Batch szolgáltatás a parancssor futtatása után feltölt a számítási csomópontról. Többpéldányos feladatok esetén a fájlok csak abból a számítási csomópontból lesznek feltöltve, amelyen az elsődleges tevékenység végrehajtása történik.
requiredSlots	integer	A tevékenység futtatásához szükséges ütemezési pontok száma. Az alapértelmezett érték 1. A tevékenységek csak akkor ütemezhetők egy számítási csomóponton való futtatásra, ha a csomópont elegendő ingyenes ütemezési tárolóhellyel rendelkezik. Többpéldányos feladatok esetén ennek 1-nek kell lennie.
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. Többpéldányos feladatok esetén az erőforrásfájlok csak arra a számítási csomópontra töltődnek le, amelyen az elsődleges tevékenység végrehajtása történik. Az erőforrásfájlok listájának maximális mérete van. A maximális méret túllépésekor a kérés sikertelen lesz, a válasz hibakódja pedig RequestEntityTooLarge lesz. Ha ez történik, a ResourceFiles gyűjteményének méretét csökkenteni kell. Ez .zip fájlok, alkalmazáscsomagok vagy Docker-tárolók használatával érhető el.
userIdentity	UserIdentity	Az a felhasználói identitás, amely alatt a feladat fut. Ha nincs megadva, a tevékenység nem rendszergazdai felhasználóként fut, amely egyedi a tevékenységhez.

TaskConstraints

A tevékenységre alkalmazandó végrehajtási korlátozások.

Name	Típus	Description
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 szabályozza az újrapróbálkozások számát a végrehajtható feladathoz egy nem nulla kilépési kód miatt. 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 a maximális újrapróbálkozási szám 0, a Batch szolgáltatás az első kísérlet után 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).
maxWallClockTime	string	A tevékenység futásának maximális időtartama a tevékenység indításának időpontjától mérve. Ha a tevékenység nem fejeződik be az időkorláton belül, a Batch szolgáltatás leállítja. Ha ez nincs megadva, nincs időkorlát arra vonatkozóan, hogy a tevékenység mennyi ideig futhat.
retentionTime	string	A tevékenységkönyvtár megőrzésének minimális ideje azon a számítási csomóponton, ahol futott, a végrehajtás befejezésének időpontjától kezdve. Ezután a Batch szolgáltatás törölheti a Tevékenység könyvtárat és annak tartalmát. Az alapértelmezett érték 7 nap, azaz a Tevékenység könyvtár 7 napig marad meg, hacsak nem távolítja el a számítási csomópontot, vagy nem törli a feladatot.

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".

TaskDependencies

A tevékenység minden függőségét megadja. Az explicit módon megadott vagy függőségi tartományon belüli tevékenységeknek be kell fejeződniük a függő tevékenység ütemezése előtt.

Name	Típus	Description
taskIdRanges	TaskIdRange[]	Azoknak a tevékenységazonosító-tartományoknak a listája, amelyektől ez a tevékenység függ. Az összes tartomány összes tevékenységének sikeresen be kell fejeződnie, mielőtt a függő tevékenység ütemezhető lenne.
taskIds	string[]	Azoknak a tevékenységazonosítóknak a listája, amelyektől ez a tevékenység függ. A listában szereplő összes tevékenységnek sikeresen be kell fejeződnie ahhoz, hogy a függő tevékenység ütemezhető legyen. A taskIds gyűjtemény összesen legfeljebb 64000 karakter hosszúságú lehet (azaz az összes tevékenységazonosító együttes hossza). Ha a taskIds gyűjtemény túllépi a maximális hosszt, a Feladat hozzáadása kérelem a TaskDependencyListTooLong hibakóddal meghiúsul. Ebben az esetben fontolja meg inkább a Tevékenységazonosító-tartományok használatát.

TaskIdRange

Tevékenységazonosítók tartománya, amelyektől a tevékenység függhet. A függő tevékenység ütemezése előtt a tartományban lévő azonosítókkal rendelkező összes tevékenységnek sikeresen be kell fejeződnie.

Name	Típus	Description
end	integer	A tartomány utolsó tevékenységazonosítója.
start	integer	A tartomány első tevékenységazonosítója.

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.