Nodes - List Nodes

Service:: Batch Service

API-versie:: 2025-06-01

Geeft een lijst van de rekenknooppunten in de gespecificeerde pool.

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

Met optionele parameters:

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

URI-parameters

Name	In	Vereist	Type	Description
endpoint	path	True	string (uri)	Batch-accounteindpunt (bijvoorbeeld: https://batchaccount.eastus2.batch.azure.com).
poolId	path	True	string	De ID van de pool waaruit je Compute Nodes wilt vermelden.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.
$filter	query		string	Een OData-$filter-component. Voor meer informatie over het construeren van dit filter, zie https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-nodes-in-a-pool.
$select	query		string[]	Een OData-$select-component.
maxresults	query		integer (int32) minimum: 1 maximum: 1000	Het maximum aantal items dat moet worden geretourneerd in het antwoord. Maximaal 1000 aanvragen kunnen worden teruggestuurd.
timeOut	query		integer (int32)	De maximale tijd die de server kan besteden aan het verwerken van de aanvraag, in seconden. De standaardwaarde is 30 seconden. Als de waarde groter is dan 30, wordt de standaard in plaats daarvan gebruikt."

Aanvraagkoptekst

Name	Type	Description
client-request-id	string	De door de aanroeper gegenereerde aanvraagidentiteit, in de vorm van een GUID zonder decoratie, zoals accolades, bijvoorbeeld 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Of de server de clientaanvraag-id in het antwoord moet retourneren.
ocp-date	string (date-time-rfc7231)	Het tijdstip waarop de aanvraag is uitgegeven. Clientbibliotheken stellen dit doorgaans in op de huidige kloktijd van het systeem; stel deze expliciet in als u de REST API rechtstreeks aanroept.

Antwoorden

Name	Type	Description
200 OK	BatchNodeListResult	De aanvraag is voltooid. Kopteksten ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Een onverwachte foutreactie.

Name

Type

Description

200 OK

BatchNodeListResult

De aanvraag is voltooid.

Kopteksten

ETag: string
Last-Modified: string
client-request-id: string
request-id: string

Other Status Codes

BatchError

Een onverwachte foutreactie.

Beveiliging

OAuth2Auth

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiken

Name	Description
https://batch.core.windows.net//.default

Voorbeelden

Node list

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:: 200

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

Definities

Name	Description
AutoUserScope	AutoUserScope enums
AutoUserSpecification	Hiermee geeft u de opties voor de automatische gebruiker die een Azure Batch-taak uitvoert.
BatchError	Er is een foutbericht ontvangen van de Azure Batch-service.
BatchErrorDetail	Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie.
BatchErrorMessage	Een foutbericht dat is ontvangen in een Azure Batch-foutreactie.
BatchErrorSourceCategory	BatchErrorSourceCategory-enums
BatchNode	Een rekenknooppunt in de Batch-service.
BatchNodeAgentInfo	De Batch Compute Node-agent is een programma dat wordt uitgevoerd op elk rekenknooppunt in de pool en biedt Batch-mogelijkheden op het rekenknooppunt.
BatchNodeEndpointConfiguration	De eindpuntconfiguratie voor het rekenknooppunt.
BatchNodeError	Er is een fout opgetreden door een rekenknooppunt.
BatchNodeIdentityReference	De verwijzing naar een door de gebruiker toegewezen identiteit die is gekoppeld aan de Batch-pool die door een rekenknooppunt wordt gebruikt.
BatchNodeListResult	Het resultaat van het weergeven van de rekenknooppunten in een pool.
BatchNodeState	BatchNodeState-enums
BatchStartTask	Batch voert taken opnieuw uit wanneer een herstelbewerking wordt geactiveerd op een knooppunt. Voorbeelden van herstelbewerkingen zijn (maar zijn niet beperkt tot) wanneer een beschadigd knooppunt opnieuw wordt opgestart of een rekenknooppunt is verdwenen vanwege een hostfout. Nieuwe pogingen vanwege herstelbewerkingen zijn onafhankelijk van en worden niet meegeteld voor maxTaskRetryCount. Zelfs als maxTaskRetryCount 0 is, kan er een interne nieuwe poging worden uitgevoerd vanwege een herstelbewerking. Daarom moeten alle taken idempotent zijn. Dit betekent dat taken moeten worden onderbroken en opnieuw moeten worden gestart zonder beschadiging of dubbele gegevens te veroorzaken. De aanbevolen procedure voor langlopende taken is om een vorm van controlepunten te gebruiken. In sommige gevallen kan de StartTask opnieuw worden uitgevoerd, ook al is het rekenknooppunt niet opnieuw opgestart. Er moet speciale aandacht worden besteed aan het voorkomen van StartTasks die een breakaway-proces maken of services installeren/starten vanuit de werkmap StartTask, omdat hierdoor Batch niet meer in staat is om de StartTask opnieuw uit te voeren.
BatchStartTaskInfo	Informatie over een StartTask die wordt uitgevoerd op een rekenknooppunt.
BatchStartTaskState	BatchStartTaskState enums
BatchTaskContainerExecutionInfo	Bevat informatie over de container die een taak uitvoert.
BatchTaskContainerSettings	De containerinstellingen voor een taak.
BatchTaskExecutionInfo	Informatie over de uitvoering van een taak.
BatchTaskExecutionResult	BatchTaskExecutionResult enums
BatchTaskFailureInfo	Informatie over een taakfout.
BatchTaskInfo	Informatie over een taak die wordt uitgevoerd op een rekenknooppunt.
BatchTaskState	BatchTaskState-enums
BatchVmImageReference	Een verwijzing naar een Azure Virtual Machines Marketplace-installatiekopieën of een Azure Compute Gallery-installatiekopieën. Zie de bewerking 'Lijst met ondersteunde installatiekopieën' voor alle Azure Marketplace-installatiekopieën die zijn geverifieerd door Azure Batch.
ContainerHostBatchBindMountEntry	De vermelding van het pad en de koppelingsmodus die u wilt koppelen aan de taakcontainer.
ContainerHostDataPath	De paden die worden gekoppeld aan de container van de containertaak.
ContainerRegistryReference	Een privécontainerregister.
ContainerWorkingDirectory	ContainerWorkingDirectory-enums
ElevationLevel	ElevationLevel-enums
EnvironmentSetting	Een omgevingsvariabele die moet worden ingesteld voor een taakproces.
InboundEndpoint	Een binnenkomend eindpunt op een rekenknooppunt.
InboundEndpointProtocol	InboundEndpointProtocol enums
NameValuePair	Vertegenwoordigt een naam-waardepaar.
ResourceFile	Eén bestand of meerdere bestanden die moeten worden gedownload naar een rekenknooppunt.
SchedulingState	Planning Staat-enums
UserIdentity	De definitie van de gebruikersidentiteit waaronder de taak wordt uitgevoerd. Geef de eigenschap userName of autoUser op, maar niet beide.
VirtualMachineInfo	Informatie over de huidige status van de virtuele machine.

AutoUserScope

Opsomming

AutoUserScope enums

Waarde	Description
task	Geeft aan dat de dienst een nieuwe gebruiker voor de Taak moet aanmaken.
pool	Specificeert dat de Taak draait als het gemeenschappelijke automatische gebruikersaccount dat op elke rekenknoop in een pool wordt aangemaakt.

AutoUserSpecification

Object

Hiermee geeft u de opties voor de automatische gebruiker die een Azure Batch-taak uitvoert.

Name	Type	Description
elevationLevel	ElevationLevel	Het hoogteniveau van de automatische gebruiker. De standaardwaarde is nietAdmin.
scope	AutoUserScope	Het bereik voor de automatische gebruiker. De standaardwaarde is pool. Als de pool Windows uitvoert, moet een waarde van Taak worden opgegeven als strengere isolatie tussen taken vereist is. Bijvoorbeeld als de taak het register muteert op een manier die van invloed kan zijn op andere taken.

BatchError

Object

Er is een foutbericht ontvangen van de Azure Batch-service.

Name	Type	Description
code	string	Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.
message	BatchErrorMessage	Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.
values	BatchErrorDetail[]	Een verzameling sleutel-waardeparen met aanvullende informatie over de fout.

BatchErrorDetail

Object

Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie.

Name	Type	Description
key	string	Een id die de betekenis van de eigenschap Waarde aangeeft.
value	string	De aanvullende informatie die is opgenomen in het foutbericht.

BatchErrorMessage

Object

Een foutbericht dat is ontvangen in een Azure Batch-foutreactie.

Name	Type	Description
lang	string	De taalcode van het foutbericht.
value	string	De tekst van het bericht.

BatchErrorSourceCategory

Opsomming

BatchErrorSourceCategory-enums

Waarde	Description
usererror	De fout is het gevolg van een gebruikersprobleem, zoals een verkeerde configuratie.
servererror	De fout komt door een intern serverprobleem.

BatchNode

Object

Een rekenknooppunt in de Batch-service.

Name	Type	Description
affinityId	string	Een id die kan worden doorgegeven bij het toevoegen van een taak om aan te vragen of de taak op dit rekenknooppunt moet worden gepland. Houd er rekening mee dat dit slechts een zachte affiniteit is. Als het doel-rekenknooppunt bezet is of niet beschikbaar is op het moment dat de taak is gepland, wordt de taak elders gepland.
allocationTime	string (date-time)	Het tijdstip waarop dit rekenknooppunt is toegewezen aan de pool. Dit is het moment waarop het rekenknooppunt in eerste instantie is toegewezen en niet eenmaal wordt gewijzigd. Het wordt niet bijgewerkt wanneer de rekenknooppuntservice is hersteld of wordt verschoven.
endpointConfiguration	BatchNodeEndpointConfiguration	De eindpuntconfiguratie voor het rekenknooppunt.
errors	BatchNodeError[]	De lijst met fouten die momenteel worden aangetroffen door het rekenknooppunt.
id	string	De id van het rekenknooppunt. Aan elk rekenknooppunt dat aan een pool wordt toegevoegd, wordt een unieke id toegewezen. Wanneer een rekenknooppunt uit een pool wordt verwijderd, worden alle lokale bestanden ervan verwijderd en wordt de id vrijgemaakt en kan deze opnieuw worden gebruikt voor nieuwe rekenknooppunten.
ipAddress	string	Het IP-adres dat andere knooppunten kunnen gebruiken om te communiceren met dit rekenknooppunt. Aan elk rekenknooppunt dat aan een pool wordt toegevoegd, wordt een uniek IP-adres toegewezen. Wanneer een rekenknooppunt uit een pool wordt verwijderd, worden alle lokale bestanden verwijderd en wordt het IP-adres vrijgemaakt en kan het opnieuw worden gebruikt voor nieuwe rekenknooppunten.
ipv6Address	string	Het IPv6-adres dat andere Nodes kunnen gebruiken om met deze Compute Node te communiceren. Aan elk rekenknooppunt dat aan een pool wordt toegevoegd, wordt een uniek IP-adres toegewezen. Wanneer een rekenknooppunt uit een pool wordt verwijderd, worden alle lokale bestanden verwijderd en wordt het IP-adres vrijgemaakt en kan het opnieuw worden gebruikt voor nieuwe rekenknooppunten. Deze eigenschap is niet aanwezig als de pool niet is geconfigureerd voor IPv6.
isDedicated	boolean	Of dit rekenknooppunt een toegewezen rekenknooppunt is. Als dit onwaar is, is het rekenknooppunt een rekenknooppunt met een spot-/lage prioriteit.
lastBootTime	string (date-time)	De laatste keer dat het rekenknooppunt is gestart. Deze eigenschap is mogelijk niet aanwezig als de status van het rekenknooppunt onbruikbaar is.
nodeAgentInfo	BatchNodeAgentInfo	Informatie over de versie van de Compute Node-agent en de tijd waarop het rekenknooppunt is bijgewerkt naar een nieuwe versie.
recentTasks	BatchTaskInfo[]	Een lijst met taken waarvan de status onlangs is gewijzigd. Deze eigenschap is alleen aanwezig als ten minste één taak op dit rekenknooppunt is uitgevoerd sinds deze is toegewezen aan de pool.
runningTaskSlotsCount	integer (int32)	Het totale aantal planningssites dat momenteel wordt gebruikt door taaktaken uit te voeren op het rekenknooppunt. Dit omvat Job Manager-taken en normale taken, maar niet jobvoorbereiding, jobrelease of begintaken.
runningTasksCount	integer (int32)	Het totale aantal taaktaken dat momenteel wordt uitgevoerd op het rekenknooppunt. Dit omvat Job Manager-taken en normale taken, maar niet jobvoorbereiding, jobrelease of begintaken.
schedulingState	SchedulingState	Of het rekenknooppunt beschikbaar is voor taakplanning.
startTask	BatchStartTask	De taak die moet worden uitgevoerd op het rekenknooppunt terwijl deze lid wordt van de pool.
startTaskInfo	BatchStartTaskInfo	Runtime-informatie over de uitvoering van de StartTask op het rekenknooppunt.
state	BatchNodeState	De huidige status van het rekenknooppunt.
stateTransitionTime	string (date-time)	Het tijdstip waarop het rekenknooppunt de huidige status heeft ingevoerd.
totalTasksRun	integer (int32)	Het totale aantal taaktaken dat is voltooid op het rekenknooppunt. Dit omvat Job Manager-taken en normale taken, maar niet jobvoorbereiding, jobrelease of begintaken.
totalTasksSucceeded	integer (int32)	Het totale aantal taaktaken dat is voltooid (met exitCode 0) op het rekenknooppunt. Dit omvat Job Manager-taken en normale taken, maar niet jobvoorbereiding, jobrelease of begintaken.
url	string (uri)	De URL van het rekenknooppunt.
virtualMachineInfo	VirtualMachineInfo	Informatie over de huidige status van de virtuele machine.
vmSize	string	De grootte van de virtuele machine die als host fungeert voor het rekenknooppunt. Zie Een VM-grootte kiezen voor rekenknooppunten in een Azure Batch-pool (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes) voor informatie over de beschikbare grootten van virtuele machines in pools.

BatchNodeAgentInfo

Object

De Batch Compute Node-agent is een programma dat wordt uitgevoerd op elk rekenknooppunt in de pool en biedt Batch-mogelijkheden op het rekenknooppunt.

Name	Type	Description
lastUpdateTime	string (date-time)	De tijd waarop de Compute Node-agent werd bijgewerkt op de Compute Node. Dit is de meest recente keer dat de Compute Node-agent werd bijgewerkt naar een nieuwe versie.
version	string	De versie van de Batch Compute Node-agent die op de Compute Node draait. Dit versienummer kan worden gecontroleerd met de Compute Node-agent-releasenotities die zich vinden op https://github.com/Azure/Batch/blob/master/changelogs/nodeagent/CHANGELOG.md.

BatchNodeEndpointConfiguration

Object

De eindpuntconfiguratie voor het rekenknooppunt.

Name	Type	Description
inboundEndpoints	InboundEndpoint[]	De lijst van inkomende eindpunten die toegankelijk zijn op de Compute Node.

BatchNodeError

Object

Er is een fout opgetreden door een rekenknooppunt.

Name	Type	Description
code	string	Een identificatie voor de Compute Node-fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.
errorDetails	NameValuePair[]	De lijst met aanvullende foutgegevens gerelateerd aan de Compute Node-fout.
message	string	Een bericht dat de Compute Node-fout beschrijft, bedoeld om geschikt te zijn voor weergave in een gebruikersinterface.

BatchNodeIdentityReference

Object

De verwijzing naar een door de gebruiker toegewezen identiteit die is gekoppeld aan de Batch-pool die door een rekenknooppunt wordt gebruikt.

Name	Type	Description
resourceId	string (arm-id)	De ARM-resource-id van de door de gebruiker toegewezen identiteit.

BatchNodeListResult

Object

Het resultaat van het weergeven van de rekenknooppunten in een pool.

Name	Type	Description
odata.nextLink	string (uri)	De URL om de volgende reeks resultaten te krijgen.
value	BatchNode[]	De lijst van rekenknooppunten.

BatchNodeState

Opsomming

BatchNodeState-enums

Waarde	Description
idle	De Compute Node voert momenteel geen Task uit.
rebooting	De Compute Node wordt opnieuw opgestart.
reimaging	De Compute Node is aan het herimagingen.
running	De Compute Node voert een of meer Tasks uit (anders dan een StartTask).
unusable	De Compute Node kan niet worden gebruikt voor taakuitvoering vanwege fouten.
creating	De Batch-service heeft de onderliggende virtuele machine verkregen van Azure Compute, maar is nog niet begonnen met het joinen van de Pool.
starting	De Batch-service start op de onderliggende virtuele machine.
waitingforstarttask	De StartTask is begonnen met draaien op de Compute Node, maar waitForSuccess is ingesteld en de StartTask is nog niet voltooid.
starttaskfailed	De StartTask is mislukt op de Compute Node (en heeft alle pogingen uitgeput), en waitForSuccess is ingesteld. De Compute Node is niet bruikbaar voor het uitvoeren van taken.
unknown	De Batch-service is het contact met de Compute Node verloren en kent de werkelijke toestand niet.
leavingpool	De Compute Node verlaat de Pool, hetzij omdat de gebruiker hem expliciet heeft verwijderd, hetzij omdat de Pool de grootte vergroot of automatisch verkleint.
offline	De Compute Node draait momenteel geen Task, en het plannen van nieuwe Tasks naar de Compute Node is uitgeschakeld.
preempted	Het rekenknooppunt met spot-/lage prioriteit is afgewend. Taken die werden uitgevoerd op het rekenknooppunt toen het werd uitgesteld, worden opnieuw gepland wanneer er een ander rekenknooppunt beschikbaar komt.
upgradingos	De Compute Node ondergaat een OS-upgrade.
deallocated	De Compute Node wordt gedeald.
deallocating	De Compute Node wordt gedealloceerd.

BatchStartTask

Object

Batch voert taken opnieuw uit wanneer een herstelbewerking wordt geactiveerd op een knooppunt. Voorbeelden van herstelbewerkingen zijn (maar zijn niet beperkt tot) wanneer een beschadigd knooppunt opnieuw wordt opgestart of een rekenknooppunt is verdwenen vanwege een hostfout. Nieuwe pogingen vanwege herstelbewerkingen zijn onafhankelijk van en worden niet meegeteld voor maxTaskRetryCount. Zelfs als maxTaskRetryCount 0 is, kan er een interne nieuwe poging worden uitgevoerd vanwege een herstelbewerking. Daarom moeten alle taken idempotent zijn. Dit betekent dat taken moeten worden onderbroken en opnieuw moeten worden gestart zonder beschadiging of dubbele gegevens te veroorzaken. De aanbevolen procedure voor langlopende taken is om een vorm van controlepunten te gebruiken. In sommige gevallen kan de StartTask opnieuw worden uitgevoerd, ook al is het rekenknooppunt niet opnieuw opgestart. Er moet speciale aandacht worden besteed aan het voorkomen van StartTasks die een breakaway-proces maken of services installeren/starten vanuit de werkmap StartTask, omdat hierdoor Batch niet meer in staat is om de StartTask opnieuw uit te voeren.

Name	Type	Description
commandLine	string	De opdrachtregel van de StartTask. De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shell-functies zoals uitbreiding van omgevingsvariabelen. Als u van dergelijke functies wilt profiteren, moet u de shell aanroepen op de opdrachtregel, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux. Als de opdrachtregel verwijst naar bestandspaden, moet deze een relatief pad gebruiken (ten opzichte van de werkmap Taak) of de door Batch geleverde omgevingsvariabele (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
containerSettings	BatchTaskContainerSettings	De instellingen voor de container waaronder de StartTask draait. Wanneer dit wordt gespecificeerd, worden alle directories recursief onder de AZ_BATCH_NODE_ROOT_DIR (de wortel van Azure Batch-directories op de node) in de container toegewezen, worden alle Task-omgevingsvariabelen in de container gemapt en wordt de Task-opdrachtregel uitgevoerd in de container. Bestanden die buiten AZ_BATCH_NODE_ROOT_DIR in de container worden geproduceerd, worden mogelijk niet teruggespiegeld naar de hostdisk, wat betekent dat Batch-bestands-API's geen toegang tot die bestanden hebben.
environmentSettings	EnvironmentSetting[]	Een lijst met omgevingsvariabele-instellingen voor de StartTask.
maxTaskRetryCount	integer (int32)	Het maximum aantal keren dat de taak opnieuw kan worden geprobeerd. De Batch-service probeert een taak opnieuw uit te voeren als de afsluitcode niet-nul is. Houd er rekening mee dat deze waarde specifiek het aantal nieuwe pogingen bepaalt. De Batch-service probeert de taak eenmaal uit en probeert vervolgens opnieuw tot deze limiet. Als het maximumaantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch de taak maximaal 4 keer (één eerste poging en drie nieuwe pogingen). Als het maximumaantal nieuwe pogingen 0 is, voert de Batch-service de taak niet opnieuw uit. Als het maximumaantal nieuwe pogingen -1 is, probeert de Batch-service de taak opnieuw zonder limiet, maar dit wordt niet aanbevolen voor een begintaak of een andere taak. De standaardwaarde is 0 (geen nieuwe pogingen).
resourceFiles	ResourceFile[]	Een lijst met bestanden die de Batch-service naar het rekenknooppunt downloadt voordat u de opdrachtregel uitvoert. Er is een maximale grootte voor de lijst met resourcebestanden. Wanneer de maximale grootte wordt overschreden, mislukt de aanvraag en is de antwoordfoutcode RequestEntityTooLarge. Als dit het geval is, moet de verzameling ResourceFiles worden verkleind. Dit kan worden bereikt met behulp van .zip bestanden, toepassingspakketten of Docker-containers. Bestanden die onder dit element worden vermeld, bevinden zich in de werkmap van de taak.
userIdentity	UserIdentity	De gebruikersidentiteit waaronder de StartTask draait. Als deze wordt weggelaten, draait de taak als een niet-administratieve gebruiker die uniek is voor de taak.
waitForSuccess	boolean	Of de Batch-service moet wachten tot de StartTask is voltooid (dat wil gezegd: afsluiten met afsluitcode 0) voordat taken op het rekenknooppunt worden gepland. Indien waar en starttask mislukt op een knooppunt, probeert de Batch-service de StartTask opnieuw uit te voeren tot het maximumaantal nieuwe pogingen (maxTaskRetryCount). Als de taak na alle nieuwe pogingen nog steeds niet is voltooid, markeert de Batch-service het knooppunt onbruikbaar en plant deze niet. Deze voorwaarde kan worden gedetecteerd via de details van de status en foutgegevens van het rekenknooppunt. Als dit onwaar is, wacht de Batch-service niet tot de StartTask is voltooid. In dit geval kunnen andere taken worden uitgevoerd op het rekenknooppunt terwijl de StartTask nog steeds wordt uitgevoerd; en zelfs als de StartTask mislukt, worden nieuwe taken nog steeds gepland op het rekenknooppunt. De standaardwaarde is waar.

BatchStartTaskInfo

Object

Informatie over een StartTask die wordt uitgevoerd op een rekenknooppunt.

Name	Type	Description
containerInfo	BatchTaskContainerExecutionInfo	Informatie over de container waaronder de Taak wordt uitgevoerd. Deze eigenschap wordt alleen ingesteld als de Task in een containercontext draait.
endTime	string (date-time)	Het tijdstip waarop de StartTask stopte met draaien. Dit is het eindtijdstip van de meest recente run van de StartTask, als die run is voltooid (zelfs als die run mislukte en een herpoging in behandeling is). Dit element is niet aanwezig als StartTask momenteel draait.
exitCode	integer (int32)	De exitcode van het programma die is gespecificeerd op de StartTask-opdrachtregel. Deze eigenschap wordt alleen ingesteld als de StartTask zich in de voltooide toestand bevindt. In het algemeen weerspiegelt de exitcode van een proces de specifieke conventie die door de applicatieontwikkelaar voor dat proces is geïmplementeerd. Als je de exitcodewaarde gebruikt om beslissingen te nemen in je code, zorg er dan voor dat je de exitcodeconventie kent die door het applicatieproces wordt gebruikt. Als de Batch-service echter de StartTask beëindigt (vanwege time-out of gebruikersbeëindiging via de API), kun je een door het besturingssysteem gedefinieerde exitcode zien.
failureInfo	BatchTaskFailureInfo	Informatie die de taakfaling beschrijft, indien aanwezig. Deze eigenschap wordt alleen ingesteld als de Taak zich in de voltooide toestand bevindt en een storing ondervindt.
lastRetryTime	string (date-time)	De meest recente keer dat een herpoging van de Taak begon te lopen. Dit element is alleen aanwezig als de Taak opnieuw is geprobeerd (d.w.z. retryCount is niet nul). Als aanwezig, is dit meestal hetzelfde als startTime, maar kan anders zijn als de Taak om andere redenen dan opnieuw proberen is herstart; bijvoorbeeld, als de Compute Node tijdens een herpoging opnieuw is opgestart, wordt startTime bijgewerkt maar de lastRetryTime niet.
result	BatchTaskExecutionResult	Het resultaat van de uitvoering van de taak. Als de waarde 'failed' is, kunnen de details van de failure worden gevonden in de failureInfo-eigenschap.
retryCount	integer (int32)	Het aantal keren dat de Taak opnieuw is geprobeerd door de Batch-service. Fouten bij taakapplicaties (niet-nul exitcode) worden opnieuw geprobeerd, preprocessingfouten (de taak kon niet worden uitgevoerd) en fouten bij het uploaden van bestanden worden niet opnieuw geprobeerd. De Batch-service zal de taak opnieuw proberen tot aan de limiet die door de beperkingen is gespecificeerd.
startTime	string (date-time)	Het moment waarop de StartTask begon te draaien. Deze waarde wordt gereset telkens wanneer de Taak opnieuw wordt gestart of opnieuw geprobeerd (dat wil zeggen, dit is de meest recente keer waarop de StartTask begon te draaien).
state	BatchStartTaskState	De status van de StartTask op de Compute Node.

BatchStartTaskState

Opsomming

BatchStartTaskState enums

Waarde	Description
running	De StartTask draait momenteel.
completed	De StartTask is afgesloten met exitcode 0, of de StartTask is mislukt en de herkansingslimiet is bereikt, of het StartTask-proces is niet uitgevoerd vanwege fouten in de taakvoorbereiding (zoals het downloaden van resourcebestanden).

BatchTaskContainerExecutionInfo

Object

Bevat informatie over de container die een taak uitvoert.

Name	Type	Description
containerId	string	De ID van de container.
error	string	Gedetailleerde foutinformatie over de container. Dit is de gedetailleerde foutreeks van de Docker-service, indien beschikbaar. Het is equivalent aan het foutveld dat door "docker inspect" wordt teruggegeven.
state	string	De staat van de container. Dit is de staat van de container volgens de Docker-service. Het is gelijkwaardig aan het statusveld dat door "docker inspect" wordt teruggegeven.

BatchTaskContainerSettings

Object

De containerinstellingen voor een taak.

Name	Type	Description
containerHostBatchBindMounts	ContainerHostBatchBindMountEntry[]	De paden die u aan de containertaak wilt koppelen. Als deze matrix null is of niet aanwezig is, koppelt de containertaak een volledig tijdelijk schijfstation in Windows (of AZ_BATCH_NODE_ROOT_DIR in Linux). Er worden geen gegevenspaden in de container geplaatst als deze matrix is ingesteld als leeg.
containerRunOptions	string	Aanvullende opties voor de opdracht container maken. Deze extra opties worden geleverd als argumenten voor de opdracht Docker create, naast de opties die worden beheerd door de Batch-service.
imageName	string	De image die gebruikt moet worden om de container te maken waarin de taak zal draaien. Dit is de volledige afbeeldingsreferentie, zoals gespecificeerd bij "docker pull". Als er geen tag in de afbeeldingsnaam wordt vermeld, wordt de tag ":latest" standaard gebruikt.
registry	ContainerRegistryReference	Het privéregister dat de containerafbeelding bevat. Deze instelling kan worden weggelaten als deze al bij het aanmaken van het zwembad was aangegeven.
workingDirectory	ContainerWorkingDirectory	De locatie van de container Task werkdirectory. De standaardwaarde is taskWorkingDirectory.

BatchTaskExecutionInfo

Object

Informatie over de uitvoering van een taak.

Name	Type	Description
containerInfo	BatchTaskContainerExecutionInfo	Informatie over de container waaronder de Taak wordt uitgevoerd. Deze eigenschap wordt alleen ingesteld als de Task in een containercontext draait.
endTime	string (date-time)	Het tijdstip waarop de Taak werd voltooid. Deze eigenschap wordt alleen ingesteld als de Taak zich in de Voltooide toestand bevindt.
exitCode	integer (int32)	De exitcode van het programma is gespecificeerd in de opdrachtregel Task. Deze eigenschap wordt alleen ingesteld als de Taak in de voltooide toestand is. In het algemeen weerspiegelt de exitcode van een proces de specifieke conventie die door de applicatieontwikkelaar voor dat proces is geïmplementeerd. Als je de exitcodewaarde gebruikt om beslissingen te nemen in je code, zorg er dan voor dat je de exitcodeconventie kent die door het applicatieproces wordt gebruikt. Als de batchservice echter de taak beëindigt (vanwege time-out of gebruikersbeëindiging via de API), kun je een door het besturingssysteem gedefinieerde exitcode zien.
failureInfo	BatchTaskFailureInfo	Informatie die de taakfaling beschrijft, indien aanwezig. Deze eigenschap wordt alleen ingesteld als de Taak zich in de voltooide toestand bevindt en een storing ondervindt.
lastRequeueTime	string (date-time)	De meest recente keer waarop de Task opnieuw in de rij is geplaatst door de Batch-service als gevolg van een gebruikersverzoek. Deze eigenschap wordt alleen ingesteld als de requeueCount niet nul is.
lastRetryTime	string (date-time)	De meest recente keer dat een herpoging van de Taak begon te lopen. Dit element is alleen aanwezig als de Taak opnieuw is geprobeerd (d.w.z. retryCount is niet nul). Als aanwezig, is dit meestal hetzelfde als startTime, maar kan anders zijn als de Taak om andere redenen dan opnieuw proberen is herstart; bijvoorbeeld, als de Compute Node tijdens een herpoging opnieuw is opgestart, wordt startTime bijgewerkt maar de lastRetryTime niet.
requeueCount	integer (int32)	Het aantal keren dat de Taak opnieuw in de wachtrij is geplaatst door de Batch-service als gevolg van een gebruikersverzoek. Wanneer de gebruiker rekenknooppunten uit een pool verwijdert (door de pool te verkleinen/te verkleinen) of wanneer de taak wordt uitgeschakeld, kan de gebruiker specificeren dat uitvoerende taken op de rekenknooppunten opnieuw in de wachtrij worden geplaatst voor uitvoering. Deze telling houdt bij hoe vaak de Taak om deze redenen opnieuw in de rij is geplaatst.
result	BatchTaskExecutionResult	Het resultaat van de uitvoering van de taak. Als de waarde 'failed' is, kunnen de details van de failure worden gevonden in de failureInfo-eigenschap.
retryCount	integer (int32)	Het aantal keren dat de Taak opnieuw is geprobeerd door de Batch-service. Fouten bij taakapplicaties (niet-nul exitcode) worden opnieuw geprobeerd, preprocessingfouten (de taak kon niet worden uitgevoerd) en fouten bij het uploaden van bestanden worden niet opnieuw geprobeerd. De Batch-service zal de taak opnieuw proberen tot aan de limiet die door de beperkingen is gespecificeerd.
startTime	string (date-time)	Het tijdstip waarop de Taak begon te lopen. 'Running' komt overeen met de loopstatus, dus als de Task resourcebestanden of pakketten specificeert, weerspiegelt de starttijd het moment waarop de Task begon met downloaden of uitrollen hiervan. Als de Taak opnieuw is gestart of opnieuw geprobeerd, is dit de meest recente keer dat de Taak is begonnen. Deze eigenschap is alleen aanwezig voor taken die in de running of voltooide toestand zijn.

BatchTaskExecutionResult

Opsomming

BatchTaskExecutionResult enums

Waarde	Description
success	De Task liep succesvol.
failure	Er was een fout tijdens de verwerking van de Taak. De storing kan zijn opgetreden voordat het Taakproces werd gestart, terwijl het Taakproces werd uitgevoerd, of nadat het Taakproces was afgesloten.

BatchTaskFailureInfo

Object

Informatie over een taakfout.

Name	Type	Description
category	BatchErrorSourceCategory	De categorie van de taakfout.
code	string	Een identificatie voor de Taakfout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.
details	NameValuePair[]	Een lijst met aanvullende details gerelateerd aan de fout.
message	string	Een bericht dat de Taakfout beschrijft, bedoeld om geschikt te zijn voor weergave in een gebruikersinterface.

BatchTaskInfo

Object

Informatie over een taak die wordt uitgevoerd op een rekenknooppunt.

Name	Type	Description
executionInfo	BatchTaskExecutionInfo	Informatie over de uitvoering van de taak.
jobId	string	De ID van de Taak waartoe de Taak behoort.
subtaskId	integer (int32)	De ID van de subtaak als de taak een multi-instance taak is.
taskId	string	De ID van de taak.
taskState	BatchTaskState	De huidige staat van de Taak.
taskUrl	string (uri)	De URL van de taak.

BatchTaskState

Opsomming

BatchTaskState-enums

Waarde	Description
active	De Task staat in de wachtrij en kan worden uitgevoerd, maar is momenteel niet toegewezen aan een Compute Node. Een taak komt in deze toestand wanneer deze wordt aangemaakt, wanneer hij wordt ingeschakeld na het uitschakelen, of wanneer hij wacht op een herpoging na een mislukte uitvoering.
preparing	De taak is toegewezen aan een rekenknooppunt, maar wacht op een vereiste taakvoorbereidingstaak op de rekenknoop. Als de taak voor taakvoorbereiding slaagt, gaat de taak over naar het uitvoeren. Als de taak voorbereidingstaak faalt, keert de taak terug naar actief en komt in aanmerking om aan een andere rekenknoop toegewezen te worden.
running	De taak draait op een rekenknooppunt. Dit omvat taakniveauvoorbereiding, zoals het downloaden van resourcebestanden of het uitrollen van pakketten die op de taak zijn gespecificeerd – het betekent niet noodzakelijk dat de opdrachtregel van de taak al is begonnen met uitvoeren.
completed	De taak is niet langer bevoegd om uit te voeren, meestal omdat de taak succesvol is voltooid, of omdat de taak zonder succes is voltooid en zijn herkansingslimiet is uitgeput. Een taak wordt ook als voltooid gemarkeerd als er een fout is opgetreden bij het starten van de taak, of wanneer de taak is beëindigd.

BatchVmImageReference

Object

Een verwijzing naar een Azure Virtual Machines Marketplace-installatiekopieën of een Azure Compute Gallery-installatiekopieën. Zie de bewerking 'Lijst met ondersteunde installatiekopieën' voor alle Azure Marketplace-installatiekopieën die zijn geverifieerd door Azure Batch.

Name	Type	Description
communityGalleryImageId	string	De unieke identificatie van de afbeelding in de communitygalerij. Deze eigenschap is wederzijds exclusief met andere eigenschappen en kan worden opgehaald uit de get-aanroep van de communitygalerieafbeelding.
exactVersion	string	De specifieke versie van het platformimage of marktplaats image die is gebruikt om de node te maken. Dit alleen-lezen veld verschilt van 'versie' alleen als de waarde die voor 'versie' werd gespecificeerd toen de pool werd aangemaakt 'laatste' was.
offer	string	Het aanbiedingstype van de Azure Virtual Machines Marketplace Image. Bijvoorbeeld UbuntuServer of WindowsServer.
publisher	string	De uitgever van de Azure Virtual Machines Marketplace Image. Bijvoorbeeld Canonical of MicrosoftWindowsServer.
sharedGalleryImageId	string	De unieke identificatie van de gedeelde galerijafbeelding. Deze eigenschap is wederzijds exclusief met andere eigenschappen en kan worden opgehaald uit de get-aanroep van de installatiekopieën in de gedeelde galerie.
sku	string	De SKU van de Azure Virtual Machines Marketplace Image. Bijvoorbeeld 18.04-LTS of 2019-Datacenter.
version	string	De versie van de Azure Virtual Machines Marketplace Image. Een waarde van 'laatste' kan worden opgegeven om de nieuwste versie van een Image te selecteren. Als u dit weglaat, is de standaardwaarde 'nieuwste'.
virtualMachineImageId	string (arm-id)	De ARM-resource-id van de installatiekopieën van de Azure Compute Gallery. Compute Nodes in de pool worden aangemaakt met deze Image Id. Dit is de vorm /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} of /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} om altijd standaard te kiezen voor de nieuwste afbeeldingsversie. Deze eigenschap sluit elkaar uit met andere ImageReference-eigenschappen. De Azure Compute Gallery Image moet replica's in dezelfde regio hebben en moet in hetzelfde abonnement zitten als het Azure Batch-account. Als de afbeeldingsversie niet is gespecificeerd in de imageId, wordt de nieuwste versie gebruikt. Voor informatie over de firewallinstellingen voor de Batch Compute Node-agent om met de Batch-service te communiceren, zie https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration.

ContainerHostBatchBindMountEntry

Object

De vermelding van het pad en de koppelingsmodus die u wilt koppelen aan de taakcontainer.

Name	Type	Description
isReadOnly	boolean	Koppel dit bronpad als alleen-lezenmodus of niet. De standaardwaarde is onwaar (lees-/schrijfmodus). Als u voor Linux dit pad koppelt als een lees-/schrijfmodus, betekent dit niet dat alle gebruikers in de container de lees-/schrijftoegang voor het pad hebben, afhankelijk van de toegang in de host-VM. Als dit pad is gekoppeld met het kenmerk Alleen-lezen, kunnen alle gebruikers in de container het pad niet wijzigen.
source	ContainerHostDataPath	Het pad dat aan de containerklant wordt gekoppeld, kan worden geselecteerd.

ContainerHostDataPath

Opsomming

De paden die worden gekoppeld aan de container van de containertaak.

Waarde	Description
Shared	Het pad voor de taak met meerdere exemplaren om hun bestanden te delen.
Startup	Het pad voor de begintaak.
VfsMounts	Het pad bevat alle virtuele bestandssystemen die op dit knooppunt zijn gekoppeld.
Task	Het taakpad.
JobPrep	Het taakpad voor de taakvoorbereiding.
Applications	Het pad naar toepassingen.

ContainerRegistryReference

Object

Een privécontainerregister.

Name	Type	Description
identityReference	BatchNodeIdentityReference	De verwijzing naar de door de gebruiker toegewezen identiteit die moet worden gebruikt voor toegang tot een Azure Container Registry in plaats van een gebruikersnaam en wachtwoord.
password	string (password)	Het wachtwoord om u aan te melden bij de registerserver.
registryServer	string (uri)	De register-URL. Als u dit weglaat, is de standaardwaarde 'docker.io'.
username	string	De gebruikersnaam om u aan te melden bij de registerserver.

ContainerWorkingDirectory

Opsomming

ContainerWorkingDirectory-enums

Waarde	Description
taskWorkingDirectory	Gebruik de standaard Batch-service Taakwerkmap, die de Taakresourcebestanden bevat die door Batch worden ingevuld met Batch.
containerImageDefault	Gebruik de werkmap die is gedefinieerd in de container Image. Let op: deze map bevat niet de door batch gedownloade Resource Files.

ElevationLevel

Opsomming

ElevationLevel-enums

Waarde	Description
nonadmin	De gebruiker is een standaardgebruiker zonder verhoogde toegang.
admin	De gebruiker is een gebruiker met verhoogde toegang en werkt met volledige beheerdersmachtigingen.

EnvironmentSetting

Object

Een omgevingsvariabele die moet worden ingesteld voor een taakproces.

Name	Type	Description
name	string	De naam van de omgevingsvariabele.
value	string	De waarde van de omgevingsvariabele.

InboundEndpoint

Object

Een binnenkomend eindpunt op een rekenknooppunt.

Name	Type	Description
backendPort	integer (int32)	Het backend-poortnummer van het eindpunt.
frontendPort	integer (int32)	Het publieke poortnummer van het eindpunt.
name	string	De naam van het eindpunt.
protocol	InboundEndpointProtocol	Het protocol van het eindpunt.
publicFQDN	string	De publieke, volledig gekwalificeerde domeinnaam voor de Compute Node.
publicIPAddress	string	Het publieke IP-adres van de Compute Node.

InboundEndpointProtocol

Opsomming

InboundEndpointProtocol enums

Waarde	Description
tcp	Gebruik TCP voor het eindpunt.
udp	Gebruik UDP voor het eindpunt.

NameValuePair

Object

Vertegenwoordigt een naam-waardepaar.

Name	Type	Description
name	string	De naam in het naam-waarde-paar.
value	string	De waarde in het naam-waarde-paar.

ResourceFile

Object

Eén bestand of meerdere bestanden die moeten worden gedownload naar een rekenknooppunt.

Name	Type	Description
autoStorageContainerName	string	De naam van de opslagcontainer in het automatische opslagaccount. De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar wederzijds uit en een van deze moet worden opgegeven.
blobPrefix	string	Het blobvoorvoegsel dat moet worden gebruikt bij het downloaden van blobs uit een Azure Storage-container. Alleen de blobs waarvan de namen beginnen met het opgegeven voorvoegsel, worden gedownload. De eigenschap is alleen geldig wanneer autoStorageContainerName of storageContainerUrl wordt gebruikt. Dit voorvoegsel kan een gedeeltelijke bestandsnaam of een submap zijn. Als er geen voorvoegsel is opgegeven, worden alle bestanden in de container gedownload.
fileMode	string	Het kenmerk bestandsmachtigingsmodus in octale indeling. Deze eigenschap geldt alleen voor bestanden die worden gedownload naar Linux Compute Nodes. Het wordt genegeerd als het wordt gespecificeerd voor een resourceFile dat wordt gedownload naar een Windows Compute Node. Als deze eigenschap niet is gespecificeerd voor een Linux Compute Node, wordt een standaardwaarde van 0770 op het bestand toegepast.
filePath	string	De locatie op de Compute Node waar het bestand(en) naartoe gedownload moet worden, ten opzichte van de werkmap van de Taak. Als de eigenschap httpUrl is opgegeven, is het filePath vereist en wordt het pad beschreven waarnaar het bestand wordt gedownload, inclusief de bestandsnaam. Als anders de eigenschap autoStorageContainerName of storageContainerUrl is opgegeven, is filePath optioneel en is het de map waarin de bestanden moeten worden gedownload. In het geval dat filePath wordt gebruikt als map, wordt elke mapstructuur die al aan de invoergegevens is gekoppeld, volledig bewaard en toegevoegd aan de opgegeven filePath-map. Het opgegeven relatieve pad kan niet uit de werkmap van de Taak ontsnappen (bijvoorbeeld door '..' te gebruiken).
httpUrl	string (uri)	De URL van het bestand dat u wilt downloaden. De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar wederzijds uit en een van deze moet worden opgegeven. Als de URL verwijst naar Azure Blob Storage, moet deze leesbaar zijn vanuit rekenknooppunten. Er zijn drie manieren om een dergelijke URL op te halen voor een blob in Azure Storage: neem een SAS (Shared Access Signature) die leesmachtigingen voor de blob verleent, gebruik een beheerde identiteit met leesmachtigingen of stel de ACL voor de blob of de container in om openbare toegang toe te staan.
identityReference	BatchNodeIdentityReference	De verwijzing naar de door de gebruiker toegewezen identiteit om toegang te krijgen tot Azure Blob Storage, gespecificeerd door storageContainerUrl of httpUrl.
storageContainerUrl	string (uri)	De URL van de blobcontainer in Azure Blob Storage. De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar wederzijds uit en een van deze moet worden opgegeven. Deze URL moet kunnen worden gelezen en vermeld vanuit rekenknooppunten. Er zijn drie manieren om een dergelijke URL op te halen voor een container in Azure Storage: neem een SAS (Shared Access Signature) op die lees- en lijstmachtigingen voor de container verleent, gebruik een beheerde identiteit met lees- en lijstmachtigingen of stel de ACL voor de container in om openbare toegang toe te staan.

SchedulingState

Opsomming

Planning Staat-enums

Waarde	Description
enabled	Taken kunnen worden gepland op de Compute Node.
disabled	Er worden geen nieuwe taken gepland op de Compute Node. Taken die al op de Compute Node draaien, kunnen nog steeds tot voltooiing draaien. Alle rekenknopen beginnen met planning ingeschakeld.

UserIdentity

Object

De definitie van de gebruikersidentiteit waaronder de taak wordt uitgevoerd. Geef de eigenschap userName of autoUser op, maar niet beide.

Name	Type	Description
autoUser	AutoUserSpecification	De automatische gebruiker waaronder de taak wordt uitgevoerd. De eigenschappen userName en autoUser sluiten elkaar wederzijds uit; u moet één, maar niet beide opgeven.
username	string	De naam van de gebruikersidentiteit waaronder de taak wordt uitgevoerd. De eigenschappen userName en autoUser sluiten elkaar wederzijds uit; u moet één, maar niet beide opgeven.

VirtualMachineInfo

Object

Informatie over de huidige status van de virtuele machine.

Name	Type	Description
imageReference	BatchVmImageReference	De verwijzing naar het Marketplace Image van de Azure Virtual Machine.
scaleSetVmResourceId	string	De resource ID van de huidige Virtual Machine Scale Set VM van de Compute Node. Alleen gedefinieerd als het Batch-account is aangemaakt met de poolAllocationMode-eigenschap ingesteld op 'UserSubscription'.

Delen via

Nodes - List Nodes

URI-parameters

Aanvraagkoptekst

Antwoorden

Beveiliging

OAuth2Auth

Bereiken

Voorbeelden

Node list

Voorbeeldaanvraag

Voorbeeldrespons

Definities

AutoUserScope

AutoUserSpecification

BatchError

BatchErrorDetail

BatchErrorMessage

BatchErrorSourceCategory

BatchNode

BatchNodeAgentInfo

BatchNodeEndpointConfiguration

BatchNodeError

BatchNodeIdentityReference

BatchNodeListResult

BatchNodeState

BatchStartTask

BatchStartTaskInfo

BatchStartTaskState

BatchTaskContainerExecutionInfo

BatchTaskContainerSettings

BatchTaskExecutionInfo

BatchTaskExecutionResult

BatchTaskFailureInfo

BatchTaskInfo

BatchTaskState

BatchVmImageReference

ContainerHostBatchBindMountEntry

ContainerHostDataPath

ContainerRegistryReference

ContainerWorkingDirectory

ElevationLevel

EnvironmentSetting

InboundEndpoint

InboundEndpointProtocol

NameValuePair

ResourceFile

SchedulingState

UserIdentity

VirtualMachineInfo