Megosztás a következőn keresztül:


Task - Add

Hozzáad egy feladatot a megadott feladathoz.
A tevékenységek maximális élettartama a befejezéstől a befejezésig 180 nap. Ha egy tevékenység a hozzáadást követő 180 napon belül nem fejeződött be, a Batch szolgáltatás leállítja, és bármilyen állapotban marad abban az időben.

POST {batchUrl}/jobs/{jobId}/tasks?api-version=2024-07-01.20.0
POST {batchUrl}/jobs/{jobId}/tasks?timeout={timeout}&api-version=2024-07-01.20.0

URI-paraméterek

Name In Kötelező Típus Description
batchUrl
path True

string

Az Összes Azure Batch-szolgáltatáskérés alap URL-címe.

jobId
path True

string

Annak a feladatnak az azonosítója, amelyhez a feladatot hozzá kell adni.

api-version
query True

string

Ügyfél API-verziója.

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 a rendszer az alapértelmezett értéket használja.

Kérelem fejléce

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

Name Kötelező Típus Description
client-request-id

string

uuid

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

A kérelem kiállításának időpontja. Az ügyfélkódtárak ezt általában az aktuális rendszeróra-időpontra állítják be; állítsa be explicit módon, ha közvetlenül a REST API-t hívja meg.

Kérelem törzse

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

Name Kötelező Típus Description
commandLine True

string

A feladat parancssora.
Többpéldányos feladatok esetén a parancssor elsődleges feladatként lesz végrehajtva, miután az elsődleges tevékenység és az összes altevékenység befejezte a koordinációs parancssor végrehajtását. A parancssor nem rendszerhéj alatt fut, ezért nem tudja kihasználni a rendszerhéj funkcióit, például a környezeti változók bővítését. Ha ki szeretné használni az ilyen funkciókat, a parancssorban meg kell hívnia a rendszerhéjat, például a Windowsban a "cmd /c MyCommand" vagy a "/bin/sh -c MyCommand" parancsmagot Linuxon. Ha a parancssor fájlelérési utakra hivatkozik, akkor relatív elérési utat kell használnia (a Feladat munkakönyvtárához képest), vagy a Batch által megadott környezeti változót (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).

id True

string

Egy sztring, amely egyedileg azonosítja a feladatot a feladaton belül.
Az azonosító tartalmazhat alfanumerikus karakterek tetszőleges kombinációját, beleértve a kötőjeleket és az aláhúzásjeleket, és legfeljebb 64 karaktert tartalmazhat. Az azonosító kis- és nagybetűket nem érzékelyítő (vagyis előfordulhat, hogy nem rendelkezik két azonosítóval egy feladaton belül, amelyek csak esetenként különböznek).

affinityInfo

AffinityInformation

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

applicationPackageReferences

ApplicationPackageReference[]

Azon csomagok listája, amelyeket a Batch szolgáltatás üzembe helyez a számítási csomóponton a parancssor futtatása előtt.
Az alkalmazáscsomagokat a rendszer egy megosztott könyvtárba tölti le és telepíti, nem pedig a Feladat munkakönyvtárba. Ezért ha egy hivatkozott csomag már megtalálható a csomóponton, és naprakész, akkor a program nem tölti le újra; a számítási csomópont meglévő példánya lesz használatban. Ha egy hivatkozott csomag nem telepíthető, például a csomag törlése vagy a letöltés sikertelensége miatt, a feladat meghiúsul.

authenticationTokenSettings

AuthenticationTokenSettings

Egy hitelesítési jogkivonat beállításai, amelyeket a feladat a Batch szolgáltatásműveletek végrehajtásához használhat.
Ha ez a tulajdonság be van állítva, a Batch szolgáltatás egy hitelesítési jogkivonatot biztosít a feladatnak, amely a Batch szolgáltatás műveleteinek hitelesítéséhez használható fiókhozzáférési kulcs megkövetelése nélkül. A jogkivonatot a AZ_BATCH_AUTHENTICATION_TOKEN környezeti változó biztosítja. A tevékenység által a jogkivonat használatával végrehajtható műveletek a beállításoktól függenek. Egy tevékenység például kérhet feladatengedélyeket, hogy más tevékenységeket vegyen fel a feladatba, vagy ellenőrizze a feladat vagy a feladat alatti egyéb tevékenységek állapotát.

constraints

TaskConstraints

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

containerSettings

TaskContainerSettings

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

dependsOn

TaskDependencies

Azok a tevékenységek, amelyektől ez a tevékenység függ.
Ez a tevékenység nem lesz ütemezve, amíg az összes tevékenység, amelytől függ, sikeresen befejeződött. Ha bármelyik tevékenység meghiúsul, és kimeríti az újrapróbálkozások számát, ez a tevékenység soha nem lesz ütemezve. Ha a feladat nem használja a TskDependencies értéket igaz értékre állítva, és ez az elem jelen van, a kérés a TaskDependenciesNotSpecifiedOnJob hibakóddal hiúsul meg.

displayName

string

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

environmentSettings

EnvironmentSetting[]

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

exitConditions

ExitConditions

Megadja, hogy a Batch szolgáltatás hogyan válaszoljon a feladat befejezésekor.
A Batch szolgáltatás válasza a feladat befejezésekor.

multiInstanceSettings

MultiInstanceSettings

Egy objektum, amely azt jelzi, hogy a tevékenység többpéldányos tevékenység, és információt tartalmaz a többpéldányos tevékenység futtatásáról.
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.

outputFiles

OutputFile[]

Azon fájlok listája, amelyeket a Batch szolgáltatás feltölt a számítási csomópontról a parancssor futtatása után.
Többpéldányos feladatok esetén a fájlok csak abból a számítási csomópontból lesznek feltöltve, amelyen az elsődleges tevékenység végrehajtása történik.

requiredSlots

integer

A feladat futtatásához szükséges ütemezési pontok száma.
Az alapértelmezett érték 1. A tevékenységek csak akkor ütemezhetők számítási csomóponton való futtatásra, ha a csomópont elegendő szabad ütemezési pont áll rendelkezésre. Többpéldányos feladatok esetén ennek 1-nek kell lennie.

resourceFiles

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 feladatok esetén az erőforrásfájlok csak arra a számítási csomópontra lesznek letöltve, amelyen az elsődleges tevékenység végrehajtása történik. Az erőforrásfájlok listájának maximális mérete van. A maximális méret túllépésekor a kérés sikertelen lesz, a válasz hibakódja pedig RequestEntityTooLarge lesz. Ha ez történik, a ResourceFiles gyűjteményét csökkenteni kell. Ez .zip fájlok, alkalmazáscsomagok vagy Docker-tárolók használatával érhető el.

userIdentity

UserIdentity

Az a felhasználói identitás, amely alatt a feladat fut.
Ha nincs megadva, a tevékenység nem rendszergazdai felhasználóként fut, amely egyedi a tevékenységhez.

Válaszok

Name Típus Description
201 Created

A Batch szolgáltatásnak küldött kérés sikeres volt.

Fejlécek

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: string
Other Status Codes

BatchError

A Batch szolgáltatás hibája.

Biztonság

azure_auth

Microsoft Entra OAuth 2.0 hitelesítési kódfolyamat

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

Hatókörök

Name Description
user_impersonation A felhasználói fiók megszemélyesítése

Authorization

Típus: apiKey
In: header

Példák

Add a basic task
Add a container task with container data isolation
Add a container task with container data isolation bad request duplicate sources
Add a task with container settings
Add a task with exit conditions
Add a task with extra slot requirement

Add a basic task

Mintakérelem

POST account.region.batch.azure.com/jobs/jobId/tasks?api-version=2024-07-01.20.0



{
  "id": "task1",
  "commandLine": "cmd /c echo task1"
}

Mintaválasz

Add a container task with container data isolation

Mintakérelem

POST account.region.batch.azure.com/jobs/jobId/tasks?api-version=2024-07-01.20.0



{
  "id": "taskId",
  "commandLine": "bash -c 'echo hello'",
  "containerSettings": {
    "imageName": "ubuntu",
    "containerHostBatchBindMounts": [
      {
        "source": "Task",
        "isReadOnly": true
      }
    ]
  },
  "userIdentity": {
    "autoUser": {
      "scope": "task",
      "elevationLevel": "nonadmin"
    }
  }
}

Mintaválasz

Add a container task with container data isolation bad request duplicate sources

Mintakérelem

POST account.region.batch.azure.com/jobs/jobId/tasks?api-version=2024-07-01.20.0



{
  "id": "taskId",
  "commandLine": "bash -c 'echo hello'",
  "containerSettings": {
    "imageName": "ubuntu",
    "containerHostBatchBindMounts": [
      {
        "source": "Task",
        "isReadOnly": true
      },
      {
        "source": "Task",
        "isReadOnly": true
      }
    ]
  },
  "userIdentity": {
    "autoUser": {
      "scope": "task",
      "elevationLevel": "nonadmin"
    }
  }
}

Mintaválasz

Add a task with container settings

Mintakérelem

POST account.region.batch.azure.com/jobs/jobId/tasks?api-version=2024-07-01.20.0



{
  "id": "taskId",
  "commandLine": "bash -c 'echo hello'",
  "containerSettings": {
    "imageName": "ubuntu",
    "containerRunOptions": "--rm"
  },
  "userIdentity": {
    "autoUser": {
      "scope": "task",
      "elevationLevel": "nonadmin"
    }
  }
}

Mintaválasz

Add a task with exit conditions

Mintakérelem

POST account.region.batch.azure.com/jobs/jobId/tasks?api-version=2024-07-01.20.0



{
  "id": "taskId",
  "commandLine": "cmd /c exit 3",
  "exitConditions": {
    "exitCodeRanges": [
      {
        "start": 2,
        "end": 4,
        "exitOptions": {
          "jobAction": "terminate"
        }
      }
    ]
  },
  "userIdentity": {
    "autoUser": {
      "scope": "task",
      "elevationLevel": "nonadmin"
    }
  }
}

Mintaválasz

Add a task with extra slot requirement

Mintakérelem

POST account.region.batch.azure.com/jobs/jobId/tasks?api-version=2024-07-01.20.0



{
  "id": "task1",
  "requiredSlots": 2,
  "commandLine": "cmd /c echo task1"
}

Mintaválasz

Definíciók

Name Description
AccessScope

Azok a Batch-erőforrások, amelyekhez a jogkivonat hozzáférést biztosít.

AffinityInformation

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.

ApplicationPackageReference

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

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

Az automatikus felhasználó hatóköre

AutoUserSpecification

Megadja annak az automatikus felhasználónak a paramétereit, aki egy feladatot futtat a Batch szolgáltatásban.

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.

ComputeNodeIdentityReference

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.

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.

ContainerRegistry

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

ContainerWorkingDirectory

A tároló tevékenység munkakönyvtárának helye.

DependencyAction

A Batch szolgáltatás által a tevékenységtől függő feladatokon végrehajtott művelet.

ElevationLevel

A felhasználó szintemelési szintje.

EnvironmentSetting

Egy tevékenységfolyamathoz beállítandó környezeti változó.

ErrorMessage

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

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.

HttpHeader

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

JobAction

A feladatot tartalmazó feladaton végrehajtandó művelet, ha a tevékenység a megadott kilépési feltétellel fejeződik be, és a Feladat onTaskFailed tulajdonsága a "performExitOptionsJobAction".

MultiInstanceSettings

A többpéldányos feladat futtatását meghatározó beállítások.

OutputFile

Az Azure Batch számítási csomópontról egy másik helyre való fájlok feltöltésének specifikációja, miután a Batch szolgáltatás befejezte a feladatfolyamat végrehajtását.

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

A feladat kimeneti fájljának vagy fájlkészletének feltöltésének feltételei.

OutputFileUploadOptions

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

ResourceFile

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

TaskAddParameter

Hozzáadandó Azure Batch-feladat.

TaskConstraints

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

TaskContainerSettings

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

TaskDependencies

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.

TaskIdRange

Tevékenységazonosítók tartománya, amelyektől egy tevékenység függhet. A függő tevékenység ütemezhetővé tétele előtt a tartomány összes azonosítójával rendelkező tevékenységnek sikeresen le kell fejeződnie.

UserIdentity

Annak a felhasználói identitásnak a definíciója, amely alatt a feladat fut.

AccessScope

Azok a Batch-erőforrások, amelyekhez a jogkivonat hozzáférést biztosít.

Name Típus Description
job

string

Hozzáférést biztosít a feladatot tartalmazó feladat összes műveletének végrehajtásához.

AffinityInformation

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 sztring, amely egy számítási csomópont vagy egy korábban futtatott feladat helyét jelöli.
A csomópont affinitási azonosítóját átadva jelezheti, hogy a feladatnak az adott számítási csomóponton kell futnia. 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.

ApplicationPackageReference

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

Name Típus Description
applicationId

string

Az üzembe helyezendő alkalmazás azonosítója.
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 ez nincs megadva egy készleten, és nincs megadva alapértelmezett verzió ehhez az alkalmazáshoz, a kérés az InvalidApplicationPackageReferences hibakóddal és a 409-es HTTP-állapotkóddal hiúsul meg. Ha ez nincs megadva egy tevékenységen, és nincs megadva alapértelmezett verzió ehhez az alkalmazáshoz, a feladat előfeldolgozási hibával meghiúsul.

AuthenticationTokenSettings

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

Name Típus Description
access

AccessScope[]

Azok a Batch-erőforrások, amelyekhez a jogkivonat hozzáférést biztosít.
A hitelesítési jogkivonat korlátozott Számú Batch-szolgáltatásművelethez biztosít hozzáférést. Jelenleg a hozzáférési tulajdonság egyetlen támogatott értéke a "feladat", amely hozzáférést biztosít a feladatot tartalmazó feladathoz kapcsolódó összes művelethez.

AutoUserScope

Az automatikus felhasználó hatóköre

Name Típus Description
pool

string

Megadja, hogy a feladat a készlet minden számítási csomópontján létrehozott közös automatikus felhasználói fiókként fusson.

task

string

Megadja, hogy a szolgáltatásnak létre kell hoznia egy új felhasználót a feladathoz.

AutoUserSpecification

Megadja annak az automatikus felhasználónak a paramétereit, aki egy feladatot futtat a Batch szolgáltatásban.

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 tevékenység úgy mutálja a beállításjegyzéket, hogy az hatással lehet más tevékenységekre, vagy olyan tanúsítványokat adott meg a készleten, amelyek nem lehetnek elérhetők a normál tevékenységek által, de a StartTasks számára hozzáférhetőnek kell lenniük.

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

ErrorMessage

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.

ComputeNodeIdentityReference

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

A felhasználó által hozzárendelt identitás ARM-erőforrás-azonosítója.

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.

Name Típus Description
Applications

string

Az alkalmazások elérési útja.

JobPrep

string

A feladat-előkészítési tevékenység elérési útja.

Shared

string

A többpéldányos feladat elérési útja a fájlok megosztásához.

Startup

string

A tevékenység kezdési útvonala.

Task

string

A tevékenység elérési útja.

VfsMounts

string

Az elérési út az összes virtuális fájlrendszert tartalmazza ezen a csomóponton.

ContainerRegistry

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

Name Típus Description
identityReference

ComputeNodeIdentityReference

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

password

string

A beállításjegyzék-kiszolgálóra való bejelentkezéshez szükséges jelszó.

registryServer

string

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

A tároló tevékenység munkakönyvtárának helye.

Name Típus Description
containerImageDefault

string

Használja a tároló lemezképében definiált munkakönyvtárat. Ne feledje, hogy ez a könyvtár nem tartalmazza a Batch által letöltött erőforrásfájlokat.

taskWorkingDirectory

string

Használja a Batch szolgáltatás szokásos tevékenység munkakönyvtárát, amely tartalmazza a Batch által kitöltött tevékenységerőforrás-fájlokat.

DependencyAction

A Batch szolgáltatás által a tevékenységtől függő feladatokon végrehajtott művelet.

Name Típus Description
block

string

Letiltja a tevékenységre várakozó tevékenységeket, megakadályozva azok ütemezését.

satisfy

string

A feladatra váró feladatok kielégítése; Ha az összes függőség teljesül, a feladat futtatása ütemezve lesz.

ElevationLevel

A felhasználó szintemelési szintje.

Name Típus Description
admin

string

A felhasználó emelt szintű hozzáféréssel rendelkező felhasználó, és teljes rendszergazdai engedélyekkel rendelkezik.

nonadmin

string

A felhasználó egy általános jogú felhasználó, aki nem rendelkezik emelt szintű hozzáféréssel.

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.

ErrorMessage

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

Name Típus Description
lang

string

A hibaüzenet nyelvi kódja

value

string

Az üzenet szövege.

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

Egy folyamat kilépési kódja.

exitOptions

ExitOptions

Hogyan reagáljon a Batch szolgáltatás, ha a feladat ezzel a 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.

Name Típus Description
end

integer

A tartomány utolsó kilépési kódja.

exitOptions

ExitOptions

Hogyan kell válaszolnia a Batch szolgáltatásnak, ha a tevékenység kilép egy kilépési kóddal a tartományban (beleértve).

start

integer

A tartomány első kilépési kódja.

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ás, ha a feladat olyan kilépési feltétellel meghiúsul, amelyet egyik tulajdonság sem fed le.
Ezt az értéket akkor használja a rendszer, ha a tevékenység kilép az exitCodes vagy exitCodeRanges gyűjteményben nem szereplő nemzero kilépési kóddal, előfeldolgozási hibával, ha a preProcessingError tulajdonság nem található, vagy ha a fileUploadError tulajdonság nem található, fájlfeltöltési hibával. Ha nem alapértelmezett viselkedést szeretne a 0-s kilépési kódon, explicit módon kell listáznia az exitCodes vagy az exitCodeRanges gyűjtemény használatával.

exitCodeRanges

ExitCodeRangeMapping[]

A tevékenység kilépési kódtartományainak listája, és hogy a Batch szolgáltatás hogyan válaszoljon rájuk.

exitCodes

ExitCodeMapping[]

A tevékenység egyes kilépési kódjainak listája, valamint az, hogy a Batch szolgáltatás hogyan válaszoljon rájuk.

fileUploadError

ExitOptions

A Batch szolgáltatás válasza fájlfeltöltési hiba esetén.
Ha a feladat kilépési kóddal lépett ki, amelyet az exitCodes vagy az exitCodeRanges használatával adott meg, majd fájlfeltöltési hibát észlelt, akkor a kilépési kód által megadott művelet elsőbbséget élvez.

preProcessingError

ExitOptions

Hogyan reagáljon a Batch szolgáltatás, 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

A Batch szolgáltatás által a tevékenységtől függő feladatokon végrehajtott művelet.
A lehetséges értékek a "megfelelő" (amely lehetővé teszi a függő tevékenységek előrehaladását) és a "blokk" (a függő tevékenységek továbbra is várnak). A Batch még nem támogatja a függő tevékenységek törlését.

jobAction

JobAction

A feladatot tartalmazó feladaton végrehajtandó művelet, ha a tevékenység a megadott kilépési feltétellel fejeződik be, és a Feladat onTaskFailed tulajdonsága a "performExitOptionsJobAction".
Az alapértelmezett érték nem a 0-s kilépési kódhoz tartozik, és az összes többi kilépési feltételnél le van kapcsolva. Ha a feladat onTaskFailed tulajdonsága nincs megadva, akkor a tulajdonság megadása hibaüzenetet ad vissza, és a Tevékenység hozzáadása kérelem érvénytelen tulajdonságérték-hibával meghiúsul; ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 400 (hibás kérés).

HttpHeader

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

Name Típus Description
name

string

A kimeneti fájlok feltöltése során használandó fejléc kis- és nagybetűs neve

value

string

A kimeneti fájlok feltöltése során használandó fejléc értéke

JobAction

A feladatot tartalmazó feladaton végrehajtandó művelet, ha a tevékenység a megadott kilépési feltétellel fejeződik be, és a Feladat onTaskFailed tulajdonsága a "performExitOptionsJobAction".

Name Típus Description
disable

string

Tiltsa le a feladatot. Ez egyenértékű a letiltott feladat API meghívásával, a disableTasks requeue értékével.

none

string

Ne tegyen semmilyen műveletet.

terminate

string

Állítsa le a feladatot. A feladat végrehajtásának megszakításaInfo értéke "TaskFailed".

MultiInstanceSettings

A többpéldányos feladat futtatását meghatározó beállítások.

Name Típus Description
commonResourceFiles

ResourceFile[]

A Batch szolgáltatás által a koordinációs parancssor futtatása előtt letöltött fájlok listája.
A közös erőforrásfájlok és a Tevékenység típusú erőforrásfájlok közötti különbség az, hogy a rendszer az összes altevékenységhez letölti a közös erőforrásfájlokat, beleértve az elsődlegeset is, míg a tevékenység típusú erőforrásfájlok csak az elsődlegesre lesznek letöltve. Azt is vegye figyelembe, hogy ezek az erőforrásfájlok nem a Feladat munkakönyvtárba töltődnek le, hanem a Feladat gyökérkönyvtárába (a munkakönyvtár felett egy könyvtárba). 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

Az összes számítási csomóponton futtatandó parancssor, amely lehetővé teszi számukra a koordinációt, amikor az elsődleges futtatja a fő feladat parancsot.
Egy tipikus koordinációs parancssor elindít egy háttérszolgáltatást, és ellenőrzi, hogy a szolgáltatás készen áll-e a csomópontok közötti üzenetek feldolgozására.

numberOfInstances

integer

A tevékenység által igényelt számítási csomópontok száma.
Ha nincs megadva, az alapértelmezett érték 1.

OutputFile

Az Azure Batch számítási csomópontról egy másik helyre való fájlok feltöltésének specifikációja, miután a Batch szolgáltatás befejezte a feladatfolyamat végrehajtását.

Name Típus Description
destination

OutputFileDestination

A kimeneti fájl(ok) célhelye.

filePattern

string

Egy minta, amely jelzi, hogy mely fájl(ok)t kell feltölteni.
A relatív és az abszolút elérési utak is támogatottak. A relatív elérési utak a Tevékenység munkakönyvtárhoz vannak viszonyítva. A következő helyettesítő karakterek támogatottak: * egyezik 0 vagy több karakterrel (például az abc* minta az abc-vel vagy az abcdef-vel egyezik), ** bármilyen könyvtárnak megfelel, ? egyetlen karaktert, a [abc] a zárójelek egyik karakterét, a [a-c] pedig a tartomány egy karakterét. A szögletes zárójelek olyan negációt tartalmazhatnak, amely nem megadott karaktereknek felel meg (például a [!abc] egyezik az a, b vagy c karakterekkel). Ha egy fájlnév "." betűvel kezdődik, alapértelmezés szerint figyelmen kívül hagyja, de explicit megadásával egyeztethető (például .gif nem egyezik .a.gif, de ..gif lesz). Egy egyszerű példa: ***.txt megegyezik minden olyan fájllal, amely nem a "." fájlban kezdődik, és .txt végződik a Feladat munkakönyvtárban vagy bármely alkönyvtárban. Ha a fájlnév helyettesítő karaktert tartalmaz, szögletes zárójelekkel (például az abc[] egyezik az abcnevű fájllal). Vegye figyelembe, hogy a \ és a / is címtárelválasztóként van kezelve a Windowson, de csak a / linuxos. A környezeti változók (windowsos%var% vagy Linuxon $var) a minta alkalmazása előtt ki vannak bontva.

uploadOptions

OutputFileUploadOptions

További lehetőségek a feltöltési művelethez, beleértve a feltöltés végrehajtásának 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

Annak a tárolónak az URL-címe az Azure Blob Storage-ban, ahová fel szeretné tölteni a fájlt(ok).
Ha nem használ felügyelt identitást, az URL-címnek tartalmaznia kell egy közös hozzáférésű jogosultságkódot (SAS), amely írási engedélyeket ad a tárolónak.

identityReference

ComputeNodeIdentityReference

A containerUrl által megadott Azure Blob Storage eléréséhez használt felhasználó által hozzárendelt identitásra mutató hivatkozás
Az identitásnak írási hozzáféréssel kell rendelkeznie az Azure Blob Storage-tárolóhoz

path

string

A cél blob vagy virtuális könyvtár az Azure Storage-tárolóban.
Ha a filePattern egy adott fájlra hivatkozik (azaz nem tartalmaz helyettesítő karaktereket), akkor az elérési út annak a blobnak a neve, amelybe a fájlt fel szeretné tölteni. Ha a filePattern egy vagy több helyettesítő karaktert tartalmaz (és így több fájlnak is megfelelhet), akkor az elérési út annak a blob virtuális könyvtárnak a neve (amely minden blobnévre elő van állítva), amelyre a fájl(ok) feltölthetők. Ha nincs megadva, a rendszer feltölti a fájl(oka)t a tároló gyökerére a fájlnévnek megfelelő blobnévvel.

uploadHeaders

HttpHeader[]

A kimeneti fájlok feltöltéséhez használandó fejlécek név-érték párjainak listája
Ezek a fejlécek akkor lesznek megadva, amikor fájlokat tölt fel az Azure Storage-ba. Hivatalos dokumentum az engedélyezett fejlécekről blobok 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 Storage-ban, ahová a fájlokat feltöltik.

OutputFileUploadCondition

A feladat kimeneti fájljának vagy fájlkészletének feltöltésének feltételei.

Name Típus Description
taskcompletion

string

Töltse fel a fájlt a feladatfolyamat kilépése után, függetlenül attól, hogy mi volt a kilépési kód.

taskfailure

string

A fájl(ok) feltöltése csak akkor történik meg, ha a tevékenységfolyamat kilép egy nemzero kilépési kóddal.

tasksuccess

string

A fájl(ok) feltöltése csak a feladatfolyamat 0-s kilépési kóddal való kilépése után történik.

OutputFileUploadOptions

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

Name Típus Description
uploadCondition

OutputFileUploadCondition

A feladat kimeneti fájljának vagy fájlkészletének feltöltésének feltételei.
Az alapértelmezett feladatkiegészítés.

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ó neve az automatikus tárfió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 számítási csomópontokra letöltött fájlokra vonatkozik. A rendszer figyelmen kívül hagyja, ha egy resourceFile-fájlhoz van megadva, amely egy Windows számítási csomópontra lesz letöltve. Ha ez a tulajdonság nincs megadva Linux számítási csomóponthoz, akkor a rendszer egy alapértelmezett 0770-et alkalmaz a fájlra.

filePath

string

A számítási csomópont azon helye, ahová le szeretné tölteni a fájlt a tevékenység 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 elérési út nem bontható ki a tevékenység munkakönyvtárából (például a ".." használatával).

httpUrl

string

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

ComputeNodeIdentityReference

A storageContainerUrl vagy a httpUrl által megadott Azure Blob Storage eléréséhez használt felhasználó által hozzárendelt identitásra mutató hivatkozás
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.

storageContainerUrl

string

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.

TaskAddParameter

Hozzáadandó Azure Batch-feladat.

Name Típus Description
affinityInfo

AffinityInformation

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

applicationPackageReferences

ApplicationPackageReference[]

Azon csomagok listája, amelyeket a Batch szolgáltatás üzembe helyez a számítási csomóponton a parancssor futtatása előtt.
Az alkalmazáscsomagokat a rendszer egy megosztott könyvtárba tölti le és telepíti, nem pedig a Feladat munkakönyvtárba. Ezért ha egy hivatkozott csomag már megtalálható a csomóponton, és naprakész, akkor a program nem tölti le újra; a számítási csomópont meglévő példánya lesz használatban. Ha egy hivatkozott csomag nem telepíthető, például a csomag törlése vagy a letöltés sikertelensége miatt, a feladat meghiúsul.

authenticationTokenSettings

AuthenticationTokenSettings

Egy hitelesítési jogkivonat beállításai, amelyeket a feladat a Batch szolgáltatásműveletek végrehajtásához használhat.
Ha ez a tulajdonság be van állítva, a Batch szolgáltatás egy hitelesítési jogkivonatot biztosít a feladatnak, amely a Batch szolgáltatás műveleteinek hitelesítéséhez használható fiókhozzáférési kulcs megkövetelése nélkül. A jogkivonatot a AZ_BATCH_AUTHENTICATION_TOKEN környezeti változó biztosítja. A tevékenység által a jogkivonat használatával végrehajtható műveletek a beállításoktól függenek. Egy tevékenység például kérhet feladatengedélyeket, hogy más tevékenységeket vegyen fel a feladatba, vagy ellenőrizze a feladat vagy a feladat alatti egyéb tevékenységek állapotát.

commandLine

string

A feladat parancssora.
Többpéldányos feladatok esetén a parancssor elsődleges feladatként lesz végrehajtva, miután az elsődleges tevékenység és az összes altevékenység befejezte a koordinációs parancssor végrehajtását. A parancssor nem rendszerhéj alatt fut, ezért nem tudja kihasználni a rendszerhéj funkcióit, például a környezeti változók bővítését. Ha ki szeretné használni az ilyen funkciókat, a parancssorban meg kell hívnia a rendszerhéjat, például a Windowsban a "cmd /c MyCommand" vagy a "/bin/sh -c MyCommand" parancsmagot Linuxon. Ha a parancssor fájlelérési utakra hivatkozik, akkor relatív elérési utat kell használnia (a Feladat munkakönyvtárához képest), vagy a Batch által megadott környezeti változót (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).

constraints

TaskConstraints

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

containerSettings

TaskContainerSettings

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

dependsOn

TaskDependencies

Azok a tevékenységek, amelyektől ez a tevékenység függ.
Ez a tevékenység nem lesz ütemezve, amíg az összes tevékenység, amelytől függ, sikeresen befejeződött. Ha bármelyik tevékenység meghiúsul, és kimeríti az újrapróbálkozások számát, ez a tevékenység soha nem lesz ütemezve. Ha a feladat nem használja a TskDependencies értéket igaz értékre állítva, és ez az elem jelen van, a kérés a TaskDependenciesNotSpecifiedOnJob hibakóddal hiúsul meg.

displayName

string

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

environmentSettings

EnvironmentSetting[]

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

exitConditions

ExitConditions

Megadja, hogy a Batch szolgáltatás hogyan válaszoljon a feladat befejezésekor.
A Batch szolgáltatás válasza a feladat befejezésekor.

id

string

Egy sztring, amely egyedileg azonosítja a feladatot a feladaton belül.
Az azonosító tartalmazhat alfanumerikus karakterek tetszőleges kombinációját, beleértve a kötőjeleket és az aláhúzásjeleket, és legfeljebb 64 karaktert tartalmazhat. Az azonosító kis- és nagybetűket nem érzékelyítő (vagyis előfordulhat, hogy nem rendelkezik két azonosítóval egy feladaton belül, amelyek csak esetenként különböznek).

multiInstanceSettings

MultiInstanceSettings

Egy objektum, amely azt jelzi, hogy a tevékenység többpéldányos tevékenység, és információt tartalmaz a többpéldányos tevékenység futtatásáról.
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.

outputFiles

OutputFile[]

Azon fájlok listája, amelyeket a Batch szolgáltatás feltölt a számítási csomópontról a parancssor futtatása után.
Többpéldányos feladatok esetén a fájlok csak abból a számítási csomópontból lesznek feltöltve, amelyen az elsődleges tevékenység végrehajtása történik.

requiredSlots

integer

A feladat futtatásához szükséges ütemezési pontok száma.
Az alapértelmezett érték 1. A tevékenységek csak akkor ütemezhetők számítási csomóponton való futtatásra, ha a csomópont elegendő szabad ütemezési pont áll rendelkezésre. Többpéldányos feladatok esetén ennek 1-nek kell lennie.

resourceFiles

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 feladatok esetén az erőforrásfájlok csak arra a számítási csomópontra lesznek letöltve, amelyen az elsődleges tevékenység végrehajtása történik. Az erőforrásfájlok listájának maximális mérete van. A maximális méret túllépésekor a kérés sikertelen lesz, a válasz hibakódja pedig RequestEntityTooLarge lesz. Ha ez történik, a ResourceFiles gyűjteményét csökkenteni kell. Ez .zip fájlok, alkalmazáscsomagok vagy Docker-tárolók használatával érhető el.

userIdentity

UserIdentity

Az a felhasználói identitás, amely alatt a feladat fut.
Ha nincs megadva, a tevékenység nem rendszergazdai felhasználóként fut, amely egyedi a tevékenységhez.

TaskConstraints

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

Name Típus Description
maxTaskRetryCount

integer

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.
Vegye figyelembe, hogy ez az érték kifejezetten szabályozza a nem kilépési kód miatt végrehajtható feladat újrapróbálkozásának számát. 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 az első kísérlet után nem próbálja újra a feladatot. 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

A tevékenység futásának maximális időtartama a tevékenység indításának időpontjától mérve. Ha a tevékenység nem fejeződik be az időkorláton belül, a Batch szolgáltatás leállítja.
Ha ez nincs megadva, nincs időkorlát arra vonatkozóan, hogy a tevékenység mennyi ideig futhat.

retentionTime

string

A tevékenységkönyvtár azon a számítási csomóponton való megőrzésének minimális ideje, amely a végrehajtás befejezésétől kezdve fut. Ezt követően a Batch szolgáltatás törölheti a Tevékenység könyvtárat és annak tartalmát.
Az alapértelmezett érték 7 nap, azaz a feladatkönyvtár 7 napig marad meg, kivéve, ha a számítási csomópont el lett távolítva, vagy a feladat törlődik.

TaskContainerSettings

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

A tároló létrehozásához használni kívánt rendszerkép, amelyben a feladat futni fog.
Ez a teljes képhivatkozás, ahogy a "docker pull" kifejezés is meg van adva. Ha a rendszer nem ad meg címkét a képnév részeként, a rendszer alapértelmezés szerint a "latest" címkét használja.

registry

ContainerRegistry

A tároló lemezképét tartalmazó privát beállításjegyzék.
Ez a beállítás kihagyható, ha már meg van adva a készlet létrehozásakor.

workingDirectory

ContainerWorkingDirectory

A tároló tevékenység munkakönyvtárának helye.
Az alapértelmezett érték a "taskWorkingDirectory".

TaskDependencies

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

TaskIdRange[]

Azoknak a tevékenységazonosító-tartományoknak a listája, amelyektől ez a tevékenység függ. Az összes tartomány összes tevékenységének sikeresen le kell fejeződnie, mielőtt a függő tevékenység ütemezhető lenne.

taskIds

string[]

Azoknak a tevékenységazonosítóknak a listája, amelyektől ez a tevékenység függ. A listában szereplő összes tevékenységnek sikeresen le kell fejeződnie, mielőtt a függő tevékenység ütemezhető lenne.
A taskIds gyűjtemény összesen legfeljebb 64000 karakter hosszúságú lehet (azaz az összes tevékenységazonosító együttes hossza). Ha a taskIds-gyűjtemény túllépi a maximális hosszt, a Tevékenység hozzáadása kérelem a TaskDependencyListTooLong hibakóddal meghiúsul. Ebben az esetben fontolja meg inkább a tevékenységazonosító-tartományok használatát.

TaskIdRange

Tevékenységazonosítók tartománya, amelyektől egy tevékenység függhet. A függő tevékenység ütemezhetővé tétele előtt a tartomány összes azonosítójával rendelkező tevékenységnek sikeresen le kell fejeződnie.

Name Típus Description
end

integer

A tartomány utolsó tevékenységazonosítója.

start

integer

A tartomány első tevékenységazonosítója.

UserIdentity

Annak a felhasználói identitásnak a definíciója, amely alatt a feladat fut.

Name Típus Description
autoUser

AutoUserSpecification

Az az automatikus felhasználó, amely alatt a feladat fut.
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

Annak a felhasználói identitásnak a neve, amely alatt a feladat fut.
A userName és az autoUser tulajdonságok kölcsönösen kizárják egymást; egyet kell megadnia, de mindkettőt nem.