Megosztás:


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

jobId
path True

string

Az Feladat azonosítója, amely tartalmazza a feladatot.

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

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

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

BatchTask

A kérés sikeres volt.

Fejlécek

  • DataServiceId: string
  • 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

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
AuthenticationTokenSettings

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

AutoUserScope

AutoUserScope enums

AutoUserSpecification

Megadja az Azure Batch-feladatot futtató automatikus felhasználó beállításait.

BatchAccessScope

BatchAccessScope enums

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.

BatchError

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

BatchErrorDetail

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

BatchErrorMessage

Hibaüzenet érkezett egy Azure Batch-hibaválaszban.

BatchErrorSourceCategory

BatchErrorSourceCategory enums

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.

BatchNodeInfo

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

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.

BatchTaskConstraints

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

BatchTaskContainerExecutionInfo

Információkat tartalmaz arról a tárolóról, amelyet egy feladat hajt végre.

BatchTaskContainerSettings

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

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.

BatchTaskExecutionInfo

Információk egy tevékenység végrehajtásáról.

BatchTaskExecutionResult

BatchTaskExecutionResult enums

BatchTaskFailureInfo

A feladathibával kapcsolatos információk.

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.

BatchTaskState

BatchTaskState enums

BatchTaskStatistics

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

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.

NameValuePair

Név-érték párokat jelöl.

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

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

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.

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

BatchAccessScope[]

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

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

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

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

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.

authenticationTokenSettings

AuthenticationTokenSettings

Egy hitelesítési jogkivonat beállításai, amelyeket a feladat a Batch szolgáltatásműveletek végrehajtásához használhat. Ha ez a tulajdonság be van állítva, a Batch szolgáltatás 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

BatchTaskConstraints

A végrehajtási korlátok, amelyek erre a feladatra vonatkoznak.

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

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.

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

EnvironmentSetting[]

A Feladat környezeti változóbeállításainak listája.

executionInfo

BatchTaskExecutionInfo

Információk a feladat végrehajtásáról.

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.

lastModified

string (date-time)

A Feladat utolsó módosított ideje.

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.

nodeInfo

BatchNodeInfo

Információk a Számítási csomópontról, amelyen a feladat futott.

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.

previousState

BatchTaskState

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

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.

state

BatchTaskState

A Feladat jelenlegi állapota.

stateTransitionTime

string (date-time)

Az az idő, amikor a Feladat jelenlegi állapotába került.

stats

BatchTaskStatistics

Erőforrás-felhasználási statisztikák a feladathoz.

url

string (uri)

A feladat URL-je.

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

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

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

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

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.

BatchTaskExecutionInfo

Információk egy tevékenység végrehajtásáról.

Name Típus Description
containerInfo

BatchTaskContainerExecutionInfo

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

BatchTaskFailureInfo

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

BatchTaskExecutionResult

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

BatchErrorSourceCategory

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

NameValuePair[]

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

ContainerHostDataPath

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

BatchNodeIdentityReference

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

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

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

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

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

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.

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

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

OutputFileUploadConfig

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

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

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

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

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

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

BatchNodeIdentityReference

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

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.