Tasks - Get Task
Információt kap a megadott feladatról.
Többpéldányos feladatok esetén az olyan információk, mint az affinityId, executionInfo és nodeInfo, az elsődleges feladatra utalnak. Használd a lista alfeladatok API-ját, hogy információkat szerezz az alfeladatokról.
GET {endpoint}/jobs/{jobId}/tasks/{taskId}?api-version=2025-06-01
GET {endpoint}/jobs/{jobId}/tasks/{taskId}?api-version=2025-06-01&timeOut={timeOut}&$select={$select}&$expand={$expand}
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). |
|
job
|
path | True |
string |
Az Feladat azonosítója, amely tartalmazza a feladatot. |
|
task
|
path | True |
string |
Az azonosító feladatról, amiről információt kell szerezni. |
|
api-version
|
query | True |
string minLength: 1 |
A művelethez használandó API-verzió. |
|
$expand
|
query |
string[] |
OData $expand záradék. |
|
|
$select
|
query |
string[] |
OData $select záradék. |
|
|
time
|
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
| Name | Kötelező | 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. |
|
| If-Modified-Since |
string (date-time-rfc7231) |
Az ügyfél által ismert erőforrás utolsó módosítási idejét jelző időbélyeg. A művelet csak akkor lesz végrehajtva, ha a szolgáltatásban lévő erőforrás a megadott időpont óta módosult. |
|
| If-Unmodified-Since |
string (date-time-rfc7231) |
Az ügyfél által ismert erőforrás utolsó módosítási idejét jelző időbélyeg. A művelet csak akkor lesz végrehajtva, ha a szolgáltatásban lévő erőforrás a megadott időpont óta nem módosult. |
|
| If-Match |
string |
Az ügyfél által ismert erőforrás verziójához társított ETag-érték. A művelet csak akkor lesz végrehajtva, ha az erőforrás aktuális ETagje a szolgáltatásban pontosan megegyezik az ügyfél által megadott értékkel. |
|
| If-None-Match |
string |
Az ügyfél által ismert erőforrás verziójához társított ETag-érték. A művelet csak akkor lesz végrehajtva, ha az erőforrás aktuális ETagje a szolgáltatásban nem egyezik meg az ügyfél által megadott értékkel. |
Válaszok
| Name | Típus | Description |
|---|---|---|
| 200 OK |
A kérés sikeres volt. Fejlécek
|
|
| Other Status Codes |
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
Task get
Mintakérelem
GET {endpoint}/jobs/jobId/tasks/taskId?api-version=2025-06-01
Mintaválasz
{
"id": "testTask",
"url": "https://account.region.batch.azure.com/jobs/jobId/tasks/taskId",
"eTag": "0x8D3D62350711C55",
"creationTime": "2025-09-06T06:59:15.1161429Z",
"lastModified": "2025-09-06T06:59:15.1161429Z",
"state": "active",
"stateTransitionTime": "2025-09-06T06:59:15.1161429Z",
"commandLine": "cmd /c hostname",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"multiInstanceSettings": {
"numberOfInstances": 3,
"coordinationCommandLine": "cmd /c echo coordinating"
},
"constraints": {
"maxWallClockTime": "P10675199DT2H48M5.4775807S",
"retentionTime": "P10675199DT2H48M5.4775807S",
"maxTaskRetryCount": 0
},
"requiredSlots": 2,
"executionInfo": {
"retryCount": 0,
"requeueCount": 0
}
}
Definíciók
| Name | Description |
|---|---|
|
Authentication |
Egy hitelesítési jogkivonat beállításai, amelyeket a feladat a Batch szolgáltatásműveletek végrehajtásához használhat. |
|
Auto |
AutoUserScope enums |
|
Auto |
Megadja az Azure Batch-feladatot futtató automatikus felhasználó beállításait. |
|
Batch |
BatchAccessScope enums |
|
Batch |
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. |
|
Batch |
Hivatkozás a számítási csomópontokon üzembe helyezendő csomagra. |
|
Batch |
Az Azure Batch szolgáltatástól kapott hibaválasz. |
|
Batch |
Az Azure Batch-hibaválaszban szereplő további információk egy eleme. |
|
Batch |
Hibaüzenet érkezett egy Azure Batch-hibaválaszban. |
|
Batch |
BatchErrorSourceCategory enums |
|
Batch |
BatchJobAction enumok |
|
Batch |
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. |
|
Batch |
Információk arról a számítási csomópontról, amelyen egy tevékenység futott. |
|
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. |
|
Batch |
A tevékenységre alkalmazandó végrehajtási korlátozások. |
|
Batch |
Információkat tartalmaz arról a tárolóról, amelyet egy feladat hajt végre. |
|
Batch |
A tevékenység tárolóbeállításai. |
|
Batch |
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. |
|
Batch |
Információk egy tevékenység végrehajtásáról. |
|
Batch |
BatchTaskExecutionResult enums |
|
Batch |
A feladathibával kapcsolatos információk. |
|
Batch |
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. |
|
Batch |
BatchTaskState enums |
|
Batch |
Tevékenység erőforrás-használati statisztikái. |
|
Container |
A feladattárolóba csatlakoztatni kívánt elérési út és csatlakoztatási mód bejegyzése. |
|
Container |
A tárolófeladat tárolójára csatlakoztatni kívánt elérési utak. |
|
Container |
Egy privát tárolóregisztrációs adatbázis. |
|
Container |
ContainerWorkingDirectory enums |
|
Dependency |
DependencyAction enumok |
|
Elevation |
ElevationLevel enumok |
|
Environment |
Egy tevékenységfolyamathoz beállítandó környezeti változó. |
|
Exit |
Hogyan reagáljon a Batch szolgáltatás, ha egy tevékenység egy adott kilépési kóddal lép ki. |
|
Exit |
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. |
|
Exit |
Megadja, hogy a Batch szolgáltatás hogyan válaszoljon a feladat befejezésekor. |
|
Exit |
Megadja, hogy a Batch szolgáltatás hogyan reagál egy adott kilépési feltételre. |
|
Multi |
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 |
Név-érték párokat jelöl. |
|
Output |
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. |
|
Output |
Egy Fájlfeltöltési célhelyet határoz meg egy Azure Blob Storage-tárolón belül. |
|
Output |
Az a cél, amelyre a fájlt fel kell tölteni. |
|
Output |
OutputFileUploadCondition enumok |
|
Output |
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. |
|
Output |
EGY HTTP-fejléc név-érték párja |
|
Resource |
Egy vagy több, a számítási csomópontra letöltendő fájl. |
|
User |
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. |
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 |
Az a Batch erőforrás, amelyhez a token hozzáférést biztosít. A hitelesítési token hozzáférést biztosít korlátozott számú Batch szolgáltatási művelethez. Jelenleg az egyetlen támogatott érték a hozzáférési tulajdonsághoz a 'job', amely hozzáférést biztosít minden olyan művelethez, amely a feladatot tartalmazza. |
AutoUserScope
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
Megadja az Azure Batch-feladatot futtató automatikus felhasználó beállításait.
| Name | Típus | Description |
|---|---|---|
| elevationLevel |
Az automatikus felhasználó jogosultságszintje. Az alapértelmezett érték nem Admin. |
|
| scope |
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 olyan módon mutálja a beállításjegyzéket, amely hatással lehet más feladatokra. |
BatchAccessScope
BatchAccessScope enums
| Érték | Description |
|---|---|
| job |
Hozzáférést biztosít az összes művelet végrehajtásához a feladatot tartalmazó feladaton. |
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.
| 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
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. 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 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. |
BatchError
Az 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 |
A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre. |
|
| values |
Kulcs-érték párok gyűjteménye, amelyek további részleteket tartalmaznak a hibáról. |
BatchErrorDetail
Az Azure Batch-hibaválaszban szereplő további információk egy eleme.
| Name | Típus | Description |
|---|---|---|
| key |
string |
Az Érték tulajdonság jelentését meghatározó azonosító. |
| value |
string |
A hibaválasz további információi. |
BatchErrorMessage
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. |
BatchErrorSourceCategory
BatchErrorSourceCategory enums
| Érték | Description |
|---|---|
| usererror |
A hiba egy felhasználói probléma miatt van, például egy rossz konfiguráció miatt. |
| servererror |
A hiba egy belső szerverprobléma miatt van. |
BatchJobActionKind
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
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. |
BatchNodeInfo
Információk arról a számítási csomópontról, amelyen egy tevékenység futott.
| Name | Típus | Description |
|---|---|---|
| affinityId |
string |
Egy azonosító annak a csomópontnak, amelyen a feladat futott, és amely akkor továbbítható, ha hozzáadunk egy feladatot, hogy kérjék a feladat ütemezését ezen a Compute Node-on. |
| nodeId |
string |
A Compute Node azonosítója, amelyen a feladat futott. |
| nodeUrl |
string (uri) |
A Compute Node URL-je, amelyen a feladat futott. |
| poolId |
string |
A Medence azonosítója, amelyen a Feladat futott. |
| taskRootDirectory |
string |
A feladat gyökérkönyvtára a Compute Node-on. |
| taskRootDirectoryUrl |
string (uri) |
A feladat gyökérkönyvtárának URL-je a Compute Node-on. |
BatchTask
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.
| Name | Típus | Description |
|---|---|---|
| affinityInfo |
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 |
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. |
|
| 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 hitelesítési tokent biztosít a Feladatnak, amely a Batch szolgáltatási műveletek hitelesítésére használható anélkül, hogy fiók-hozzáférési kulcsot igényelne. A jogkivonatot a AZ_BATCH_AUTHENTICATION_TOKEN környezeti változó biztosítja. A Feladat által végrehajtható műveletek a tokenrel a beállításoktól függnek. Például egy Feladat kérhet Munka engedélyeket, hogy más feladatokat adhasson a Feladathoz, vagy ellenőrizheti a Feladat vagy más Feladatok állapotát a Feladat alatt. |
|
| 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 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 végrehajtási korlátok, amelyek erre a feladatra vonatkoznak. |
|
| containerSettings |
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 ez meg van határozva, az összes könyvtár rekurzívan a AZ_BATCH_NODE_ROOT_DIR alatt (az Azure Batch könyvtárak gyökere a csomóponton) a konténerbe kerül, minden Feladatkörnyezet változó a konténerbe kerül, és a Feladat parancssorát 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. |
|
| creationTime |
string (date-time) |
A Feladat létrehozásának ideje. |
| dependsOn |
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. |
|
| 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. |
| eTag |
string |
A feladat ETag-ja. Ez egy átlátszatlan sztring. Használhatod arra, hogy érzékeld, változott-e a feladat a kérések között. Különösen az ETag-ot átadhatod egy Feladat frissítésekor, hogy megadja, hogy a változtatások csak akkor lépjenek életbe, ha senki más nem módosította a feladatot az időben. |
| environmentSettings |
A Feladat környezeti változóbeállításainak listája. |
|
| executionInfo |
Információk a feladat végrehajtásáról. |
|
| 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. |
| lastModified |
string (date-time) |
A Feladat utolsó módosított ideje. |
| 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. |
|
| nodeInfo |
Információk a Számítási csomópontról, amelyen a feladat futott. |
|
| outputFiles |
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. |
|
| previousState |
A Feladat korábbi állapota. Ez a tulajdonság nincs beállítva, ha a feladat az eredeti aktív állapotban van. |
|
| previousStateTransitionTime |
string (date-time) |
Az az idő, amikor a Feladat korábbi állapotába került. Ez a tulajdonság nincs beállítva, ha a feladat az eredeti aktív állapotban van. |
| requiredSlots |
integer (int32) |
A feladatnak szükséges ütemezési helyek 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 |
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. |
|
| state |
A Feladat jelenlegi állapota. |
|
| stateTransitionTime |
string (date-time) |
Az az idő, amikor a Feladat jelenlegi állapotába került. |
| stats |
Erőforrás-felhasználási statisztikák a feladathoz. |
|
| url |
string (uri) |
A feladat URL-je. |
| 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ő. |
BatchTaskConstraints
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. |
| 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. |
BatchTaskContainerExecutionInfo
Információkat tartalmaz arról a tárolóról, amelyet egy feladat hajt végre.
| Name | Típus | Description |
|---|---|---|
| containerId |
string |
A tartály azonosítója. |
| error |
string |
Részletes hibainformációk a tartályról. Ez a Docker szolgáltatás részletes hibasorozata, ha elérhető. Ez ekvivalizálja a "docker inspect" által visszaadott hibamezőt. |
| state |
string |
A tartály állapota. Ez a konténer állapota a Docker szolgáltatás szerint. Ez egyenértékű a "docker inspect" által visszaadott állapotmezővel. |
BatchTaskContainerSettings
A tevékenység tárolóbeállításai.
| Name | Típus | Description |
|---|---|---|
| containerHostBatchBindMounts |
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 |
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 |
A konténer Feladat munkakönyvtárának helye. Az alapértelmezett érték a "taskWorkingDirectory". |
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.
| Name | Típus | Description |
|---|---|---|
| taskIdRanges |
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. |
BatchTaskExecutionInfo
Információk egy tevékenység végrehajtásáról.
| Name | Típus | Description |
|---|---|---|
| containerInfo |
Információ arról a konténerről, amelyben a feladat végrehajtódik. Ez a tulajdonság csak akkor van beállítva, ha a feladat konténerkontextusban fut. |
|
| endTime |
string (date-time) |
Az idő, amikor a Feladat befejeződött. Ez a tulajdonság csak akkor van beállítva, ha a feladat befejezett állapotban van. |
| exitCode |
integer (int32) |
A program kilépési kódja, amelyet a Feladat parancssorán jelöltek meg. Ez a tulajdonság csak akkor van beállítva, ha a feladat befejezett állapotban van. Általánosságban a folyamat kilépési kódja tükrözi az alkalmazásfejlesztő által alkalmazott konvenciót az adott folyamatra. Ha a kilépési kód értéket használod döntések meghozatalához a kódodban, győződj meg róla, hogy ismered az alkalmazási folyamat által használt kilépési kód konvenciót. Azonban, ha a Batch szolgáltatás megszünteti a Feladatot (időkorlát vagy a felhasználói végleállás miatt az API-n keresztül), akkor operációs rendszer által definiált kilépési kódot láthatsz. |
| failureInfo |
Információ, amely leírja a feladat hibáját, ha egyáltalán van. Ez a tulajdonság csak akkor van beállítva, ha a feladat befejezett állapotban van, és hibát tapasztalt. |
|
| lastRequeueTime |
string (date-time) |
A legutóbbi alkalom, amikor a Feladatot a Batch szolgáltatás újra sorba állította egy felhasználói kérés hatására. Ez a tulajdonság csak akkor van beállítva, ha a requeueCount nem nulla. |
| lastRetryTime |
string (date-time) |
A legutóbbi alkalom, amikor a Feladat újrapróbálkozása indult. Ez az elem csak akkor létezik, ha a feladatot újra próbálták (azaz a retryCount nem nulla). Ha jelen van, ez általában megegyezik a startTime-val, de eltérhet attól, ha a feladatot más okból újraindították, nem újrapróbálkozásból; például, ha a Compute Node-ot újraindították egy újrapróbálkozás során, akkor a startTime frissül, de az utolsó RetryTime nem. |
| requeueCount |
integer (int32) |
Hányszor sorolta újra a feladatot a Batch szolgáltatás egy felhasználói kérés hatására. Amikor a felhasználó eltávolítja a Compute Node-okat egy poolból (a pool méretének módosításával/zsugorításával), vagy amikor a Feladatot letiltják, a felhasználó beállíthatja, hogy a Compute Node-okon futó feladatokat újra sorba állítsák végrehajtásra. Ez a szám nyomon követi, hányszor sorolták újra a feladatot ezekből az okokból. |
| result |
A feladat végrehajtásának eredménye. Ha az érték 'failed', akkor a hiba részletei megtalálhatók a failureInfo tulajdonságban. |
|
| retryCount |
integer (int32) |
Hányszor próbálták újra a feladatot a Batch szolgáltatás által. A feladatalkalmazás hibáit (nem nulla kijárati kód) újra próbálják, az előfeldolgozási hibákat (a feladatot nem lehetett futtatni) és fájlfeltöltési hibákat nem próbálják újra. A Batch szolgáltatás újra megpróbálja a feladatot a korlátok által meghatározott határig. |
| startTime |
string (date-time) |
Az az idő, amikor a Feladat elkezdődött. A 'Running' megfelel a futó állapotnak, tehát ha a feladat megadja az erőforrásfájlokat vagy csomagokat, akkor a kezdeti idő azt az időpontot tükrözi, amikor a feladat elkezdte ezeket letölteni vagy telepíteni. Ha a Feladatot újraindították vagy újra próbálták, ez a legutóbbi alkalom, amikor a Feladat elkezdte futni. Ez a tulajdonság csak olyan feladatoknál érhető el, amelyek futó vagy befejezett állapotban vannak. |
BatchTaskExecutionResult
BatchTaskExecutionResult enums
| Érték | Description |
|---|---|
| success |
A feladat sikeresen futott. |
| failure |
Hiba történt a feladat feldolgozása során. A hiba előfordulhatott a Feladat folyamat indítása előtt, a Feladat folyamat végrehajtása idején, vagy a Feladat kilépése után. |
BatchTaskFailureInfo
A feladathibával kapcsolatos információk.
| Name | Típus | Description |
|---|---|---|
| category |
A feladathiba kategóriája. |
|
| code |
string |
Egy azonosító a Feladat hibához. A kódok invariánsak, és programozott módon használhatók. |
| details |
További részletek listája a hibával kapcsolatban. |
|
| message |
string |
Egy üzenet, amely leírja a feladathibát, és alkalmas felhasználói felületen való megjelenítésre. |
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.
| Name | Típus | Description |
|---|---|---|
| end |
integer (int32) |
Az utolsó feladatazonosító a tartományban. |
| start |
integer (int32) |
Az első Feladatazonosító a tartományban. |
BatchTaskState
BatchTaskState enums
| Érték | Description |
|---|---|
| active |
A feladat sorba van állítva és képes futni, de jelenleg nincs hozzárendelve Compute Node-hoz. Egy feladat akkor kerül ebbe az állapotba, amikor létrehozják, amikor kikapcsolták a letiltás után, vagy amikor egy sikertelen futtatás után újrapróbálkozásra vár. |
| preparing |
A feladatot egy Compute Node-hoz rendelték, de várja a szükséges Feladatfelkészítő feladatot a Compute Node-on. Ha a Munkafelkészítő feladat sikeres lesz, a feladat futásba kerül. Ha a Feladat Előkészítő Feladat meghibásodik, a Feladat visszatér aktív állapotba, és jogosult lesz egy másik Számítási Csomóponthoz rendelni. |
| running |
A feladat egy Compute Node-on fut. Ez magában foglalja a feladatszintű előkészületeket, például erőforrásfájlok letöltését vagy a feladaton meghatározott csomagok telepítését – ez nem feltétlenül jelenti azt, hogy a feladat parancssor elkezdte a futtatást. |
| completed |
A feladat már nem jogosult futni, általában azért, mert a feladat sikeresen befejeződött, vagy sikertelenül fejezte be és kifogyott az újrapróbálkozási limit. A feladatot akkor is befejezettnek jelölik, ha hiba történt a Feladat indításakor, vagy amikor a feladatot megszüntették. |
BatchTaskStatistics
Tevékenység erőforrás-használati statisztikái.
| Name | Típus | Description |
|---|---|---|
| kernelCPUTime |
string (duration) |
A kernel mód CPU-ideje (összegződve az összes magban és az összes Compute Node-ban), amelyet a feladat fogyaszt. |
| lastUpdateTime |
string (date-time) |
Az az időpont, amikor utoljára frissítették a statisztikákat. Minden statisztika a startTime és a lastUpdateTime közötti tartományra korlátozódik. |
| readIOGiB |
number (float) |
A Feladat által a lemezről olvasott összes gibibájt. |
| readIOps |
string (int64) |
A feladat által végrehajtott lemezolvasási műveletek összesített száma. |
| startTime |
string (date-time) |
A statisztikák által lefedett időintervallum kezdeti ideje. |
| url |
string (uri) |
A statisztikák URL-je. |
| userCPUTime |
string (duration) |
A teljes felhasználói módú CPU idő (összegződve az összes mag és a Compute Node között), amelyet a Feladat fogyaszt. |
| waitTime |
string (duration) |
A Feladat teljes várakozási ideje. A feladat várakozási ideje a feladat létrehozása és a feladat végrehajtása kezdete közötti eltelt időként definiáljuk. (Ha a feladatot hibák miatt újrapróbálják, a várakozási idő a legutóbbi feladat végrehajtásáig eltelt idő.) |
| wallClockTime |
string (duration) |
A Feladat teljes falóra-ideje. A falóraidő az az eltelt idő, amely a Feladat elindulásától a Compute Node-on való futtatásától a befejezésig (vagy az utolsó statisztikák frissítéséig, ha a feladat addigra még nem fejeződött be). Ha a feladatot újra próbálták, ez magában foglalja az összes feladat próbálkozásának fali órás idejét is. |
| writeIOGiB |
number (float) |
A Feladat által a lemezre írt összes gibibájt. |
| writeIOps |
string (int64) |
A feladat által végrehajtott összes meghajtóírási művelet száma. |
ContainerHostBatchBindMountEntry
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 |
A tároló-ügyfélhez csatlakoztatni kívánt elérési út kiválasztható. |
ContainerHostDataPath
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
Egy privát tárolóregisztrációs adatbázis.
| Name | Típus | Description |
|---|---|---|
| identityReference |
A felhasználó által hozzárendelt identitásra mutató hivatkozás, a felhasználónév és a jelszó helyett az Azure Container Registry eléréséhez. |
|
| 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
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
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
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
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
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 |
Hogyan reagáljon a Batch szolgáltatásnak, ha a Feladat kilép ezzel a kijárati kóddal. |
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.
| Name | Típus | Description |
|---|---|---|
| end |
integer (int32) |
Az utolsó kilépési kód a tartományban. |
| 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
Megadja, hogy a Batch szolgáltatás hogyan válaszoljon a feladat befejezésekor.
| Name | Típus | Description |
|---|---|---|
| default |
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 |
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 |
Az egyes feladatkilépési kódok listája és azokat, ahogyan a Batch szolgáltatásnak reagálnia kellene rájuk. |
|
| fileUploadError |
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 |
Hogyan reagáljon a Batch szolgáltatásnak, ha a feladat hiba miatt nem indul el. |
ExitOptions
Megadja, hogy a Batch szolgáltatás hogyan reagál egy adott kilépési feltételre.
| Name | Típus | Description |
|---|---|---|
| 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 |
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
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 |
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. |
NameValuePair
Név-érték párokat jelöl.
| Name | Típus | Description |
|---|---|---|
| name |
string |
A név a név-érték párban. |
| value |
string |
Az érték a név-érték párban. |
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.
| Name | Típus | Description |
|---|---|---|
| destination |
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 a \ és / fájlokat is kezelik a Windowson könyvtárelválasztóként, de csak a / Linuxon működik. A környezeti változókat (%var% Windowson vagy $var Linuxon) bővítik a minta alkalmazása előtt. |
| uploadOptions |
További lehetőségek a feltöltési művelethez, beleértve a feltöltés feltételeit is. |
OutputFileBlobContainerDestination
Egy Fájlfeltöltési célhelyet határoz meg egy Azure Blob Storage-tárolón belül.
| 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ésére kerülnek. 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 |
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 lévő 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 |
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
Az a cél, amelyre a fájlt fel kell tölteni.
| Name | Típus | Description |
|---|---|---|
| container |
Egy hely az Azure blob tárolóban, ahová fájlok feltöltenek. |
OutputFileUploadCondition
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
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 |
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
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
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 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ú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 számára van megadva, amelyet egy Windows Compute Node-ra töltenek le. 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-cím az Azure Blob Storage-ra mutat, akkor a számítási csomópontokról olvashatónak kell lennie. Az Azure Storage-beli blobok URL-címének lekérése három módon lehetséges: tartalmazzon egy megosztott 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 |
A felhasználó által kijelölt identitásra vonatkozó hivatkozás, amelyet az Azure Blob Storage eléréséhez a storageContainerUrl vagy httpUrl határoz meg. |
|
| storageContainerUrl |
string (uri) |
A blobtároló URL-címe az Azure Blob Storage-ban. 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. Az Azure Storage-tárolókhoz háromféleképpen lehet ilyen URL-címet lekérni: tartalmazzon egy olyan közös hozzáférésű jogosultságkódot (SAS), amely olvasási és listaengedélyeket ad a tárolóhoz, használjon egy felügyelt identitást olvasási és listaengedélyekkel, vagy állítsa be a tároló ACL-ét a nyilvános hozzáférés engedélyezéséhez. |
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.
| Name | Típus | Description |
|---|---|---|
| autoUser |
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. |