BatchTaskCreateOptions interface

Csomag:

@azure-rest/batch

Az Azure Batch-feladat létrehozásának paraméterei.

Tulajdonságok

affinityInfo	Egy területi tipp, amellyel a Batch szolgáltatás kiválaszthat egy számítási csomópontot, amelyen el szeretné indítani az új feladatot.
applicationPackageReferences	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 telepíti, nem pedig a Feladat munkakönyvtárba. Ezért ha egy hivatkozott csomag már megtalálható a csomóponton, és naprakész, akkor a program nem tölti le újra; a számítási csomópont meglévő példánya lesz használatban. 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	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égrehajtható műveletek a beállításoktól függenek. Egy tevékenység például kérhet feladatengedélyeket, 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.
commandLine	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, a parancssorban meg kell hívnia a rendszerhéjat, például a Windowsban a "cmd /c MyCommand" vagy a "/bin/sh -c MyCommand" parancsmagot Linuxon. 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	A tevékenységre vonatkozó végrehajtási korlátozások. Ha nem határoz meg korlátozásokat, a maxTaskRetryCount a feladathoz megadott maxTaskRetryCount, a maxWallClockTime végtelen, a megőrzési idő pedig 7 nap.
containerSettings	Annak a tárolónak a beállításai, amelyek alatt a feladat fut. Ha a feladatot futtató készlet tárolókonfigurációs készlettel rendelkezik, ezt is be kell állítani. Ha a feladatot futtató készlet nem rendelkezik tárolókonfigurációval, ezt nem szabad beállítani. Ha ez meg van adva, a AZ_BATCH_NODE_ROOT_DIR (a csomóponton található Azure Batch-címtárak gyökere) alatt lévő összes könyvtár rekurzív módon lesz leképezve a tárolóba, a tevékenységkörnyezet összes változója a tárolóba van leképezve, és a feladat parancssora a tárolóban lesz végrehajtva. Előfordulhat, hogy a tárolóban 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 férnek hozzá ezekhez a fájlokhoz.
dependsOn	Azok a tevékenységek, amelyektől ez a tevékenység függ. Ez a tevékenység nem lesz ütemezve, amíg 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 állítva, és ez az elem jelen van, a kérés a TaskDependenciesNotSpecifiedOnJob hibakóddal hiúsul meg.
displayName	A feladat megjelenítendő neve. A megjelenítendő névnek nem kell egyedinek lennie, és legfeljebb 1024 hosszúságú Unicode-karaktereket tartalmazhat.
environmentSettings	A tevékenység környezeti változóbeállításainak listája.
exitConditions	A Batch szolgáltatás válasza a feladat befejezésekor.
id	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ásjeleket, és legfeljebb 64 karaktert tartalmazhat. Az azonosító kis- és nagybetűket nem érzékelyítő (vagyis előfordulhat, hogy nem rendelkezik két azonosítóval egy feladaton belül, amelyek csak esetenként különböznek).
multiInstanceSettings	Egy objektum, amely azt jelzi, hogy a tevékenység többpéldányos tevékenység, és információt tartalmaz a többpéldányos tevékenység futtatásáról.
outputFiles	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	A feladat 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 számítási csomóponton való futtatásra, ha a csomópont elegendő szabad ütemezési pont áll rendelkezésre. Többpéldányos feladatok esetén ennek 1-nek kell lennie.
resourceFiles	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 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. 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	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.

Tulajdonság adatai

affinityInfo

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

affinityInfo?: BatchAffinityInfo

Tulajdonság értéke

BatchAffinityInfo

applicationPackageReferences

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 telepíti, nem pedig a Feladat munkakönyvtárba. Ezért ha egy hivatkozott csomag már megtalálható a csomóponton, és naprakész, akkor a program nem tölti le újra; a számítási csomópont meglévő példánya lesz használatban. 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.

applicationPackageReferences?: BatchApplicationPackageReference[]

Tulajdonság értéke

BatchApplicationPackageReference[]

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égrehajtható műveletek a beállításoktól függenek. Egy tevékenység például kérhet feladatengedélyeket, 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.

authenticationTokenSettings?: AuthenticationTokenSettings

Tulajdonság értéke

AuthenticationTokenSettings

commandLine

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, a parancssorban meg kell hívnia a rendszerhéjat, például a Windowsban a "cmd /c MyCommand" vagy a "/bin/sh -c MyCommand" parancsmagot Linuxon. 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).

commandLine: string

Tulajdonság értéke

string

constraints

A tevékenységre vonatkozó végrehajtási korlátozások. Ha nem határoz meg korlátozásokat, a maxTaskRetryCount a feladathoz megadott maxTaskRetryCount, a maxWallClockTime végtelen, a megőrzési idő pedig 7 nap.

constraints?: BatchTaskConstraints

Tulajdonság értéke

BatchTaskConstraints

containerSettings

Annak a tárolónak a beállításai, amelyek alatt a feladat fut. Ha a feladatot futtató készlet tárolókonfigurációs készlettel rendelkezik, ezt is be kell állítani. Ha a feladatot futtató készlet nem rendelkezik tárolókonfigurációval, ezt nem szabad beállítani. Ha ez meg van adva, a AZ_BATCH_NODE_ROOT_DIR (a csomóponton található Azure Batch-címtárak gyökere) alatt lévő összes könyvtár rekurzív módon lesz leképezve a tárolóba, a tevékenységkörnyezet összes változója a tárolóba van leképezve, és a feladat parancssora a tárolóban lesz végrehajtva. Előfordulhat, hogy a tárolóban 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 férnek hozzá ezekhez a fájlokhoz.

containerSettings?: BatchTaskContainerSettings

Tulajdonság értéke

BatchTaskContainerSettings

dependsOn

Azok a tevékenységek, amelyektől ez a tevékenység függ. Ez a tevékenység nem lesz ütemezve, amíg 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 állítva, és ez az elem jelen van, a kérés a TaskDependenciesNotSpecifiedOnJob hibakóddal hiúsul meg.

dependsOn?: BatchTaskDependencies

Tulajdonság értéke

BatchTaskDependencies

displayName

A feladat megjelenítendő neve. A megjelenítendő névnek nem kell egyedinek lennie, és legfeljebb 1024 hosszúságú Unicode-karaktereket tartalmazhat.

displayName?: string

Tulajdonság értéke

string

environmentSettings

A tevékenység környezeti változóbeállításainak listája.

environmentSettings?: EnvironmentSetting[]

Tulajdonság értéke

EnvironmentSetting[]

exitConditions

A Batch szolgáltatás válasza a feladat befejezésekor.

exitConditions?: ExitConditions

Tulajdonság értéke

ExitConditions

id

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ásjeleket, és legfeljebb 64 karaktert tartalmazhat. Az azonosító kis- és nagybetűket nem érzékelyítő (vagyis előfordulhat, hogy nem rendelkezik két azonosítóval egy feladaton belül, amelyek csak esetenként különböznek).

id: string

Tulajdonság értéke

string

multiInstanceSettings

Egy objektum, amely azt jelzi, hogy a tevékenység többpéldányos tevékenység, és információt tartalmaz a többpéldányos tevékenység futtatásáról.

multiInstanceSettings?: MultiInstanceSettings

Tulajdonság értéke

MultiInstanceSettings

outputFiles

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.

outputFiles?: OutputFile[]

Tulajdonság értéke

OutputFile[]

requiredSlots

A feladat 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 számítási csomóponton való futtatásra, ha a csomópont elegendő szabad ütemezési pont áll rendelkezésre. Többpéldányos feladatok esetén ennek 1-nek kell lennie.

requiredSlots?: number

Tulajdonság értéke

number

resourceFiles

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

resourceFiles?: ResourceFile[]

Tulajdonság értéke

ResourceFile[]

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.

userIdentity?: UserIdentity

Tulajdonság értéke

UserIdentity