Megosztás:


Nodes - List Nodes

Felsorolja a Compute Node-okat a megadott Poolban.

GET {endpoint}/pools/{poolId}/nodes?api-version=2025-06-01
GET {endpoint}/pools/{poolId}/nodes?api-version=2025-06-01&timeOut={timeOut}&maxresults={maxresults}&$filter={$filter}&$select={$select}

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

poolId
path True

string

Az a Pool azonosítója, ahonnan Compute Node-okat szeretnél listázni.

api-version
query True

string

minLength: 1

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

$filter
query

string

OData $filter záradék. További információért a szűrő építéséről lásd.https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-nodes-in-a-pool

$select
query

string[]

OData $select záradék.

maxresults
query

integer (int32)

minimum: 1
maximum: 1000

A válaszban visszaadandó elemek maximális száma. Legfeljebb 1000 jelentkezés vissza lehet küldeni.

timeOut
query

integer (int32)

A kiszolgáló által a kérés feldolgozásának maximális időtartama másodpercben. Az alapértelmezett érték 30 másodperc. Ha az érték nagyobb, mint 30, akkor az alapértelmezett értéket használják helyette.".

Kérelem fejléce

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

string

A hívó által generált kérési identitás guid formában, díszítés nélkül, például kapcsos zárójelek, például 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id

boolean

Azt jelzi, hogy a kiszolgálónak vissza kell-e adnia az ügyfél-kérelem azonosítóját a válaszban.

ocp-date

string (date-time-rfc7231)

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

Válaszok

Name Típus Description
200 OK

BatchNodeListResult

A kérés sikeres volt.

Fejlécek

  • 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

Node list

Mintakérelem

GET {endpoint}/pools/poolId/nodes?api-version=2025-06-01


Mintaválasz

{
  "value": [
    {
      "id": "tvm-1695681911_1-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2025-11-22T22:22:27.2236818Z",
      "lastBootTime": "2025-11-22T22:22:24.4634125Z",
      "allocationTime": "2025-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "ipv6Address": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_1-20161122t193202z",
      "vmSize": "Standard_D2_v5",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "virtualMachineInfo": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "ubuntu-24_04-lts",
          "sku": "server",
          "version": "latest",
          "exactVersion": "latest"
        }
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2025-11-22T22:22:27.2236818Z",
        "endTime": "2025-11-22T22:22:27.567189Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
      }
    },
    {
      "id": "tvm-1695681911_2-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2025-11-22T19:37:31.4285526Z",
      "lastBootTime": "2025-11-22T19:37:28.623369Z",
      "allocationTime": "2025-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "ipv6Address": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_2-20161122t193202z",
      "vmSize": "Standard_D2_v5",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "virtualMachineInfo": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "ubuntu-24_04-lts",
          "sku": "server",
          "version": "latest",
          "exactVersion": "latest"
        }
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2025-11-22T19:37:31.4285526Z",
        "endTime": "2025-11-22T19:37:31.838028Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
      }
    },
    {
      "id": "tvm-1695681911_3-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_3-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2025-11-22T19:36:51.0013378Z",
      "lastBootTime": "2025-11-22T19:36:48.21721Z",
      "allocationTime": "2025-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "ipv6Address": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_3-20161122t193202z",
      "vmSize": "Standard_D2_v5",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "virtualMachineInfo": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "ubuntu-24_04-lts",
          "sku": "server",
          "version": "latest",
          "exactVersion": "latest"
        }
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2025-11-22T19:36:51.0013378Z",
        "endTime": "2025-11-22T19:36:51.2363447Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
      }
    }
  ]
}

Definíciók

Name Description
AutoUserScope

AutoUserScope enums

AutoUserSpecification

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

BatchError

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

BatchErrorDetail

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

BatchErrorMessage

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

BatchErrorSourceCategory

BatchErrorSourceCategory enums

BatchNode

Számítási csomópont a Batch szolgáltatásban.

BatchNodeAgentInfo

A Batch számítási csomópont ügynök egy olyan program, amely a készlet minden számítási csomópontján fut, és Batch-képességet biztosít a számítási csomóponton.

BatchNodeEndpointConfiguration

A számítási csomópont végpontkonfigurációja.

BatchNodeError

Egy számítási csomópont hibát észlelt.

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.

BatchNodeListResult

A számítási csomópontok készletben való listázásának eredménye.

BatchNodeState

BatchNodeState enumok

BatchStartTask

A Batch újrapróbálkozza a feladatokat, ha egy helyreállítási művelet aktiválódik egy csomóponton. A helyreállítási műveletek közé tartoznak például (de nem kizárólagosan), ha egy nem megfelelő csomópont újraindul, vagy egy számítási csomópont a gazdagép hibája miatt eltűnt. A helyreállítási műveletek miatti újrapróbálkozások függetlenek a maxTaskRetryCount értékétől, és nem számítanak bele. Még ha a maxTaskRetryCount száma 0 is, belső újrapróbálkozhat egy helyreállítási művelet miatt. Emiatt minden tevékenységnek idempotensnek kell lennie. Ez azt jelenti, hogy a tevékenységeknek el kell viselnie a megszakítást és az újraindítást anélkül, hogy sérülést vagy duplikált adatokat okoznak. A hosszú ideig futó feladatok ajánlott eljárása az ellenőrzőpontok valamilyen formájának használata. Bizonyos esetekben előfordulhat, hogy a StartTask újrafut, még akkor is, ha a számítási csomópont nem lett újraindítva. Különös figyelmet kell fordítva arra, hogy elkerülje azokat a StartTaskokat, amelyek megszakító folyamatot hoznak létre, vagy szolgáltatásokat telepítenek/indítanak el a StartTask munkakönyvtárából, mivel ez megakadályozza, hogy a Batch újra futtathassa a StartTaskot.

BatchStartTaskInfo

Információk a számítási csomóponton futó StartTaskról.

BatchStartTaskState

BatchStartTaskState enums

BatchTaskContainerExecutionInfo

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

BatchTaskContainerSettings

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

BatchTaskExecutionInfo

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

BatchTaskExecutionResult

BatchTaskExecutionResult enums

BatchTaskFailureInfo

A feladathibával kapcsolatos információk.

BatchTaskInfo

Információk egy számítási csomóponton futó tevékenységről.

BatchTaskState

BatchTaskState enums

BatchVmImageReference

Egy Azure Virtual Machines Marketplace-rendszerképre vagy egy Azure Compute Gallery-rendszerképre mutató hivatkozás. Az Azure Marketplace-rendszerképek Azure Batch által ellenőrzött hivatkozásainak listájához tekintse meg a Támogatott képek listázása műveletet.

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

ElevationLevel

ElevationLevel enumok

EnvironmentSetting

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

InboundEndpoint

Egy számítási csomópont bejövő végpontja.

InboundEndpointProtocol

InboundEndpointProtocol enumok

NameValuePair

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

ResourceFile

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

SchedulingState

SchedulingState enums

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.

VirtualMachineInfo

Információ a virtuális gép aktuális állapotáról.

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.

BatchError

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

Name Típus Description
code

string

A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.

message

BatchErrorMessage

A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.

values

BatchErrorDetail[]

Kulcs-érték párok gyűjteménye, amelyek további részleteket tartalmaznak a hibáról.

BatchErrorDetail

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

Name Típus Description
key

string

Az Érték tulajdonság jelentését meghatározó azonosító.

value

string

A hibaválasz további információi.

BatchErrorMessage

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

Name Típus Description
lang

string

A hibaüzenet nyelvkódja.

value

string

Az üzenet szövege.

BatchErrorSourceCategory

BatchErrorSourceCategory enums

Érték Description
usererror

A hiba egy felhasználói probléma miatt van, például egy rossz konfiguráció miatt.

servererror

A hiba egy belső szerverprobléma miatt van.

BatchNode

Számítási csomópont a Batch szolgáltatásban.

Name Típus Description
affinityId

string

Egy olyan azonosító, amely átadható egy tevékenység hozzáadásakor, hogy a tevékenység ütemezve legyen ezen a számítási csomóponton. 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.

allocationTime

string (date-time)

A számítási csomópont készlethez való lefoglalásának időpontja. Ez az az idő, amikor a számítási csomópontot eredetileg lefoglalták, és a beállítás után nem változik. A számítási csomópont szervizelése vagy előkezelése nem frissül.

endpointConfiguration

BatchNodeEndpointConfiguration

A számítási csomópont végpontkonfigurációja.

errors

BatchNodeError[]

A számítási csomópont által jelenleg észlelt hibák listája.

id

string

A számítási csomópont azonosítója. A készlethez hozzáadott összes számítási csomóponthoz egyedi azonosító tartozik. Amikor egy számítási csomópontot eltávolít egy készletből, az összes helyi fájlja törlődik, és az azonosító vissza lesz kérve, és újra felhasználható az új számítási csomópontokhoz.

ipAddress

string

Az IP-cím, amellyel más csomópontok kommunikálhatnak ezzel a számítási csomóponttal. A készlethez hozzáadott összes számítási csomóponthoz egyedi IP-cím van hozzárendelve. Amikor eltávolít egy számítási csomópontot egy készletből, az összes helyi fájlja törlődik, és az IP-cím vissza lesz kérve, és újra felhasználható az új számítási csomópontokhoz.

ipv6Address

string

Az az IPv6-cím, amelyet más csomópontok használhatnak a számítási csomóponttal való kommunikációhoz. A készlethez hozzáadott összes számítási csomóponthoz egyedi IP-cím van hozzárendelve. Amikor eltávolít egy számítási csomópontot egy készletből, az összes helyi fájlja törlődik, és az IP-cím vissza lesz kérve, és újra felhasználható az új számítási csomópontokhoz. Ez a tulajdonság nem lesz jelen, ha a készlet nincs IPv6-ra konfigurálva.

isDedicated

boolean

Hogy ez a számítási csomópont dedikált számítási csomópont-e. Ha hamis, a számítási csomópont egy kihasználatlan/alacsony prioritású számítási csomópont.

lastBootTime

string (date-time)

Az utolsó időpont, amikor a számítási csomópont elindult. Előfordulhat, hogy ez a tulajdonság nem jelenik meg, ha a számítási csomópont állapota használhatatlan.

nodeAgentInfo

BatchNodeAgentInfo

Információk a Számítási csomópont ügynök verziójáról és a számítási csomópont új verzióra való frissítésének időpontjáról.

recentTasks

BatchTaskInfo[]

Azoknak a feladatoknak a listája, amelyek állapota nemrég módosult. Ez a tulajdonság csak akkor jelenik meg, ha legalább egy tevékenység fut ezen a számítási csomóponton a készlethez való hozzárendelése óta.

runningTaskSlotsCount

integer (int32)

A számítási csomóponton jelenleg futó feladatfeladatok által használt ütemezési pontok teljes száma. Ide tartoznak a Feladatkezelői feladatok és a normál tevékenységek, de a feladat-előkészítés, a feladatkiadás vagy a tevékenységek indítása nem.

runningTasksCount

integer (int32)

A számítási csomóponton jelenleg futó feladatfeladatok teljes száma. Ide tartoznak a Feladatkezelői feladatok és a normál tevékenységek, de a feladat-előkészítés, a feladatkiadás vagy a tevékenységek indítása nem.

schedulingState

SchedulingState

Azt jelzi, hogy a számítási csomópont elérhető-e a feladatütemezéshez.

startTask

BatchStartTask

A számítási csomóponton a készlethez való csatlakozáskor futtatandó feladat.

startTaskInfo

BatchStartTaskInfo

Futtatókörnyezeti információk a StartTask számítási csomóponton való végrehajtásáról.

state

BatchNodeState

A számítási csomópont aktuális állapota.

stateTransitionTime

string (date-time)

Az az időpont, amikor a számítási csomópont elérte az aktuális állapotát.

totalTasksRun

integer (int32)

A számítási csomóponton elvégzett feladatok teljes száma. Ide tartoznak a Feladatkezelői feladatok és a normál tevékenységek, de a feladat-előkészítés, a feladatkiadás vagy a tevékenységek indítása nem.

totalTasksSucceeded

integer (int32)

A számítási csomóponton sikeresen befejezett feladatfeladatok teljes száma (exitCode 0-val). Ide tartoznak a Feladatkezelői feladatok és a normál tevékenységek, de a feladat-előkészítés, a feladatkiadás vagy a tevékenységek indítása nem.

url

string (uri)

A számítási csomópont URL-címe.

virtualMachineInfo

VirtualMachineInfo

Információ a virtuális gép aktuális állapotáról.

vmSize

string

A számítási csomópontot üzemeltető virtuális gép mérete. A készletekben elérhető virtuális gépek méretéről további információt az Azure Batch-készletben (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes) található számítási csomópontok virtuálisgép-méretének kiválasztása című témakörben talál.

BatchNodeAgentInfo

A Batch számítási csomópont ügynök egy olyan program, amely a készlet minden számítási csomópontján fut, és Batch-képességet biztosít a számítási csomóponton.

Name Típus Description
lastUpdateTime

string (date-time)

Az az idő, amikor a Compute Node ügynök frissült a Compute Node-on. Ez volt a legutóbbi alkalom, hogy a Compute Node ügynököt új verzióra frissítették.

version

string

A Compute Node Batch Compute Node ügynök verziója, amely a Compute Node-on fut. Ez a verziószám ellenőrizhető a Compute Node ügynök kiadási jegyzeteivel szemben, amely a címen https://github.com/Azure/Batch/blob/master/changelogs/nodeagent/CHANGELOG.mdtalálható.

BatchNodeEndpointConfiguration

A számítási csomópont végpontkonfigurációja.

Name Típus Description
inboundEndpoints

InboundEndpoint[]

A Compute Node-on elérhető bejövő végpontok listája.

BatchNodeError

Egy számítási csomópont hibát észlelt.

Name Típus Description
code

string

Egy azonosító a Compute Node hibához. A kódok invariánsak, és programozott módon használhatók.

errorDetails

NameValuePair[]

A Compute Node hibához kapcsolódó további hibarészletek listája.

message

string

Egy üzenet, amely a Compute Node hibát írja le, és arra szánták, hogy felhasználói felületen jelenítse meg.

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.

BatchNodeListResult

A számítási csomópontok készletben való listázásának eredménye.

Name Típus Description
odata.nextLink

string (uri)

Az URL-cím a következő találatok lekéréséhez.

value

BatchNode[]

A Compute Node-ok listája.

BatchNodeState

BatchNodeState enumok

Érték Description
idle

A Compute Node jelenleg nem futtat Feladatot.

rebooting

A Compute Node újraindul.

reimaging

A Compute Node újraképzelése van.

running

A Compute Node egy vagy több feladatot futtat (a StartTask-en kívül).

unusable

A Compute Node hibák miatt nem használható feladat végrehajtására.

creating

A Batch szolgáltatás megszerezte az alapul szolgáló virtuális gépet az Azure Compute-ból, de még nem kezdte el csatlakozni a Poolhoz.

starting

A Batch szolgáltatás az alapul szolgáló virtuális gépen indul.

waitingforstarttask

A StartTask elkezdett futni a Compute Node-on, de a waitForSuccess be van állítva, és a StartTask még nem fejeződött be.

starttaskfailed

A StartTask meghibásodott a Compute Node-on (és minden próbálkozást kimerített), és a waitForSuccess beállított. A Compute Node nem használható Feladatok futtatására.

unknown

A Batch szolgáltatás elvesztette a kapcsolatot a Compute Node-val, és nem ismeri annak valódi állapotát.

leavingpool

A Compute Node elhagyja a Poolot, vagy azért, mert a felhasználó kifejezetten eltávolította, vagy mert a Pool méretezés vagy automatikusan leskálázik.

offline

A Compute Node jelenleg nem futtat Feladatot, és az új feladatok ütemezése a Compute Node-ba le van tiltva.

preempted

A kihasználatlan/alacsony prioritású számítási csomópont elő lett állítva. A számítási csomóponton az előkezeléskor futó feladatok újra lesznek ütemezve, amikor egy másik számítási csomópont elérhetővé válik.

upgradingos

A Compute Node operációs rendszer frissítési folyamaton megy.

deallocated

A Compute Node elérhető lett.

deallocating

A Compute Node dilopásokat végez.

BatchStartTask

A Batch újrapróbálkozza a feladatokat, ha egy helyreállítási művelet aktiválódik egy csomóponton. A helyreállítási műveletek közé tartoznak például (de nem kizárólagosan), ha egy nem megfelelő csomópont újraindul, vagy egy számítási csomópont a gazdagép hibája miatt eltűnt. A helyreállítási műveletek miatti újrapróbálkozások függetlenek a maxTaskRetryCount értékétől, és nem számítanak bele. Még ha a maxTaskRetryCount száma 0 is, belső újrapróbálkozhat egy helyreállítási művelet miatt. Emiatt minden tevékenységnek idempotensnek kell lennie. Ez azt jelenti, hogy a tevékenységeknek el kell viselnie a megszakítást és az újraindítást anélkül, hogy sérülést vagy duplikált adatokat okoznak. A hosszú ideig futó feladatok ajánlott eljárása az ellenőrzőpontok valamilyen formájának használata. Bizonyos esetekben előfordulhat, hogy a StartTask újrafut, még akkor is, ha a számítási csomópont nem lett újraindítva. Különös figyelmet kell fordítva arra, hogy elkerülje azokat a StartTaskokat, amelyek megszakító folyamatot hoznak létre, vagy szolgáltatásokat telepítenek/indítanak el a StartTask munkakönyvtárából, mivel ez megakadályozza, hogy a Batch újra futtathassa a StartTaskot.

Name Típus Description
commandLine

string

A StartTask parancssora. 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).

containerSettings

BatchTaskContainerSettings

A konténerre vonatkozó beállítások, amelyen a StartTask fut. 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.

environmentSettings

EnvironmentSetting[]

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

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. Vegye figyelembe, hogy ez az érték kifejezetten az újrapróbálkozések számát szabályozza. 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 az újrapróbálkozás maximális száma 0, a Batch szolgáltatás nem próbálkozik újra a feladattal. 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).

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. 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. Az elem alatt felsorolt fájlok a tevékenység munkakönyvtárában találhatók.

userIdentity

UserIdentity

Az a felhasználói azonosító, amely alatt a StartTask fut. Ha kihagyják, a feladat nem adminisztratív felhasználóként fut el, amely egyedi, a feladatra jellemző.

waitForSuccess

boolean

Várjon-e a Batch szolgáltatás, amíg a StartTask sikeresen befejeződik (azaz a 0-s kilépési kóddal lépjen ki) a számítási csomóponton lévő feladatok ütemezése előtt. Ha igaz, és a StartTask meghiúsul egy csomóponton, a Batch szolgáltatás a StartTaskot a maximális újrapróbálkozások számának (maxTaskRetryCount) értékére újrapróbálja. Ha a tevékenység az összes újrapróbálkozás után sem fejeződött be sikeresen, akkor a Batch szolgáltatás használhatatlanná teszi a csomópontot, és nem ütemezi a feladatokat. Ez a feltétel a számítási csomópont állapotán és a hibainformációkon keresztül észlelhető. Ha hamis, a Batch szolgáltatás nem várja meg a StartTask befejezését. Ebben az esetben más feladatok is elkezdhetik a végrehajtást a számítási csomóponton, amíg a StartTask még fut; És még ha a StartTask meghiúsul is, az új feladatok továbbra is ütemezve lesznek a számítási csomóponton. Az alapértelmezett érték igaz.

BatchStartTaskInfo

Információk a számítási csomóponton futó StartTaskról.

Name Típus Description
containerInfo

BatchTaskContainerExecutionInfo

Információ arról a konténerről, amelyben a feladat végrehajtódik. Ez a tulajdonság csak akkor van beállítva, ha a feladat konténerkontextusban fut.

endTime

string (date-time)

Az az idő, amikor a StartTask leállt. Ez a StartTask legutóbbi futásának végideje, ha az a futtatás befejeződött (még akkor is, ha az elindulás megbukott, és újrapróbálkozás vár rá). Ez az elem nincs jelen, ha a StartTask éppen fut.

exitCode

integer (int32)

A program kilépési kódja, amelyet a StartTask parancssoron jelöltek meg. Ez a tulajdonság csak akkor van beállítva, ha a StartTask befejezett állapotban van. Általánosságban a folyamat kilépési kódja tükrözi az alkalmazásfejlesztő által alkalmazott konvenciót az adott folyamatra. Ha a kilépési kód értéket használod döntések meghozatalához a kódodban, győződj meg róla, hogy ismered az alkalmazási folyamat által használt kilépési kód konvenciót. Azonban, ha a Batch szolgáltatás megszünteti a StartTask-et (időtúlzás vagy felhasználói leállás miatt az API-n keresztül), akkor operációs rendszer által definiált kilépési kódot láthatsz.

failureInfo

BatchTaskFailureInfo

Információ, amely leírja a feladat hibáját, ha egyáltalán van. Ez a tulajdonság csak akkor van beállítva, ha a feladat befejezett állapotban van, és hibát tapasztalt.

lastRetryTime

string (date-time)

A legutóbbi alkalom, amikor a Feladat újrapróbálkozása indult. Ez az elem csak akkor létezik, ha a feladatot újra próbálták (azaz a retryCount nem nulla). Ha jelen van, ez általában megegyezik a startTime-val, de eltérhet attól, ha a feladatot más okból újraindították, nem újrapróbálkozásból; például, ha a Compute Node-ot újraindították egy újrapróbálkozás során, akkor a startTime frissül, de az utolsó RetryTime nem.

result

BatchTaskExecutionResult

A feladat végrehajtásának eredménye. Ha az érték 'failed', akkor a hiba részletei megtalálhatók a failureInfo tulajdonságban.

retryCount

integer (int32)

Hányszor próbálták újra a feladatot a Batch szolgáltatás által. A feladatalkalmazás hibáit (nem nulla kijárati kód) újra próbálják, az előfeldolgozási hibákat (a feladatot nem lehetett futtatni) és fájlfeltöltési hibákat nem próbálják újra. A Batch szolgáltatás újra megpróbálja a feladatot a korlátok által meghatározott határig.

startTime

string (date-time)

Az az idő, amikor a StartTask elkezdett futni. Ez az érték minden alkalommal visszaállítódik, amikor a feladatot újraindítják vagy újra próbálják (azaz ez a legutóbbi alkalom, amikor a StartTask elkezdett futni).

state

BatchStartTaskState

A StartTask állapota a Compute Node-on.

BatchStartTaskState

BatchStartTaskState enums

Érték Description
running

A StartTask jelenleg fut.

completed

A StartTask 0-s kilépési kóddal lépett ki, vagy a StartTask meghibásodott és elérte az újrapróbálkozási korlátot, vagy a StartTask folyamat nem futott be feladat előkészítési hibák miatt (például erőforrásfájl-letöltési hibák).

BatchTaskContainerExecutionInfo

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

Name Típus Description
containerId

string

A tartály azonosítója.

error

string

Részletes hibainformációk a tartályról. Ez a Docker szolgáltatás részletes hibasorozata, ha elérhető. Ez ekvivalizálja a "docker inspect" által visszaadott hibamezőt.

state

string

A tartály állapota. Ez a konténer állapota a Docker szolgáltatás szerint. Ez egyenértékű a "docker inspect" által visszaadott állapotmezővel.

BatchTaskContainerSettings

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

Name Típus Description
containerHostBatchBindMounts

ContainerHostBatchBindMountEntry[]

A tárolófeladathoz csatlakoztatni kívánt elérési utak. Ha ez a tömb null értékű, vagy nincs jelen, a tárolófeladat a teljes ideiglenes lemezmeghajtót csatlakoztatja a Windowsban (vagy linuxos AZ_BATCH_NODE_ROOT_DIR). Ha ez a tömb üresként van beállítva, nem fog adatelérési utakat csatlakoztatni a tárolóhoz.

containerRunOptions

string

A tároló létrehozási parancsának további beállításai. Ezeket a további lehetőségeket argumentumként adja meg a "docker create" parancs, a Batch szolgáltatás által szabályozottakon kívül.

imageName

string

Az a kép, amit a konténernek létrehozhatunk, amelyben a feladat fut. Ez a teljes Image hivatkozás, ahogy a "docker pull" opció szerint is szerepel. Ha a képnév részeként nincs megadva címkét, akkor az alapértelmezett ":latest" címkét használják.

registry

ContainerRegistryReference

A privát regiszter, amely tartalmazza a konténert, az Image-t. Ezt a beállítást el lehet hagyni, ha már elérhető volt a Pool létrehozásánál.

workingDirectory

ContainerWorkingDirectory

A konténer Feladat munkakönyvtárának helye. Az alapértelmezett érték a "taskWorkingDirectory".

BatchTaskExecutionInfo

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

Name Típus Description
containerInfo

BatchTaskContainerExecutionInfo

Információ arról a konténerről, amelyben a feladat végrehajtódik. Ez a tulajdonság csak akkor van beállítva, ha a feladat konténerkontextusban fut.

endTime

string (date-time)

Az idő, amikor a Feladat befejeződött. Ez a tulajdonság csak akkor van beállítva, ha a feladat befejezett állapotban van.

exitCode

integer (int32)

A program kilépési kódja, amelyet a Feladat parancssorán jelöltek meg. Ez a tulajdonság csak akkor van beállítva, ha a feladat befejezett állapotban van. Általánosságban a folyamat kilépési kódja tükrözi az alkalmazásfejlesztő által alkalmazott konvenciót az adott folyamatra. Ha a kilépési kód értéket használod döntések meghozatalához a kódodban, győződj meg róla, hogy ismered az alkalmazási folyamat által használt kilépési kód konvenciót. Azonban, ha a Batch szolgáltatás megszünteti a Feladatot (időkorlát vagy a felhasználói végleállás miatt az API-n keresztül), akkor operációs rendszer által definiált kilépési kódot láthatsz.

failureInfo

BatchTaskFailureInfo

Információ, amely leírja a feladat hibáját, ha egyáltalán van. Ez a tulajdonság csak akkor van beállítva, ha a feladat befejezett állapotban van, és hibát tapasztalt.

lastRequeueTime

string (date-time)

A legutóbbi alkalom, amikor a Feladatot a Batch szolgáltatás újra sorba állította egy felhasználói kérés hatására. Ez a tulajdonság csak akkor van beállítva, ha a requeueCount nem nulla.

lastRetryTime

string (date-time)

A legutóbbi alkalom, amikor a Feladat újrapróbálkozása indult. Ez az elem csak akkor létezik, ha a feladatot újra próbálták (azaz a retryCount nem nulla). Ha jelen van, ez általában megegyezik a startTime-val, de eltérhet attól, ha a feladatot más okból újraindították, nem újrapróbálkozásból; például, ha a Compute Node-ot újraindították egy újrapróbálkozás során, akkor a startTime frissül, de az utolsó RetryTime nem.

requeueCount

integer (int32)

Hányszor sorolta újra a feladatot a Batch szolgáltatás egy felhasználói kérés hatására. Amikor a felhasználó eltávolítja a Compute Node-okat egy poolból (a pool méretének módosításával/zsugorításával), vagy amikor a Feladatot letiltják, a felhasználó beállíthatja, hogy a Compute Node-okon futó feladatokat újra sorba állítsák végrehajtásra. Ez a szám nyomon követi, hányszor sorolták újra a feladatot ezekből az okokból.

result

BatchTaskExecutionResult

A feladat végrehajtásának eredménye. Ha az érték 'failed', akkor a hiba részletei megtalálhatók a failureInfo tulajdonságban.

retryCount

integer (int32)

Hányszor próbálták újra a feladatot a Batch szolgáltatás által. A feladatalkalmazás hibáit (nem nulla kijárati kód) újra próbálják, az előfeldolgozási hibákat (a feladatot nem lehetett futtatni) és fájlfeltöltési hibákat nem próbálják újra. A Batch szolgáltatás újra megpróbálja a feladatot a korlátok által meghatározott határig.

startTime

string (date-time)

Az az idő, amikor a Feladat elkezdődött. A 'Running' megfelel a futó állapotnak, tehát ha a feladat megadja az erőforrásfájlokat vagy csomagokat, akkor a kezdeti idő azt az időpontot tükrözi, amikor a feladat elkezdte ezeket letölteni vagy telepíteni. Ha a Feladatot újraindították vagy újra próbálták, ez a legutóbbi alkalom, amikor a Feladat elkezdte futni. Ez a tulajdonság csak olyan feladatoknál érhető el, amelyek futó vagy befejezett állapotban vannak.

BatchTaskExecutionResult

BatchTaskExecutionResult enums

Érték Description
success

A feladat sikeresen futott.

failure

Hiba történt a feladat feldolgozása során. A hiba előfordulhatott a Feladat folyamat indítása előtt, a Feladat folyamat végrehajtása idején, vagy a Feladat kilépése után.

BatchTaskFailureInfo

A feladathibával kapcsolatos információk.

Name Típus Description
category

BatchErrorSourceCategory

A feladathiba kategóriája.

code

string

Egy azonosító a Feladat hibához. A kódok invariánsak, és programozott módon használhatók.

details

NameValuePair[]

További részletek listája a hibával kapcsolatban.

message

string

Egy üzenet, amely leírja a feladathibát, és alkalmas felhasználói felületen való megjelenítésre.

BatchTaskInfo

Információk egy számítási csomóponton futó tevékenységről.

Name Típus Description
executionInfo

BatchTaskExecutionInfo

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

jobId

string

Az a feladat azonosítója, amelyhez a feladat tartozik.

subtaskId

integer (int32)

Az alfeladat azonosítója, ha a feladat többpéldányos feladat.

taskId

string

A feladat azonosítója.

taskState

BatchTaskState

A Feladat jelenlegi állapota.

taskUrl

string (uri)

A feladat URL-je.

BatchTaskState

BatchTaskState enums

Érték Description
active

A feladat sorba van állítva és képes futni, de jelenleg nincs hozzárendelve Compute Node-hoz. Egy feladat akkor kerül ebbe az állapotba, amikor létrehozják, amikor kikapcsolták a letiltás után, vagy amikor egy sikertelen futtatás után újrapróbálkozásra vár.

preparing

A feladatot egy Compute Node-hoz rendelték, de várja a szükséges Feladatfelkészítő feladatot a Compute Node-on. Ha a Munkafelkészítő feladat sikeres lesz, a feladat futásba kerül. Ha a Feladat Előkészítő Feladat meghibásodik, a Feladat visszatér aktív állapotba, és jogosult lesz egy másik Számítási Csomóponthoz rendelni.

running

A feladat egy Compute Node-on fut. Ez magában foglalja a feladatszintű előkészületeket, például erőforrásfájlok letöltését vagy a feladaton meghatározott csomagok telepítését – ez nem feltétlenül jelenti azt, hogy a feladat parancssor elkezdte a futtatást.

completed

A feladat már nem jogosult futni, általában azért, mert a feladat sikeresen befejeződött, vagy sikertelenül fejezte be és kifogyott az újrapróbálkozási limit. A feladatot akkor is befejezettnek jelölik, ha hiba történt a Feladat indításakor, vagy amikor a feladatot megszüntették.

BatchVmImageReference

Egy Azure Virtual Machines Marketplace-rendszerképre vagy egy Azure Compute Gallery-rendszerképre mutató hivatkozás. Az Azure Marketplace-rendszerképek Azure Batch által ellenőrzött hivatkozásainak listájához tekintse meg a Támogatott képek listázása műveletet.

Name Típus Description
communityGalleryImageId

string

A közösségi galéria kép egyedi azonosítója. Ez a tulajdonság kölcsönösen kizárja a többi tulajdonságot, és lekérhető a közösségi katalógus képének GET hívásából.

exactVersion

string

A platform vagy piactéri kép konkrét verziója, amelyet a csomópont létrehozásához használnak. Ez az csak olvasható mező csak akkor különbözik a 'verzió'-tól, ha a pool létrehozásakor a 'verzió' értéke 'legfrissebb' volt.

offer

string

Az Azure Virtual Machines Marketplace Image ajánlattípusa. Például: UbuntuServer vagy WindowsServer.

publisher

string

Az Azure Virtual Machines Marketplace Image kiadója. Például a Canonical vagy a MicrosoftWindowsServer.

sharedGalleryImageId

string

A megosztott galériakép egyedi azonosítója. Ez a tulajdonság kölcsönösen kizárja a többi tulajdonságot, és lekérhető a megosztott katalógus képének GET hívásából.

sku

string

Az Azure Virtual Machines Marketplace Image SKU-ja. Például: 18.04-LTS vagy 2019-Datacenter.

version

string

Az Azure Virtual Machines Marketplace Image verziója. A 'legfrissebb' érték megadható a legfrissebb kép kiválasztásához. Ha nincs megadva, az alapértelmezett érték a "legújabb".

virtualMachineImageId

string (arm-id)

Az Azure Compute Gallery rendszerképének ARM-erőforrás-azonosítója. A Pool Compute Node-jai ezzel az Image ID használatával készülnek. Ez a /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} vagy /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} formátumban van, így mindig a legfrissebb képverziót használjuk. Ez a tulajdonság kölcsönösen kizárja a többi ImageReference tulajdonságot. Az Azure Compute Galéria Képnek ugyanabban a régióban kell replikája legyen, és ugyanabban az előfizetésben kell lennie, mint az Azure Batch fiók. Ha az imageId verziója nincs megadva, akkor a legfrissebb verziót használják. A Batch Compute Node ügynök tűzfal beállításairól a Batch szolgáltatással való kommunikációhoz lásd: https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration.

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.

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.

InboundEndpoint

Egy számítási csomópont bejövő végpontja.

Name Típus Description
backendPort

integer (int32)

A végpont backend portszáma.

frontendPort

integer (int32)

A végpont nyilvános portszáma.

name

string

A végpont neve.

protocol

InboundEndpointProtocol

A végpont protokollja.

publicFQDN

string

A Compute Node számára a nyilvános, teljesen minősített domain név.

publicIPAddress

string

A Compute Node nyilvános IP-címe.

InboundEndpointProtocol

InboundEndpointProtocol enumok

Érték Description
tcp

Használja a TCP-t a végponthoz.

udp

Használja az UDP-t a végponthoz.

NameValuePair

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

Name Típus Description
name

string

A név a név-érték párban.

value

string

Az érték a név-érték párban.

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.

SchedulingState

SchedulingState enums

Érték Description
enabled

A feladatok ütemezhetők a Compute Node-on.

disabled

A Compute Node-on nem lesznek új feladatok ütemezve. A Compute Node-on már futó feladatok még mindig befejeződhetnek. Minden Compute Node az ütemezés engedélyezve indul.

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.

VirtualMachineInfo

Információ a virtuális gép aktuális állapotáról.

Name Típus Description
imageReference

BatchVmImageReference

Az Azure Virtual Machine Marketplace Image-re való hivatkozás.

scaleSetVmResourceId

string

A Compute Node jelenlegi Virtual Machine Scale Set VM erőforrásazonosítója. Csak akkor van meghatározva, ha a Batch Account a poolAllocationMode tulajdonsága 'UserSubscription' lett beállítva.