Tasks - Create Task Collection

Szolgáltatás:: Batch Service

API-verzió:: 2025-06-01

Hozzáad egy Feladatok gyűjteményét a megadott Feladathoz.
Fontos megjegyezni, hogy minden feladatnak egyedi azonosítóval kell rendelkeznie. A Batch szolgáltatás nem térhet vissza minden feladat eredményeit ugyanabban a sorrendben, ahogy a feladatokat ebben a kérésben benyújtották. Ha a szerver időkorlátot kap vagy a kapcsolat lezáródik a kérés során, a kérés részben vagy teljes egészében feldolgozódhat, vagy egyáltalán nem történt. Ilyen esetekben a felhasználónak újra kell kiküldenie a kérést. Fontos megjegyezni, hogy a felhasználó feladata, hogy helyesen kezelje a hibákat a kérés újraküldésekor. Például ugyanazokat a Feladatazonosítókat kell használni egy újrapróbálkozás során, hogy ha az előző művelet sikeres volt, az újrapróbálkozás ne hozzon létre váratlanul plusz feladatokat. Ha a válasz tartalmaz olyan feladatokat, amelyeket nem sikerült hozzáadni, egy kliens újra megpróbálhatja a kérést. Újrapróbálkozás esetén a leghatékonyabb, ha csak azokat a feladatokat küldjük újra, amelyek nem adtak össze, és kihagyják azokat a feladatokat, amelyeket az első próbálkozáskor sikeresen hozzáadtak. Egy feladat maximális élettartama a kiegészítéstől a befejezésig 180 nap. Ha egy feladat 180 napon belül nem fejez be a hozzáadásától, a Batch szolgáltatás megszünteti, és abban az állapotban hagyja, amiben az adott állapotban volt.

POST {endpoint}/jobs/{jobId}/addtaskcollection?api-version=2025-06-01

Opcionális paraméterekkel:

POST {endpoint}/jobs/{jobId}/addtaskcollection?api-version=2025-06-01&timeOut={timeOut}

URI-paraméterek

Name	In	Kötelező	Típus	Description
endpoint	path	True	string (uri)	Batch-fiók végpontja (például: https://batchaccount.eastus2.batch.azure.com).
jobId	path	True	string	Az a feladat azonosítója, amelyhez a feladatgyűjteményt hozzá kell adni.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.
timeOut	query		integer (int32)	A kiszolgáló által a kérés feldolgozásának maximális időtartama másodpercben. Az alapértelmezett érték 30 másodperc. Ha az érték nagyobb, mint 30, akkor az alapértelmezett értéket használják helyette.".

Kérelem fejléce

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

Name	Típus	Description
client-request-id	string	A hívó által generált kérési identitás guid formában, díszítés nélkül, például kapcsos zárójelek, például 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Azt jelzi, hogy a kiszolgálónak vissza kell-e adnia az ügyfél-kérelem azonosítóját a válaszban.
ocp-date	string (date-time-rfc7231)	A kérelem kiállításának időpontja. Az ügyfélkódtárak ezt általában az aktuális rendszeróra-időpontra állítják be; állítsa be explicit módon, ha közvetlenül a REST API-t hívja meg.

Kérelem törzse

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

Name	Kötelező	Típus	Description
value	True	BatchTaskCreateOptions[]	A feladatok gyűjteménye, amiket hozzáadni kell. A maximális feladatszám 100. Ennek a gyűjteménynek a teljes sorozatos méretének kevesebbnek kell lennie, mint 1MB. Ha nagyobb az 1MB-nál (például ha minden feladatnak száz erőforrás fájlja vagy környezeti változója van), a kérés megbukik 'RequestBodyTooLarge' kóddal, és kevesebb feladattal újra kell próbálkozni.

Válaszok

Name	Típus	Description
200 OK	BatchCreateTaskCollectionResult	A kérés sikeres volt. Fejlécek ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Váratlan hibaválasz.

Name

Típus

Description

200 OK

BatchCreateTaskCollectionResult

A kérés sikeres volt.

Fejlécek

ETag: string
Last-Modified: string
client-request-id: string
request-id: string

Other Status Codes

BatchError

Váratlan hibaválasz.

Biztonság

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Hatókörök

Name	Description
https://batch.core.windows.net//.default

Példák

Creates a basic collection of tasks

Creates a complex collection of tasks

Creates a basic collection of tasks

Mintakérelem

HTTP

POST {endpoint}/jobs/jobId/addtaskcollection?api-version=2025-06-01



{
  "value": [
    {
      "id": "simple1",
      "commandLine": "cmd /c dir /s"
    },
    {
      "id": "simple2",
      "commandLine": "cmd /c dir /s"
    }
  ]
}

Mintaválasz

Állapotkód:: 200

{
  "value": [
    {
      "status": "success",
      "taskId": "simple1",
      "eTag": "0x8D3D623CD661246",
      "lastModified": "2025-09-06T07:02:44.7589958Z",
      "location": "https://account.region.batch.azure.com/jobs/jobId/tasks/simple1"
    },
    {
      "status": "success",
      "taskId": "simple2",
      "eTag": "0x8D3D623CD7072CC",
      "lastModified": "2025-09-06T07:02:44.8270028Z",
      "location": "https://account.region.batch.azure.com/jobs/jobId/tasks/simple2"
    }
  ]
}

Creates a complex collection of tasks

Mintakérelem

HTTP

POST {endpoint}/jobs/jobId/addtaskcollection?api-version=2025-06-01



{
  "value": [
    {
      "id": "complex1",
      "commandLine": "cmd /c dir /s",
      "resourceFiles": [
        {
          "autoStorageContainerName": "containerName",
          "filePath": "data"
        }
      ],
      "environmentSettings": [
        {
          "name": "env1",
          "value": "value1"
        },
        {
          "name": "env2",
          "value": "value2"
        }
      ],
      "affinityInfo": {
        "affinityId": "affinityId"
      },
      "constraints": {
        "maxWallClockTime": "P1D",
        "retentionTime": "P2D",
        "maxTaskRetryCount": 5
      },
      "requiredSlots": 2,
      "multiInstanceSettings": {
        "numberOfInstances": 3,
        "coordinationCommandLine": "cmd /c echo coordinating",
        "commonResourceFiles": [
          {
            "httpUrl": "https://common.blob.core.windows.net/",
            "filePath": "common.exe"
          }
        ]
      }
    },
    {
      "id": "simple3",
      "commandLine": "cmd /c dir /s"
    }
  ]
}

Mintaválasz

Állapotkód:: 200

{
  "value": [
    {
      "taskId": "simple3",
      "status": "success",
      "eTag": "0x8D3D623CE295629",
      "lastModified": "2025-09-06T07:02:46.0386857Z",
      "location": "https://account.region.batch.azure.com/jobs/jobId/tasks/simple3"
    },
    {
      "taskId": "complex1",
      "status": "success",
      "eTag": "0x8D3D623CE29A412",
      "lastModified": "2025-09-06T07:02:46.0406802Z",
      "location": "https://account.region.batch.azure.com/jobs/jobId/tasks/complex1"
    }
  ]
}

Definíciók

Name	Description
AutoUserScope	AutoUserScope enums
AutoUserSpecification	Megadja az automatikus felhasználó beállításait, aki Azure Batch Task-et futtat.
BatchAffinityInfo	Egy területi tipp, amellyel a Batch szolgáltatás kiválaszthat egy számítási csomópontot, amelyen el szeretné indítani a feladatot.
BatchApplicationPackageReference	Hivatkozás a számítási csomópontokon üzembe helyezendő csomagra.
BatchCreateTaskCollectionResult	A feladatok gyűjteményének létrehozása egy feladathoz.
BatchError	Hibaválasz érkezett az Azure Batch szolgáltatástól.
BatchErrorDetail	Egy további információ egy Azure Batch hibaválaszban található.
BatchErrorMessage	Egy hibaüzenet, amelyet Azure Batch hibaválaszban kaptak.
BatchJobActionKind	BatchJobAction enumok
BatchNodeIdentityReference	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.
BatchTaskAddStatus	BatchTaskAddStatus enums
BatchTaskConstraints	A tevékenységre alkalmazandó végrehajtási korlátozások.
BatchTaskContainerSettings	A tevékenység tárolóbeállításai.
BatchTaskCreateOptions	Paraméterek egy Azure Batch Task létrehozásához.
BatchTaskCreateResult	Egyetlen feladat eredménye, amelyet egy feladatgyűjtemény hozzáadása művelet részeként hoztak létre.
BatchTaskDependencies	Egy tevékenység függőségeit adja meg. A kifejezetten megadott vagy függőségi tartományon belüli tevékenységeknek a függő tevékenység ütemezése előtt be kell fejeződniük.
BatchTaskGroup	Egy gyűjtemény Azure Batch Tasks hozzáadásra.
BatchTaskIdRange	A tartomány kezdete és vége befogadó. Ha például egy tartomány kezdete 9 és 12. vége, akkor a "9", a "10", a "11" és a "12" feladatokat jelöli.
ContainerHostBatchBindMountEntry	A feladattárolóba csatlakoztatni kívánt elérési út és csatlakoztatási mód bejegyzése.
ContainerHostDataPath	A tárolófeladat tárolójára csatlakoztatni kívánt elérési utak.
ContainerRegistryReference	Egy privát tárolóregisztrációs adatbázis.
ContainerWorkingDirectory	ContainerWorkingDirectory enums
DependencyAction	DependencyAction enumok
ElevationLevel	ElevationLevel enumok
EnvironmentSetting	Egy tevékenységfolyamathoz beállítandó környezeti változó.
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 tartománya, és hogy a Batch szolgáltatás hogyan reagáljon az adott tartományon belüli kilépési kódokra.
ExitConditions	Megadja, hogy a Batch szolgáltatás hogyan válaszoljon a feladat befejezésekor.
ExitOptions	Megadja, hogy a Batch szolgáltatás hogyan reagál egy adott kilépési feltételre.
MultiInstanceSettings	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álkozik, egészen az újrapróbálkozási korlátig.
OutputFile	Minden fájlfeltöltéskor a Batch szolgáltatás két naplófájlt ír a számítási csomópontra, a "fileuploadout.txt" és a "fileuploaderr.txt" fájlba. Ezek a naplófájlok egy adott hiba további megismerésére szolgálnak.
OutputFileBlobContainerDestination	Megadja a fájlfeltöltési célt egy Azure blob tárolókonténerben.
OutputFileDestination	Az a cél, amelyre a fájlt fel kell tölteni.
OutputFileUploadCondition	OutputFileUploadCondition enumok
OutputFileUploadConfig	A kimeneti fájlfeltöltési művelet beállításai, beleértve a feltöltés végrehajtásához szükséges feltételeket is.
OutputFileUploadHeader	EGY HTTP-fejléc név-érték párja
ResourceFile	Egy vagy több, a számítási csomópontra letöltendő fájl.
UserIdentity	Annak a felhasználói identitásnak a definíciója, amely alatt a feladat fut. Adja meg a userName vagy az autoUser tulajdonságot, de mindkettőt nem.

AutoUserScope

Felsorolás

AutoUserScope enums

Érték	Description
task	Megadja, hogy a szolgáltatásnak új felhasználót hozzon létre a feladathoz.
pool	Megadja, hogy a feladat a közös automatikus felhasználói fiókként fut, amelyet minden Compute Node-on létrehoznak egy Poolban.

AutoUserSpecification

Tárgy

Megadja az automatikus felhasználó beállításait, aki Azure Batch Task-et futtat.

Name	Típus	Description
elevationLevel	ElevationLevel	Az automatikus felhasználó jogosultságszintje. Az alapértelmezett érték nem Admin.
scope	AutoUserScope	Az automatikus felhasználó hatóköre. Az alapértelmezett érték a készlet. Ha a pool Windows-t futtat, akkor a Feladat értéket kell megadni, ha szigorúbb elkülönítés szükséges a feladatok között. Ha például a feladat olyan módon mutálja a beállításjegyzéket, amely hatással lehet más feladatokra.

BatchAffinityInfo

Tárgy

Egy területi tipp, amellyel a Batch szolgáltatás kiválaszthat egy számítási csomópontot, amelyen el szeretné indítani a feladatot.

Name	Típus	Description
affinityId	string	Egy átlátszatlan string, amely egy Compute Node vagy egy korábban futott feladat helyét jelzi. Átadhatod egy csomópont affinititId-jét, hogy jelezze, hogy ennek a feladatnak futnia kell azon a Compute Node-on. 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ésekor, akkor a tevékenység máshol lesz ütemezve.

BatchApplicationPackageReference

Tárgy

Hivatkozás a számítási csomópontokon üzembe helyezendő csomagra.

Name	Típus	Description
applicationId	string	Az alkalmazás ID-je, amelyet telepíteni. Pool létrehozásakor a csomag alkalmazásazonosítójának teljes minősítésűnek 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 ezt egy Poolon kihagyják, és nincs alapértelmezett verzió az alkalmazáshoz, a kérés meghibásodik az InvalidApplicationPackageReferences hibakóddal és a HTTP 409 státuszkóddal. Ha ezt egy feladaton kihagyják, és nincs alapértelmezett verzió ebben az alkalmazásban, a feladat előfeldolgozási hibával meghibázik.

BatchCreateTaskCollectionResult

Tárgy

A feladatok gyűjteményének létrehozása egy feladathoz.

Name	Típus	Description
value	BatchTaskCreateResult[]	A create Task collection művelet eredményei.

BatchError

Tárgy

Hibaválasz érkezett az 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	BatchErrorMessage	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, amelyek további részleteket tartalmaznak a hibáról.

BatchErrorDetail

Tárgy

Egy további információ egy Azure Batch hibaválaszban található.

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

BatchErrorMessage

Tárgy

Egy hibaüzenet, amelyet Azure Batch hibaválaszban kaptak.

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

BatchJobActionKind

Felsorolás

BatchJobAction enumok

Érték	Description
none	Ne tegyél semmit.
disable	Kapcsold ki a munkát. Ez egyenértékű azzal, mint a Job API-t letiltani, ahol a disableTasks érték requeue.
terminate	Felmondd az állást. A feladat executionInfo terminationReason beállítása "TaskFailed"-re van állítva.

BatchNodeIdentityReference

Tárgy

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 (arm-id)	A felhasználó által hozzárendelt identitás ARM-erőforrás-azonosítója.

BatchTaskAddStatus

Felsorolás

BatchTaskAddStatus enums

Érték	Description
success	A feladatot sikeresen hozzáadták.
clienterror	A feladat nem tudott hozzáadni egy kliens hiba miatt, ezért nem szabad újra megpróbálni anélkül, hogy a kérést megfelelően módosítanák.
servererror	A feladat nem tudott hozzáadni egy szerverhiba miatt, és módosítás nélkül újra meg lehet próbálni.

BatchTaskConstraints

Tárgy

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

Name	Típus	Description
maxTaskRetryCount	integer (int32)	A tevékenység újrapróbálásának maximális száma. A Batch szolgáltatás újrapróbálkoz egy feladatot, ha a kilépési kódja nem érvényes. Fontos megjegyezni, hogy ez az érték kifejezetten a feladat futtatható eszközének ismétléspróbálkozásainak számát szabályozza a nulla nélküli kilépési kód miatt. A Batch szolgáltatás egyszer kipróbálja a feladatot, majd megpróbálkozhat ezzel a korláttal. Ha például a maximális újrapróbálkozás 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 nem próbálja újra a feladatot az első próbálkozás után. Ha a maximális újrapróbálkozási szám -1, a Batch szolgáltatás korlátozás nélkül újrapróbálkozza a feladatot, de ez nem ajánlott kezdő tevékenységhez vagy tevékenységhez. Az alapértelmezett érték 0 (nincs újrapróbálkozás).
maxWallClockTime	string (duration)	A maximális eltelt idő, amit a feladat elindulhat, attól az időponttól mérve, amikor a feladat elkezdődött. Ha a feladat nem fejeződik be az időkorláton belül, a Batch szolgáltatás megszünteti azt. Ha ez nincs megadva, nincs időkorlát arra, hogy a feladat mennyi ideig futhat. Az időtartam ISO 8601 formátumban van megadva.
retentionTime	string (duration)	Ez a minimális idő, amíg a Feladatkönyvtár megőrizhető a Compute Node-on, ahol fut, a végrehajtás befejezésétől. Ezután a Batch szolgáltatás törölheti a Feladat könyvtárat és annak tartalmát. Az alapértelmezett 7 nap, azaz a Feladatkönyvtár 7 napig megmarad, hacsak nem távolítják el a Compute Node-ot vagy a Feladatot. Az időtartam ISO 8601 formátumban van megadva.

BatchTaskContainerSettings

Tárgy

A tevékenység tárolóbeállításai.

Name	Típus	Description
containerHostBatchBindMounts	ContainerHostBatchBindMountEntry[]	A tárolófeladathoz csatlakoztatni kívánt elérési utak. Ha ez a tömb null értékű, vagy nincs jelen, a tárolófeladat a teljes ideiglenes lemezmeghajtót csatlakoztatja a Windowsban (vagy linuxos AZ_BATCH_NODE_ROOT_DIR). Ha ez a tömb üresként van beállítva, nem fog adatelérési utakat csatlakoztatni a tárolóhoz.
containerRunOptions	string	A tároló létrehozási parancsának további beállításai. Ezeket a további lehetőségeket argumentumként adja meg a "docker create" parancs, a Batch szolgáltatás által szabályozottakon kívül.
imageName	string	Az a kép, amit a konténernek létrehozhatunk, amelyben a feladat fut. Ez a teljes Image hivatkozás, ahogy a "docker pull" opció szerint is szerepel. Ha a képnév részeként nincs megadva címkét, akkor az alapértelmezett ":latest" címkét használják.
registry	ContainerRegistryReference	A privát regiszter, amely tartalmazza a konténert, az Image-t. Ezt a beállítást el lehet hagyni, ha már elérhető volt a Pool létrehozásánál.
workingDirectory	ContainerWorkingDirectory	A konténer Feladat munkakönyvtárának helye. Az alapértelmezett érték a "taskWorkingDirectory".

BatchTaskCreateOptions

Tárgy

Paraméterek egy Azure Batch Task létrehozásához.

Name	Típus	Description
affinityInfo	BatchAffinityInfo	Egy helyi tipp, amelyet a Batch szolgáltatás használhat egy Compute Node kiválasztására, amelyen elindíthatja az új feladatot.
applicationPackageReferences	BatchApplicationPackageReference[]	Egy lista azokról a csomagokról, amelyeket a Batch szolgáltatás telepít a Compute Node-ra a parancssor futtatása előtt. Az alkalmazáscsomagokat egy megosztott könyvtárba töltik le és telepítik, nem a Feladat munkakönyvtárba. Ezért, ha egy hivatkozott csomag már van a Node-on és naprakész, akkor nem töltik le újra; a Compute Node meglévő példányát használják. Ha egy hivatkozott csomagot nem lehet telepíteni, például mert a csomagot törölték vagy a letöltés sikertelen, akkor a feladat meghibásodik.
commandLine	string	A Feladat parancssora. Többpéldányos feladatoknál a parancssort elsődleges feladatként hajtják végre, miután az elsődleges feladat és minden alfeladat befejezte a koordinációs parancssort. 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 akarod használni az ilyen funkciókat, hívd meg a shellet a parancssorban, például a "cmd /c MyCommand" Windows-ben vagy a "/bin/sh -c MyCommand" használatával Linuxban. Ha a parancssor fájlelérési utakra hivatkozik, akkor 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://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
constraints	BatchTaskConstraints	A végrehajtási korlátok, amelyek erre a feladatra vonatkoznak. Ha nem határozsz meg korlátozásokat, a maxTaskRetryCount a maxTaskRetryCount a Feladathoz megadott maxTaskRetryCount száma, a maxWallClockTime végtelen, a retentionTime pedig 7 nap.
containerSettings	BatchTaskContainerSettings	A konténer, amely alatt a feladat fut. Ha a Feladatot futtató Pool ContainerConfiguration beállított, ezt is be kell állítani. Ha a Pool, amely ezt a feladatot futtatja, nincs containerConfiguration beállítással, akkor ezt nem szabad beállítani. Ha ezt megadják, az összes AZ_BATCH_NODE_ROOT_DIR alatti könyvtár (a csomóponton lévő Azure Batch könyvtár gyökere) rekurzívan a konténerbe kerül, az összes Feladatkörnyezet változót a konténerbe képezik, és a Feladat parancssort a konténerben futtatják. A konténerben AZ_BATCH_NODE_ROOT_DIR kívül előállított fájlok nem feltétlenül tükröződnek a hasztlemezre, ami azt jelenti, hogy a Batch fájl API-k nem férnek hozzá ezekhez a fájlokhoz.
dependsOn	BatchTaskDependencies	Azok a feladatok, amelyekre ez a feladat támaszkodik. Ezt a feladatot csak akkor ütemezik, ha minden feladat, amelyhez épül, sikeresen teljesített. Ha bármelyik feladat megbukik és kimeríti az újrapróbálkozási számát, ez a feladat soha nem lesz ütemezve. Ha a feladat nincs igazra állítva usesTaskDependencies, és ez az elem jelen van, akkor a kérés hibás kóddal megbukik TaskDependenciesNotSpecifiedOnJob kóddal.
displayName	string	A Feladat megjelenítési neve. A megjelenítendő névnek nem kell egyedinek lennie, és legfeljebb 1024 hosszúságú Unicode-karaktereket tartalmazhat.
environmentSettings	EnvironmentSetting[]	A Feladat környezeti változóbeállításainak listája.
exitConditions	ExitConditions	Hogyan reagáljon a Batch szolgáltatásnak, amikor a Feladat befejeződik.
id	string	Egy láncszál, amely egyedien 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ásjeleket, és legfeljebb 64 karaktert tartalmazhat. Az ID megőrzi a kisszámot megőrző és nem érzékeny (azaz előfordulhat, hogy nincs két azonosítód egy Job-ban, amelyek csak esetenként különböznek).
multiInstanceSettings	MultiInstanceSettings	Egy objektum, amely jelzi, hogy a Feladat többpéldányos feladat, és információkat tartalmaz a többpéldányos feladat futtatásáról.
outputFiles	OutputFile[]	Egy lista azokról a fájlokról, amelyeket a Batch szolgáltatás feltölt a Compute Node-ról a parancssor futtatása után. Többpéldányos feladatoknál a fájlokat csak az a Compute Node-ból töltik fel, ahol az elsődleges feladat végrehajtódik.
requiredSlots	integer (int32)	A feladatnak szükséges ütemezési időpontok száma. Az alapértelmezett érték 1. Egy feladatot csak akkor lehet beosztani egy számítási csomóponton, ha a csomópontnak elegendő szabad ütemezési helye van. Többpéldányos feladatokhoz ennek 1-nek kell lennie.
resourceFiles	ResourceFile[]	Azon fájlok listája, amelyeket a Batch szolgáltatás a parancssor futtatása előtt letölt a számítási csomópontra. Többpéldányos feladatoknál az erőforrás fájlok csak arra a Compute Node-ra kerülnek le, ahol a fő feladatot teljesítik. 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é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 azonosító, amely alatt a Feladat fut. Ha kihagyják, a feladat nem adminisztratív felhasználóként fut el, amely egyedi, a feladatra jellemző.

BatchTaskCreateResult

Tárgy

Egyetlen feladat eredménye, amelyet egy feladatgyűjtemény hozzáadása művelet részeként hoztak létre.

Name	Típus	Description
eTag	string	A feladat ETag-ja, ha a feladatot sikeresen hozzáadták. Ezt arra használhatod, hogy kiderítsd, változott-e a feladat a kérések között. Különösen az ETag-nak egy Frissítési Feladatkéréssel adhatod át, hogy a változtatásoknak csak akkor lépjenek életbe, ha addig senki más nem módosította a Feladatot.
error	BatchError	A hiba akkor történt, amikor megpróbáltam hozzáadni a Feladatot.
lastModified	string (date-time)	A Feladat utolsó módosított ideje.
location	string	A feladat URL-je, ha a feladatot sikeresen hozzáadták.
status	BatchTaskAddStatus	Az Add Task request állapota.
taskId	string	Az Adott Feladat azonosítója, amelynek eredménye van.

BatchTaskDependencies

Tárgy

Egy tevékenység függőségeit adja meg. A kifejezetten megadott vagy függőségi tartományon belüli tevékenységeknek a függő tevékenység ütemezése előtt be kell fejeződniük.

Name	Típus	Description
taskIdRanges	BatchTaskIdRange[]	A feladatazonosító tartományok listája, amelytől ez a feladat függ. Minden feladatnak minden tartományban sikeresen teljesítenie kell, mielőtt a függő feladatot ütemezhetnén.
taskIds	string[]	A feladatazonosítók listája, amelyekre ez a feladat függ. Minden feladatnak ebben a listában sikeresen teljesítenie kell, hogy a függő feladatot be lehet ütemezni. A taskIds gyűjteménye összesen 64000 karakterre korlátozott (azaz az összes Feladatazonosító összesített hossza). Ha a taskIds gyűjteménye meghaladja a maximális hosszat, az Add Task kérés meghibásodik a TaskDependencyListTooLong hibakóddal. Ebben az esetben érdemes inkább a feladatazonosító tartományokat használni.

BatchTaskGroup

Tárgy

Egy gyűjtemény Azure Batch Tasks hozzáadásra.

Name	Típus	Description
value	BatchTaskCreateOptions[]	A feladatok gyűjteménye, amiket hozzáadni kell. A maximális feladatszám 100. Ennek a gyűjteménynek a teljes sorozatos méretének kevesebbnek kell lennie, mint 1MB. Ha nagyobb az 1MB-nál (például ha minden feladatnak száz erőforrás fájlja vagy környezeti változója van), a kérés megbukik 'RequestBodyTooLarge' kóddal, és kevesebb feladattal újra kell próbálkozni.

BatchTaskIdRange

Tárgy

A tartomány kezdete és vége befogadó. Ha például egy tartomány kezdete 9 és 12. vége, akkor a "9", a "10", a "11" és a "12" feladatokat jelöli.

Name	Típus	Description
end	integer (int32)	Az utolsó feladatazonosító a tartományban.
start	integer (int32)	Az első Feladatazonosító a tartományban.

ContainerHostBatchBindMountEntry

Tárgy

A feladattárolóba csatlakoztatni kívánt elérési út és csatlakoztatási mód bejegyzése.

Name	Típus	Description
isReadOnly	boolean	Csatlakoztassa ezt a forrásútvonalat írásvédett módként vagy sem. Az alapértelmezett érték hamis (olvasási/írási mód). Linux esetén, ha ezt az elérési utat írási/olvasási módként csatlakoztatja, az nem jelenti azt, hogy a tároló összes felhasználója rendelkezik olvasási/írási hozzáféréssel az elérési úthoz, az a gazdagép virtuális gépének hozzáférésétől függ. Ha ez az elérési út írásvédett, a tárolóban lévő összes felhasználó nem fogja tudni módosítani az elérési utat.
source	ContainerHostDataPath	A tároló-ügyfélhez csatlakoztatni kívánt elérési út kiválasztható.

ContainerHostDataPath

Felsorolás

A tárolófeladat tárolójára csatlakoztatni kívánt elérési utak.

Érték	Description
Shared	A többpéldányos feladat elérési útja a fájlok megosztásához.
Startup	A tevékenység kezdési útvonala.
VfsMounts	Az elérési út az összes virtuális fájlrendszert tartalmazza ezen a csomóponton.
Task	A tevékenység elérési útja.
JobPrep	A feladat-előkészítési tevékenység elérési útja.
Applications	Az alkalmazások elérési útja.

ContainerRegistryReference

Tárgy

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

Name	Típus	Description
identityReference	BatchNodeIdentityReference	A felhasználó által kirendelt identitásra vonatkozó hivatkozás, amelyet az Azure Container Registry-hez való hozzáféréshez kell használni a felhasználónév és jelszó helyett.
password	string (password)	A beállításjegyzék-kiszolgálóra való bejelentkezéshez szükséges jelszó.
registryServer	string (uri)	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 szükséges felhasználónév.

ContainerWorkingDirectory

Felsorolás

ContainerWorkingDirectory enums

Érték	Description
taskWorkingDirectory	Használd a szabványos Batch szolgáltatás Task working könyvtárat, amely tartalmazza a Batch által feltöltött Task Resource Files-okat.
containerImageDefault	Használd a konténer Image munkakönyvtárát. Vigyázz, hogy ez a könyvtár nem tartalmazza a Batch által letöltött Erőforrás fájlokat.

DependencyAction

Felsorolás

DependencyAction enumok

Érték	Description
satisfy	Teljesítsd a feladatokat, amelyek erre a feladatra várnak; Miután minden függőség teljesül, a feladat beállítva indul.
block	Blokkolja a feladatokat erre a feladatra, megakadályozva, hogy időzítsék őket.

ElevationLevel

Felsorolás

ElevationLevel enumok

Érték	Description
nonadmin	A felhasználó egy általános jogú felhasználó, aki nem rendelkezik emelt szintű hozzáféréssel.
admin	A felhasználó emelt szintű hozzáféréssel rendelkező felhasználó, és teljes rendszergazdai engedélyekkel rendelkezik.

EnvironmentSetting

Tárgy

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.

ExitCodeMapping

Tárgy

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 (int32)	Egy folyamat kilépési kód.
exitOptions	ExitOptions	Hogyan reagáljon a Batch szolgáltatásnak, ha a Feladat kilép ezzel a kijárati kóddal.

ExitCodeRangeMapping

Tárgy

A kilépési kódok 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 (int32)	Az utolsó kilépési kód a tartományban.
exitOptions	ExitOptions	Hogyan reagáljon a Batch szolgáltatásnak, ha a Feladat kilép egy kijárati kóddal a tartomány elejétől végéig (beleértve ezt is beleértve).
start	integer (int32)	Az első kilépési kód a tartományban.

ExitConditions

Tárgy

Megadja, 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ásnak, ha a Feladat meghibásodik egy olyan kilépési feltétellel, amelyet más tulajdonságok nem fednek le. Ezt az értéket akkor használják, ha a Feladat kilép bármilyen nulla nélküli exit kóddal, amely nincs az exitCodes vagy exitCodeRanges gyűjteményben, előfeldolgozási hibával, ha a preProcessingError tulajdonság nincs jelen, vagy fájlfeltöltési hibával, ha a fileUploadError tulajdonság nem jelenik meg. Ha nem alapértelmezett viselkedést szeretnél a 0. exit kódon, azt kifejezetten az exitCodes vagy exitCodeRanges gyűjteményen kell felsorolnod.
exitCodeRanges	ExitCodeRangeMapping[]	Egy lista a feladat kilépési kód tartományairól és arról, hogyan kell reagálnia a Batch szolgáltatásnak ezekre.
exitCodes	ExitCodeMapping[]	Az egyes feladatkilépési kódok listája és azokat, ahogyan a Batch szolgáltatásnak reagálnia kellene rájuk.
fileUploadError	ExitOptions	Hogyan reagáljon a Batch szolgáltatásnak, ha fájlfeltöltési hiba jelentkezik. Ha a feladat egy exitCodes vagy exitCodeRanges által megadott exit kóddal lép ki, majd fájlfeltöltési hibát észlel, akkor a kilépési kód által meghatározott művelet kerül előtérbe.
preProcessingError	ExitOptions	Hogyan reagáljon a Batch szolgáltatásnak, ha a feladat hiba miatt nem indul el.

ExitOptions

Tárgy

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

Name	Típus	Description
dependencyAction	DependencyAction	Ez egy olyan művelet, amelyet a Batch szolgáltatás végez olyan feladatokon, amelyek ettől a feladattól függenek. Lehetséges értékek a 'kielégítő' (lehetővé teszi a függő feladatok előrehaladását) és a 'block' (a függő feladatok tovább várnak). A Batch még nem támogatja a függő feladatok törlését.
jobAction	BatchJobActionKind	Egy művelet, amelyet a feladatot tartalmazó feladaton teljesítenek, ha a feladat teljesíti a megadott kilépési feltétellel és a munka onTaskFailed tulajdonságával, a 'performExitOptionsJobAction'. Az alapértelmezett 0-s kilépési kód esetén nem, minden más kijárati feltételnél pedig lezárt. Ha a munka onTaskFailed tulajdonsága noaction, akkor ennek a tulajdonságnak a megadása hibát ad, és az Add Task request hibás tulajdonságérték-hiba esetén meghibázik; ha közvetlenül a REST API-t hívod, a HTTP státuszkód 400 (Bad Request).

MultiInstanceSettings

Tárgy

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álkozik, egészen az újrapróbálkozási korlátig.

Name	Típus	Description
commonResourceFiles	ResourceFile[]	Egy lista azokról a fájlokról, amelyeket a Batch szolgáltatás letölt a koordinációs parancssoron futtatása előtt. A különbség a közös erőforrás fájlok és a feladat erőforrás fájlok között az, hogy a közös erőforrás fájlokat minden alfeladathoz letöltik, beleértve az elsődleges feladatokat is, míg a feladat erőforrás fájlokat csak az elsődleges fájlhoz töltik le. Fontos megjegyezni, hogy ezek az erőforrás-fájlok nem a Feladat munkakönyvtárba kerülnek, hanem a Feladat gyökérkönyvtárba (egy könyvtárral a munkakönyvtár fölött). 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ét csökkenteni kell. Ez .zip fájlok, alkalmazáscsomagok vagy Docker-tárolók használatával érhető el.
coordinationCommandLine	string	A parancssor, amely az összes Compute Node-on fut, hogy koordinálhassa, amikor az elsődleges feladat elindítja a fő feladatparancsot. Egy tipikus koordinációs parancssor elindít egy háttérszolgáltatást, és ellenőrizi, hogy a szolgáltatás készen áll-e a csomópontok közötti üzenetek feldolgozására.
numberOfInstances	integer (int32)	A feladathoz szükséges Compute Node-ok száma. Ha kihagyják, az alapértelmezett érték 1.

OutputFile

Tárgy

Minden fájlfeltöltéskor a Batch szolgáltatás két naplófájlt ír a számítási csomópontra, a "fileuploadout.txt" és a "fileuploaderr.txt" fájlba. Ezek a naplófájlok egy adott hiba további megismerésére szolgálnak.

Name	Típus	Description
destination	OutputFileDestination	A kimeneti fájl(ok) célpontja.
filePattern	string	Egy mintázat, amely jelzi, melyik fájl(okat) kell feltölteni. Mind a relatív és abszolút utak is támogatottak. A relatív utak a Feladat munkakönyvtárhoz viszonylagosak. A következő wildcard támogatott: * 0 vagy több karaktert egyezik (például az abc* minta egyezik az abc vagy abcdef között), ** egyezik bármelyik könyvtárral, ? bármely karakterhez egyezik, [abc] egy karakterhez a zárójelekben, és [A-C] egy karakterhez a tartományban. A zárójelek tartalmazhatnak egy negációt, amely bármely nem meghatározott karakterhez illeszkedik (például [!abc] bármely karakterhez egyezik, kivéve a, b vagy c). Ha egy fájlnév "." betűvel kezdődik, alapértelmezés szerint figyelmen kívül hagyja, de akár explicit megadással is egyezik ( például.gif nem egyezik .a.gif, de ..gif igen). Egy egyszerű példa: **.txt egyezik bármely fájlral, amely nem '''-vel kezdődik, és .txt-val végződik a Feladat munkakönyvtárban vagy bármely alkönyvtárban. Ha a fájlnév wildcard karaktert tartalmaz, azt zárójelekkel lehet eltávolítani (például abc[] egyezik egy abc nevű fájllal*). Fontos megjegyezni, hogy mind a \, mind / fájlokat kezelik könyvtárelosztóként Windows-on, de csak / Linuxon működik. A környezeti változókat (%var% Windows-on vagy $var Linuxon) bővítik a minta alkalmazása előtt.
uploadOptions	OutputFileUploadConfig	További lehetőségek a feltöltési művelethez, beleértve a feltöltés feltételeit is.

OutputFileBlobContainerDestination

Tárgy

Megadja a fájlfeltöltési célt egy Azure blob tárolókonténerben.

Name	Típus	Description
containerUrl	string (uri)	Az Azure Blob Storage-ben található konténer(ek) URL-je, ahová a fájl(ok) feltöltése szükséges. Ha nem kezelt identitást használ, az URL-nek tartalmaznia kell egy Shared Access Signature-et (SAS), amely írási jogokat ad a konténernek.
identityReference	BatchNodeIdentityReference	A felhasználó által kijelölt identitásra vonatkozó hivatkozás, amelyet a containerUrl által megadott Azure Blob Storage eléréséhez használ. Az identitásnak írási hozzáféréssel kell rendelkeznie az Azure Blob Storage konténerhez.
path	string	Az Azure Storage konténerben található cél blob vagy virtuális könyvtár. Ha a filePattern egy adott fájlra utal (azaz nem tartalmaz wildcardot), akkor az út annak a foltnak a neve, ahová az adott fájlt fel kell tölteni. Ha a filePattern egy vagy több vadkártyát tartalmaz (így több fájlhoz is egyezhet), akkor az út a folb virtuális könyvtár neve (amely minden folb névhez előre van csatolva), ahová a fájl(ok) fel kell tölteni. Ha kihagyják, a fájl(ok) a konténer gyökérére töltődnek fel egy folb névvel, amely megegyezik a fájl nevükkel.
uploadHeaders	OutputFileUploadHeader[]	Név-érték párok listája a fejlécekhez, amelyeket a kimeneti fájlok feltöltéséhez használnak. Ezeket a fejléceket meg fogják jelölni, amikor fájlokat feltöltünk az Azure Storage-re. Hivatalos dokumentum az engedélyezett fejlécekről a foltok feltöltésekor: https://learn.microsoft.com/rest/api/storageservices/put-blob#request-headers-all-blob-types.

OutputFileDestination

Tárgy

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

Name	Típus	Description
container	OutputFileBlobContainerDestination	Egy hely az Azure blob tárolóban, ahová fájlok kerülnek feltöltésre.

OutputFileUploadCondition

Felsorolás

OutputFileUploadCondition enumok

Érték	Description
tasksuccess	A fájl(okat) csak akkor töltsd fel, ha a Feladat folyamat kilép, 0 kilépési kóddal.
taskfailure	A fájl(okat) csak akkor töltsd fel, ha a Feladat folyamat kilép egy nulla nélküli kijárati kóddal.
taskcompletion	Töltsd fel a fájl(okat) a feladat kilépése után, függetlenül attól, hogy mi volt a kilépési kód.

OutputFileUploadConfig

Tárgy

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

Name	Típus	Description
uploadCondition	OutputFileUploadCondition	Azok a feltételek, amelyek között a Feladat kimeneti fájlját vagy fájlkészletét fel kell tölteni. Az alapértelmezett feladatteljesítés.

OutputFileUploadHeader

Tárgy

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

Name	Típus	Description
name	string	A fejlécnek a kis- és nagybetűs neve, amelyet a kimeneti fájlok feltöltése közben kell használni.
value	string	A fejléc értéke, amelyet a kimeneti fájlok feltöltése során kell használni.

ResourceFile

Tárgy

Egy vagy több, a számítási csomópontra letöltendő fájl.

Name	Típus	Description
autoStorageContainerName	string	A tárolókonténer név az automatikus tároló fiókban. Az autoStorageContainerName, storageContainerUrl és httpUrl tulajdonságok kölcsönösen kizárják egymást, és meg kell adni az egyiket.
blobPrefix	string	A blob előtag, amit a Azure Storage konténerből történő blobok letöltéséhez használunk. 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útum oktális formátumban. Ez a tulajdonság csak a Linux Compute Node-okra letöltött fájlok esetén érvényes. Figyelmen kívül hagyják, ha egy resourceFile fájlhoz van megadva, amelyet letöltenek egy Windows Compute Node-ra. Ha ez a tulajdonság nincs megadva egy Linux Compute Node esetében, akkor a fájlra alapértelmezett 0770 értéket alkalmaznak.
filePath	string	A Compute Node helye, ahová a fájl(ok) letöltése a feladat munkakönyvtárához viszonyítva. Ha a httpUrl tulajdonság meg van adva, a filePath szükséges, é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, amelybe letölti a fájlokat. Abban az esetben, ha a filePath könyvtárként van használva, a bemeneti adatokhoz már társított címtárstruktúra teljes egészében megmarad, és hozzá lesz fűzve a megadott filePath könyvtárhoz. A megadott relatív út nem törhet ki a feladat munkakönyvtárából (például a '..' használatával).
httpUrl	string (uri)	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 az egyiket. Ha az URL Azure Blob Storage-re mutat, akkor olvashatónak kell lennie számítási csomópontokról. Három módja van egy ilyen URL-nek egy blob számára az Azure tárolóban: beépíteni egy Shared Access Signature-et (SAS), amely olvasási engedélyeket ad a blobon, kezelt identitást használni olvasási engedéllyel, vagy beállítani az ACL-t a blob vagy annak konténeréhez, hogy engedélyezze a nyilvános hozzáférést.
identityReference	BatchNodeIdentityReference	A felhasználó által kijelölt identitás a storageContainerUrl vagy httpUrl által megadott Azure Blob Storage eléréséhez használt hivatkozás.
storageContainerUrl	string (uri)	Az Azure Blob Storage-en belüli blob konténer URL-je. Az autoStorageContainerName, storageContainerUrl és httpUrl tulajdonságok kölcsönösen kizárják egymást, és meg kell adni az egyiket. Ennek az URL-címnek olvashatónak és listázhatónak kell lennie a számítási csomópontokról. Három módja van egy ilyen URL-nek egy Azure tárolóhoz való hozzáférésének: beépíteni egy Shared Access Signature-et (SAS), amely olvasási és listázási engedélyeket ad a konténeren, kezelt identitást használni olvasási és listázási jogokkal, vagy beállítani az ACL-t a konténerhez, hogy engedélyezze a nyilvános hozzáférést.

UserIdentity

Tárgy

Annak a felhasználói identitásnak a definíciója, amely alatt a feladat fut. Adja meg a userName vagy az autoUser tulajdonságot, de mindkettőt nem.

Name	Típus	Description
autoUser	AutoUserSpecification	Az automatikus felhasználó, akinek a feladatot futtatják. A userName és az autoUser tulajdonságok kölcsönösen kizárják egymást; egyet kell megadnia, de mindkettőt nem.
username	string	A felhasználói azonosító neve, amely alatt a feladatot futtatják. A userName és az autoUser tulajdonságok kölcsönösen kizárják egymást; egyet kell megadnia, de mindkettőt nem.