BatchTaskOutput interface

Csomag:

@azure-rest/batch

A Batch újrapróbálkozza a feladatokat, ha egy helyreállítási művelet aktiválódik egy csomóponton. A helyreállítási műveletek közé tartoznak például (de nem kizárólagosan), ha egy nem megfelelő csomópont újraindul, vagy egy számítási csomópont a gazdagép hibája miatt eltűnt. A helyreállítási műveletek miatti újrapróbálkozások függetlenek a maxTaskRetryCount értékétől, és nem számítanak bele. Még ha a maxTaskRetryCount száma 0 is, belső újrapróbálkozhat egy helyreállítási művelet miatt. Emiatt minden tevékenységnek idempotensnek kell lennie. Ez azt jelenti, hogy a tevékenységeknek el kell viselnie a megszakítást és az újraindítást anélkül, hogy sérülést vagy duplikált adatokat okoznak. A hosszú ideig futó feladatok ajánlott eljárása az ellenőrzőpontok valamilyen formájának használata.

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.
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.
creationTime	A feladat létrehozási ideje.
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.
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.
eTag	A tevékenység ETagje. Ez egy átlátszatlan sztring. Segítségével megállapíthatja, hogy a tevékenység megváltozott-e a kérések között. A feladat frissítésekor átadhatja az ETaget, így megadhatja, hogy a módosítások csak akkor lépnek érvénybe, ha addig senki más nem módosította a tevékenységet.
executionInfo	A feladat végrehajtásával kapcsolatos információk.
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.
lastModified	A tevékenység utolsó módosított időpontja.
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.
nodeInfo	Információk arról a számítási csomópontról, amelyen a tevékenység futott.
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.
previousState	A tevékenység előző állapota. Ez a tulajdonság nincs beállítva, ha a tevékenység kezdeti aktív állapotban van. Lehetséges értékek: "active", "preparing", "running", "completed"
previousStateTransitionTime	Az az időpont, amikor a tevékenység az előző állapotába lépett. Ez a tulajdonság nincs beállítva, ha a tevékenység kezdeti aktív állapotban van.
requiredSlots	Azon ütemezési pontok száma, amelyeket a tevékenységnek futtatnia kell. 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.
state	A tevékenység aktuális állapota. Lehetséges értékek: "active", "preparing", "running", "completed"
stateTransitionTime	A tevékenység aktuális állapotának megadásának időpontja.
stats	A tevékenység erőforrás-használati statisztikái.
url	A tevékenység URL-címe.
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?: BatchAffinityInfoOutput

Tulajdonság értéke

BatchAffinityInfoOutput

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?: BatchApplicationPackageReferenceOutput[]

Tulajdonság értéke

BatchApplicationPackageReferenceOutput[]

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?: AuthenticationTokenSettingsOutput

Tulajdonság értéke

AuthenticationTokenSettingsOutput

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.

constraints?: BatchTaskConstraintsOutput

Tulajdonság értéke

BatchTaskConstraintsOutput

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?: BatchTaskContainerSettingsOutput

Tulajdonság értéke

BatchTaskContainerSettingsOutput

creationTime

A feladat létrehozási ideje.

creationTime: string

Tulajdonság értéke

string

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.

dependsOn?: BatchTaskDependenciesOutput

Tulajdonság értéke

BatchTaskDependenciesOutput

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?: EnvironmentSettingOutput[]

Tulajdonság értéke

EnvironmentSettingOutput[]

eTag

A tevékenység ETagje. Ez egy átlátszatlan sztring. Segítségével megállapíthatja, hogy a tevékenység megváltozott-e a kérések között. A feladat frissítésekor átadhatja az ETaget, így megadhatja, hogy a módosítások csak akkor lépnek érvénybe, ha addig senki más nem módosította a tevékenységet.

eTag: string

Tulajdonság értéke

string

executionInfo

A feladat végrehajtásával kapcsolatos információk.

executionInfo?: BatchTaskExecutionInfoOutput

Tulajdonság értéke

BatchTaskExecutionInfoOutput

exitConditions

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

exitConditions?: ExitConditionsOutput

Tulajdonság értéke

ExitConditionsOutput

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.

id: string

Tulajdonság értéke

string

lastModified

A tevékenység utolsó módosított időpontja.

lastModified: 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?: MultiInstanceSettingsOutput

Tulajdonság értéke

MultiInstanceSettingsOutput

nodeInfo

Információk arról a számítási csomópontról, amelyen a tevékenység futott.

nodeInfo?: BatchNodeInfoOutput

Tulajdonság értéke

BatchNodeInfoOutput

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?: OutputFileOutput[]

Tulajdonság értéke

OutputFileOutput[]

previousState

A tevékenység előző állapota. Ez a tulajdonság nincs beállítva, ha a tevékenység kezdeti aktív állapotban van.

Lehetséges értékek: "active", "preparing", "running", "completed"

previousState?: string

Tulajdonság értéke

string

previousStateTransitionTime

Az az időpont, amikor a tevékenység az előző állapotába lépett. Ez a tulajdonság nincs beállítva, ha a tevékenység kezdeti aktív állapotban van.

previousStateTransitionTime?: string

Tulajdonság értéke

string

requiredSlots

Azon ütemezési pontok száma, amelyeket a tevékenységnek futtatnia kell. 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?: ResourceFileOutput[]

Tulajdonság értéke

ResourceFileOutput[]

state

A tevékenység aktuális állapota.

Lehetséges értékek: "active", "preparing", "running", "completed"

state: string

Tulajdonság értéke

string

stateTransitionTime

A tevékenység aktuális állapotának megadásának időpontja.

stateTransitionTime: string

Tulajdonság értéke

string

stats

A tevékenység erőforrás-használati statisztikái.

stats?: BatchTaskStatisticsOutput

Tulajdonság értéke

BatchTaskStatisticsOutput

url

A tevékenység URL-címe.

url: string

Tulajdonság értéke

string

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?: UserIdentityOutput

Tulajdonság értéke

UserIdentityOutput