Megosztás:


Tasks - Create Task

Létrehoz egy feladatot a megadott feladathoz.
Egy feladat maximális élettartama a kiegészítéstől a befejezésig 180 nap. Ha egy feladat 180 napon belül nem fejez be a hozzáadásától, a Batch szolgáltatás megszünteti, és abban az állapotban hagyja, amiben az adott állapotban volt.

POST {endpoint}/jobs/{jobId}/tasks?api-version=2025-06-01
POST {endpoint}/jobs/{jobId}/tasks?api-version=2025-06-01&timeOut={timeOut}

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 a feladat azonosítója, amelyre a feladatot létre kell hozni.

api-version
query True

string

minLength: 1

A művelethez használandó API-verzió.

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

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

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.

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

id True

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. Az ID megőrzi a kisszámot megőrző és nem érzékeny (azaz előfordulhat, hogy nincs két azonosítód egy Job-ban, amelyek csak esetenként különböznek).

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.

constraints

BatchTaskConstraints

A végrehajtási korlátok, amelyek erre a feladatra vonatkoznak. Ha nem határozsz meg korlátozásokat, a maxTaskRetryCount a maxTaskRetryCount a Feladathoz megadott maxTaskRetryCount száma, a maxWallClockTime végtelen, a retentionTime pedig 7 nap.

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.

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. Ha a feladat nincs igazra állítva usesTaskDependencies, és ez az elem jelen van, akkor a kérés hibás kóddal megbukik TaskDependenciesNotSpecifiedOnJob kóddal.

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.

environmentSettings

EnvironmentSetting[]

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

exitConditions

ExitConditions

Hogyan reagáljon a Batch szolgáltatásnak, amikor a Feladat befejeződik.

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.

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.

requiredSlots

integer (int32)

A feladatnak szükséges ütemezési időpontok 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.

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

Válaszok

Name Típus Description
201 Created

A kérés sikeres volt, és ennek eredményeként új erőforrás jött létre.

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

Creates a basic task
Creates a task with container settings
Creates a task with container settings with data isolation
Creates a task with container settings with duplicate source
Creates a task with exit conditions
Creates a task with extra slot requirement

Creates a basic task

Mintakérelem

POST {endpoint}/jobs/jobId/tasks?api-version=2025-06-01



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

Mintaválasz

Creates a task with container settings

Mintakérelem

POST {endpoint}/jobs/jobId/tasks?api-version=2025-06-01



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

Mintaválasz

Creates a task with container settings with data isolation

Mintakérelem

POST {endpoint}/jobs/jobId/tasks?api-version=2025-06-01



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

Mintaválasz

Creates a task with container settings with duplicate source

Mintakérelem

POST {endpoint}/jobs/jobId/tasks?api-version=2025-06-01



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

Creates a task with exit conditions

Mintakérelem

POST {endpoint}/jobs/jobId/tasks?api-version=2025-06-01



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

Mintaválasz

Creates a task with extra slot requirement

Mintakérelem

POST {endpoint}/jobs/jobId/tasks?api-version=2025-06-01



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

Mintaválasz

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.

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.

BatchTaskConstraints

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

BatchTaskContainerSettings

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

BatchTaskCreateOptions

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

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.

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.

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.

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.

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.

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.

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

BatchTaskCreateOptions

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

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. Ha nem határozsz meg korlátozásokat, a maxTaskRetryCount a maxTaskRetryCount a Feladathoz megadott maxTaskRetryCount száma, a maxWallClockTime végtelen, a retentionTime pedig 7 nap.

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.

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. Ha a feladat nincs igazra állítva usesTaskDependencies, és ez az elem jelen van, akkor a kérés hibás kóddal megbukik TaskDependenciesNotSpecifiedOnJob kóddal.

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.

environmentSettings

EnvironmentSetting[]

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

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. Az ID megőrzi a kisszámot megőrző és nem érzékeny (azaz előfordulhat, hogy nincs két azonosítód egy Job-ban, amelyek csak esetenként különböznek).

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.

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.

requiredSlots

integer (int32)

A feladatnak szükséges ütemezési időpontok 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.

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

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.

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.

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.

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.