Nodes - List Nodes

Servizio:: Batch Service

Versione API:: 2025-06-01

Elenca i nodi di calcolo nel pool specificato.

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string (uri)	Endpoint dell'account Batch (ad esempio: https://batchaccount.eastus2.batch.azure.com).
poolId	path	True	string	L'ID del Pool da cui vuoi elencare i Nodi di Calcolo.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
$filter	query		string	Clausola di $filter OData. Per maggiori informazioni sulla costruzione di questo filtro, vedi https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-nodes-in-a-pool.
$select	query		string[]	Clausola di $select OData.
maxresults	query		integer (int32) minimum: 1 maximum: 1000	Numero massimo di elementi da restituire nella risposta. Possono essere restituite un massimo di 1000 domande.
timeOut	query		integer (int32)	Tempo massimo di elaborazione della richiesta da parte del server, espresso in secondi. Il valore predefinito è 30 secondi. Se il valore è superiore a 30, verrà utilizzato il valore predefinito.".

Intestazione della richiesta

Nome	Tipo	Descrizione
client-request-id	string	Identità della richiesta generata dal chiamante, sotto forma di GUID senza decorazioni come parentesi graffe, ad esempio 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Indica se il server deve restituire l'ID richiesta client nella risposta.
ocp-date	string (date-time-rfc7231)	Ora di emissione della richiesta. Le librerie client in genere impostano questo valore sull'ora corrente dell'orologio di sistema; impostarla in modo esplicito se si chiama direttamente l'API REST.

Risposte

Nome	Tipo	Descrizione
200 OK	BatchNodeListResult	La richiesta ha avuto esito positivo. Intestazioni ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Risposta di errore imprevista.

Nome

Tipo

Descrizione

200 OK

BatchNodeListResult

La richiesta ha avuto esito positivo.

Intestazioni

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

Other Status Codes

BatchError

Risposta di errore imprevista.

Sicurezza

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Ambiti

Nome	Descrizione
https://batch.core.windows.net//.default

Esempio

Node list

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 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"
      }
    }
  ]
}

Definizioni

Nome	Descrizione
AutoUserScope	Enum AutoUserScope
AutoUserSpecification	Specifica le opzioni per l'utente automatico che esegue un'attività di Azure Batch.
BatchError	Risposta di errore ricevuta dal servizio Azure Batch.
BatchErrorDetail	Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch.
BatchErrorMessage	Messaggio di errore ricevuto in una risposta di errore di Azure Batch.
BatchErrorSourceCategory	BatchErrorSourceCategory enum
BatchNode	Nodo di calcolo nel servizio Batch.
BatchNodeAgentInfo	L'agente del nodo di calcolo batch è un programma che viene eseguito in ogni nodo di calcolo nel pool e offre funzionalità Batch nel nodo di calcolo.
BatchNodeEndpointConfiguration	Configurazione dell'endpoint per il nodo di calcolo.
BatchNodeError	Errore rilevato da un nodo di calcolo.
BatchNodeIdentityReference	Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo.
BatchNodeListResult	Risultato dell'elenco dei nodi di calcolo in un pool.
BatchNodeState	Enum BatchNodeState
BatchStartTask	Batch ritenta attività quando viene attivata un'operazione di ripristino in un nodo. Esempi di operazioni di ripristino includono (ma non sono limitati a) quando un nodo non integro viene riavviato o un nodo di calcolo è scomparso a causa di un errore dell'host. I tentativi dovuti alle operazioni di ripristino sono indipendenti da e non vengono conteggiati in base a maxTaskRetryCount. Anche se maxTaskRetryCount è 0, può verificarsi un nuovo tentativo interno a causa di un'operazione di ripristino. Per questo motivo, tutte le attività devono essere idempotenti. Ciò significa che le attività devono tollerare l'interruzione e il riavvio senza causare alcun danneggiamento o dati duplicati. La procedura consigliata per le attività a esecuzione prolungata consiste nell'usare una forma di checkpoint. In alcuni casi startTask può essere eseguito di nuovo anche se il nodo di calcolo non è stato riavviato. Prestare particolare attenzione per evitare StartTasks che creano processi di interruzione o installano/avviano i servizi dalla directory di lavoro StartTask, in quanto questo impedisce a Batch di essere in grado di eseguire nuovamente StartTask.
BatchStartTaskInfo	Informazioni su startTask in esecuzione in un nodo di calcolo.
BatchStartTaskState	Enum di BatchStartTaskState
BatchTaskContainerExecutionInfo	Contiene informazioni sul contenitore in cui è in esecuzione un'attività.
BatchTaskContainerSettings	Impostazioni del contenitore per un'attività.
BatchTaskExecutionInfo	Informazioni sull'esecuzione di un'attività.
BatchTaskExecutionResult	Enum BatchTaskExecutionResult
BatchTaskFailureInfo	Informazioni su un errore di attività.
BatchTaskInfo	Informazioni su un'attività in esecuzione in un nodo di calcolo.
BatchTaskState	Enum di BatchTaskState
BatchVmImageReference	Riferimento a un'immagine del Marketplace di macchine virtuali di Azure o a un'immagine della raccolta di calcolo di Azure. Per ottenere l'elenco di tutti i riferimenti alle immagini di Azure Marketplace verificati da Azure Batch, vedere l'operazione "Elenca immagini supportate".
ContainerHostBatchBindMountEntry	Voce di percorso e modalità di montaggio da montare nel contenitore di attività.
ContainerHostDataPath	Percorsi che verranno montati nel contenitore dell'attività contenitore.
ContainerRegistryReference	Registro contenitori privato.
ContainerWorkingDirectory	ContainerWorkingDirectory enums
ElevationLevel	Enum di ElevationLevel
EnvironmentSetting	Variabile di ambiente da impostare in un processo task.
InboundEndpoint	Endpoint in ingresso in un nodo di calcolo.
InboundEndpointProtocol	InboundEndpointProtocol enums
NameValuePair	Rappresenta una coppia nome-valore.
ResourceFile	Un singolo file o più file da scaricare in un nodo di calcolo.
SchedulingState	ProgrammazioneElenco degli Status
UserIdentity	Definizione dell'identità utente in cui viene eseguita l'attività. Specificare la proprietà userName o autoUser, ma non entrambe.
VirtualMachineInfo	Informazioni sullo stato corrente della macchina virtuale.

AutoUserScope

Enumerazione

Enum AutoUserScope

Valore	Descrizione
task	Specifica che il servizio dovrebbe creare un nuovo utente per il Task.
pool	Specifica che il Task viene eseguito come il comune account utente automatico creato su ogni Nodo di Calcolo in un Pool.

AutoUserSpecification

Oggetto

Specifica le opzioni per l'utente automatico che esegue un'attività di Azure Batch.

Nome	Tipo	Descrizione
elevationLevel	ElevationLevel	Livello di elevazione dell'utente automatico. Il valore predefinito è nonAdmin.
scope	AutoUserScope	Ambito dell'utente automatico. Il valore predefinito è pool. Se il pool esegue Windows, è necessario specificare il valore Task se è necessario un isolamento più rigoroso tra le attività. Ad esempio, se l'attività modifica il Registro di sistema in un modo che potrebbe influire su altre attività.

BatchError

Oggetto

Risposta di errore ricevuta dal servizio Azure Batch.

Nome	Tipo	Descrizione
code	string	Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.
message	BatchErrorMessage	Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.
values	BatchErrorDetail[]	Raccolta di coppie chiave-valore contenenti dettagli aggiuntivi sull'errore.

BatchErrorDetail

Oggetto

Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch.

Nome	Tipo	Descrizione
key	string	Identificatore che specifica il significato della proprietà Value.
value	string	Informazioni aggiuntive incluse nella risposta di errore.

BatchErrorMessage

Oggetto

Messaggio di errore ricevuto in una risposta di errore di Azure Batch.

Nome	Tipo	Descrizione
lang	string	Il codice linguistico del messaggio di errore.
value	string	Testo del messaggio.

BatchErrorSourceCategory

Enumerazione

BatchErrorSourceCategory enum

Valore	Descrizione
usererror	L'errore è dovuto a un problema dell'utente, come una configurazione errata (cattiva configurazione).
servererror	L'errore è dovuto a un problema interno del server.

BatchNode

Oggetto

Nodo di calcolo nel servizio Batch.

Nome	Tipo	Descrizione
affinityId	string	Identificatore che può essere passato quando si aggiunge un'attività per richiedere che l'attività sia pianificata in questo nodo di calcolo. Si noti che si tratta solo di un'affinità soft. Se il nodo di calcolo di destinazione è occupato o non è disponibile al momento della pianificazione dell'attività, l'attività verrà pianificata altrove.
allocationTime	string (date-time)	Ora in cui questo nodo di calcolo è stato allocato al pool. Questo è il momento in cui il nodo di calcolo è stato inizialmente allocato e non cambia una volta impostato. Non viene aggiornato quando il nodo di calcolo viene guarito o interrotto.
endpointConfiguration	BatchNodeEndpointConfiguration	Configurazione dell'endpoint per il nodo di calcolo.
errors	BatchNodeError[]	Elenco degli errori attualmente rilevati dal nodo di calcolo.
id	string	ID del nodo di calcolo. A ogni nodo di calcolo aggiunto a un pool viene assegnato un ID univoco. Ogni volta che un nodo di calcolo viene rimosso da un pool, tutti i relativi file locali vengono eliminati e l'ID viene recuperato e può essere riutilizzato per i nuovi nodi di calcolo.
ipAddress	string	Indirizzo IP che altri nodi possono usare per comunicare con questo nodo di calcolo. A ogni nodo di calcolo aggiunto a un pool viene assegnato un indirizzo IP univoco. Ogni volta che un nodo di calcolo viene rimosso da un pool, tutti i relativi file locali vengono eliminati e l'indirizzo IP viene recuperato e può essere riutilizzato per i nuovi nodi di calcolo.
ipv6Address	string	L'indirizzo IPv6 che gli altri nodi possono utilizzare per comunicare con questo nodo di calcolo. A ogni nodo di calcolo aggiunto a un pool viene assegnato un indirizzo IP univoco. Ogni volta che un nodo di calcolo viene rimosso da un pool, tutti i relativi file locali vengono eliminati e l'indirizzo IP viene recuperato e può essere riutilizzato per i nuovi nodi di calcolo. Questa proprietà non sarà presente se il pool non è configurato per IPv6.
isDedicated	boolean	Indica se questo nodo di calcolo è un nodo di calcolo dedicato. Se false, il nodo di calcolo è un nodo di calcolo spot/con priorità bassa.
lastBootTime	string (date-time)	Ultima volta in cui è stato avviato il nodo di calcolo. Questa proprietà potrebbe non essere presente se lo stato del nodo di calcolo non è utilizzabile.
nodeAgentInfo	BatchNodeAgentInfo	Informazioni sulla versione dell'agente del nodo di calcolo e sull'ora in cui il nodo di calcolo è stato aggiornato a una nuova versione.
recentTasks	BatchTaskInfo[]	Elenco di attività il cui stato è stato modificato di recente. Questa proprietà è presente solo se almeno un'attività è stata eseguita in questo nodo di calcolo perché è stata assegnata al pool.
runningTaskSlotsCount	integer (int32)	Numero totale di slot di pianificazione usati attualmente eseguendo attività di processo nel nodo di calcolo. Sono incluse le attività di Job Manager e le normali attività, ma non la preparazione del processo, il rilascio del processo o le attività di avvio.
runningTasksCount	integer (int32)	Numero totale di attività di processo attualmente in esecuzione nel nodo di calcolo. Sono incluse le attività di Job Manager e le normali attività, ma non la preparazione del processo, il rilascio del processo o le attività di avvio.
schedulingState	SchedulingState	Indica se il nodo di calcolo è disponibile per la pianificazione delle attività.
startTask	BatchStartTask	L'attività specificata per l'esecuzione nel nodo di calcolo durante l'aggiunta al pool.
startTaskInfo	BatchStartTaskInfo	Informazioni di runtime sull'esecuzione di StartTask nel nodo di calcolo.
state	BatchNodeState	Stato corrente del nodo di calcolo.
stateTransitionTime	string (date-time)	Ora in cui il nodo di calcolo ha immesso lo stato corrente.
totalTasksRun	integer (int32)	Numero totale di attività di processo completate nel nodo di calcolo. Sono incluse le attività di Job Manager e le normali attività, ma non la preparazione del processo, il rilascio del processo o le attività di avvio.
totalTasksSucceeded	integer (int32)	Numero totale di attività di processo completate correttamente (con exitCode 0) nel nodo di calcolo. Sono incluse le attività di Job Manager e le normali attività, ma non la preparazione del processo, il rilascio del processo o le attività di avvio.
url	string (uri)	URL del nodo di calcolo.
virtualMachineInfo	VirtualMachineInfo	Informazioni sullo stato corrente della macchina virtuale.
vmSize	string	Dimensioni della macchina virtuale che ospita il nodo di calcolo. Per informazioni sulle dimensioni disponibili delle macchine virtuali nei pool, vedere Scegliere una dimensione di macchina virtuale per i nodi di calcolo in un pool di Azure Batch (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes).

BatchNodeAgentInfo

Oggetto

L'agente del nodo di calcolo batch è un programma che viene eseguito in ogni nodo di calcolo nel pool e offre funzionalità Batch nel nodo di calcolo.

Nome	Tipo	Descrizione
lastUpdateTime	string (date-time)	Il momento in cui l'agente del Nodo di Calcolo veniva aggiornato sul Nodo di Calcolo. Questa è l'ultima volta che l'agente Compute Node è stato aggiornato a una nuova versione.
version	string	La versione dell'agente Batch Compute Node che gira sul Compute Node. Questo numero di versione può essere confrontato con le note di rilascio dell'agente Compute Node situate su https://github.com/Azure/Batch/blob/master/changelogs/nodeagent/CHANGELOG.md.

BatchNodeEndpointConfiguration

Oggetto

Configurazione dell'endpoint per il nodo di calcolo.

Nome	Tipo	Descrizione
inboundEndpoints	InboundEndpoint[]	L'elenco degli endpoint in entrata accessibili sul Nodo di Calcolo.

BatchNodeError

Oggetto

Errore rilevato da un nodo di calcolo.

Nome	Tipo	Descrizione
code	string	Un identificatore per l'errore Compute Node. I codici sono invarianti e devono essere utilizzati a livello di codice.
errorDetails	NameValuePair[]	L'elenco dei dettagli aggiuntivi sull'errore relativi all'errore del nodo di calcolo.
message	string	Un messaggio che descrive l'errore Compute Node, pensato per essere adatto alla visualizzazione in un'interfaccia utente.

BatchNodeIdentityReference

Oggetto

Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo.

Nome	Tipo	Descrizione
resourceId	string (arm-id)	ID risorsa ARM dell'identità assegnata dall'utente.

BatchNodeListResult

Oggetto

Risultato dell'elenco dei nodi di calcolo in un pool.

Nome	Tipo	Descrizione
odata.nextLink	string (uri)	L'URL per ottenere il set di risultati successivo.
value	BatchNode[]	L'elenco dei Nodi di Calcolo.

BatchNodeState

Enumerazione

Enum BatchNodeState

Valore	Descrizione
idle	Il Nodo di Calcolo attualmente non sta eseguendo un Task.
rebooting	Il Nodo di Calcolo si sta riavviando.
reimaging	Il Nodo di Calcolo sta rielaborando la visuale.
running	Il Nodo di Calcolo sta eseguendo uno o più Task (diversi da un StartTask).
unusable	Il Nodo di Calcolo non può essere utilizzato per l'esecuzione del compito a causa di errori.
creating	Il servizio Batch ha ottenuto la macchina virtuale sottostante da Azure Compute, ma non ha ancora iniziato a unirsi al Pool.
starting	Il servizio batch si avvia sulla macchina virtuale sottostante.
waitingforstarttask	StartTask ha iniziato a funzionare sul Nodo di Calcolo, ma waitForSuccess è impostato e il StartTask non è ancora stato completato.
starttaskfailed	L'StartTask ha fallito sul Nodo di Calcolo (ed ha esaurito tutti i tentativi), e waitForSuccess è impostato. Il Nodo di Calcolo non è utilizzabile per eseguire Task.
unknown	Il servizio Batch ha perso il contatto con il Nodo di Calcolo e non ne conosce il vero stato.
leavingpool	Il Nodo di Calcolo sta lasciando il Pool, o perché l'utente lo ha esplicitamente rimosso, sia perché il Pool si sta ridimensionando o ridimensionando automaticamente.
offline	Il Nodo di Calcolo attualmente non sta eseguendo un Task, e la programmazione dei nuovi Task al Nodo di Calcolo è disabilitata.
preempted	Il nodo di calcolo spot/con priorità bassa è stato superato. Le attività in esecuzione nel nodo di calcolo quando è stata annullata verranno riprogrammate quando diventa disponibile un altro nodo di calcolo.
upgradingos	Il Nodo di Calcolo sta subendo un'operazione di aggiornamento del sistema operativo.
deallocated	Il Nodo di Calcolo viene dislocato.
deallocating	Il Nodo di Calcolo sta effettuando disallocazioni.

BatchStartTask

Oggetto

Batch ritenta attività quando viene attivata un'operazione di ripristino in un nodo. Esempi di operazioni di ripristino includono (ma non sono limitati a) quando un nodo non integro viene riavviato o un nodo di calcolo è scomparso a causa di un errore dell'host. I tentativi dovuti alle operazioni di ripristino sono indipendenti da e non vengono conteggiati in base a maxTaskRetryCount. Anche se maxTaskRetryCount è 0, può verificarsi un nuovo tentativo interno a causa di un'operazione di ripristino. Per questo motivo, tutte le attività devono essere idempotenti. Ciò significa che le attività devono tollerare l'interruzione e il riavvio senza causare alcun danneggiamento o dati duplicati. La procedura consigliata per le attività a esecuzione prolungata consiste nell'usare una forma di checkpoint. In alcuni casi startTask può essere eseguito di nuovo anche se il nodo di calcolo non è stato riavviato. Prestare particolare attenzione per evitare StartTasks che creano processi di interruzione o installano/avviano i servizi dalla directory di lavoro StartTask, in quanto questo impedisce a Batch di essere in grado di eseguire nuovamente StartTask.

Nome	Tipo	Descrizione
commandLine	string	Riga di comando di StartTask. La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se si desidera sfruttare tali funzionalità, è necessario richiamare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" in Linux. Se la riga di comando fa riferimento ai percorsi di file, deve usare un percorso relativo (relativo alla directory di lavoro attività) o usare la variabile di ambiente fornita da Batch (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
containerSettings	BatchTaskContainerSettings	Le impostazioni del contenitore sotto cui viene eseguita la StartTask. Quando questo viene specificato, tutte le directory ricorsivamente sotto la AZ_BATCH_NODE_ROOT_DIR (la radice delle directory Azure Batch sul nodo) vengono mappate nel container, tutte le variabili dell'ambiente Task vengono mappate nel container e la riga di comando Task viene eseguita nel container. I file prodotti nel contenitore al di fuori di AZ_BATCH_NODE_ROOT_DIR potrebbero non essere riflessi sul disco host, il che significa che le API dei file Batch non potranno accedere a quei file.
environmentSettings	EnvironmentSetting[]	Elenco delle impostazioni delle variabili di ambiente per StartTask.
maxTaskRetryCount	integer (int32)	Numero massimo di tentativi dell'attività. Il servizio Batch ritenta un'attività se il codice di uscita è diverso da zero. Si noti che questo valore controlla in modo specifico il numero di tentativi. Il servizio Batch proverà l'attività una sola volta e potrebbe quindi riprovare fino a questo limite. Ad esempio, se il numero massimo di tentativi è 3, Batch prova l'attività fino a 4 volte (un tentativo iniziale e 3 tentativi). Se il numero massimo di tentativi è 0, il servizio Batch non ritenta l'attività. Se il numero massimo di tentativi è -1, il servizio Batch ritenta l'attività senza limite, ma non è consigliabile per un'attività di avvio o per qualsiasi attività. Il valore predefinito è 0 (nessun tentativo).
resourceFiles	ResourceFile[]	Elenco di file scaricati dal servizio Batch nel nodo di calcolo prima di eseguire la riga di comando. È prevista una dimensione massima per l'elenco dei file di risorse. Quando viene superata la dimensione massima, la richiesta avrà esito negativo e il codice di errore della risposta sarà RequestEntityTooLarge. In questo caso, la raccolta di ResourceFiles deve essere ridotta di dimensioni. A tale scopo, è possibile usare .zip file, pacchetti di applicazioni o contenitori Docker. I file elencati in questo elemento si trovano nella directory di lavoro dell'attività.
userIdentity	UserIdentity	L'identità utente sotto cui viene eseguito il StartTask. Se omesso, il Task viene eseguito come un utente non amministrativo unico per il Task.
waitForSuccess	boolean	Indica se il servizio Batch deve attendere il completamento di StartTask( ovvero uscire con il codice di uscita 0) prima di pianificare qualsiasi attività nel nodo di calcolo. Se true e StartTask non riesce in un nodo, il servizio Batch ritenta l'avvio fino al numero massimo di tentativi (maxTaskRetryCount). Se l'attività non è ancora stata completata correttamente dopo tutti i tentativi, il servizio Batch contrassegna il nodo inutilizzabile e non pianifica attività. Questa condizione può essere rilevata tramite lo stato del nodo di calcolo e i dettagli dell'errore. Se false, il servizio Batch non attenderà il completamento di StartTask. In questo caso, è possibile avviare l'esecuzione di altre attività nel nodo di calcolo mentre StartTask è ancora in esecuzione; e anche se StartTask ha esito negativo, le nuove attività continueranno a essere pianificate nel nodo di calcolo. Il valore predefinito è vero.

BatchStartTaskInfo

Oggetto

Informazioni su startTask in esecuzione in un nodo di calcolo.

Nome	Tipo	Descrizione
containerInfo	BatchTaskContainerExecutionInfo	Informazioni sul contenitore sotto cui il Task viene eseguito. Questa proprietà è impostata solo se il Task viene eseguito in un contesto container.
endTime	string (date-time)	L'orario in cui il StartTask si è fermato. Questo è il tempo di fine dell'ultima esecuzione di StartTask, se quella run è stata completata (anche se quella run è fallita e un nuovo tentativo è in attesa). Questo elemento non è presente se la StartTask è attualmente in esecuzione.
exitCode	integer (int32)	Il codice di uscita del programma specificato nella riga di comando StartTask. Questa proprietà è impostata solo se il StartTask è nello stato completato. In generale, il codice di uscita di un processo riflette la convenzione specifica implementata dallo sviluppatore dell'applicazione per quel processo. Se usi il valore del codice di uscita per prendere decisioni nel tuo codice, assicurati di conoscere la convenzione del codice di uscita usata dal processo di applicazione. Tuttavia, se il servizio Batch termina l'StartTask (a causa del timeout o della terminazione dell'utente tramite API) potresti vedere un codice di uscita definito dal sistema operativo.
failureInfo	BatchTaskFailureInfo	Informazioni che descrivono il fallimento del Compito, se ce ne sono. Questa proprietà viene impostata solo se il Compito è nello stato completato e ha incontrato un fallimento.
lastRetryTime	string (date-time)	L'ultima volta in cui è iniziato a eseguire un nuovo tentativo del Compito. Questo elemento è presente solo se il Task è stato riprovato (cioè il retryCount è diverso da zero). Se presente, questo è tipicamente lo stesso di startTime, ma può essere diverso se il Task è stato riavviato per motivi diversi dal ritento; ad esempio, se il Nodo di Calcolo è stato riavviato durante un retentativo, allora il startTime viene aggiornato ma il lastRetryTime no.
result	BatchTaskExecutionResult	Il risultato dell'esecuzione del Compito. Se il valore è 'fallito', allora i dettagli del guasto si trovano nella proprietà failureInfo.
retryCount	integer (int32)	Il numero di volte in cui il compito è stato riprovato dal servizio batch. I fallimenti delle applicazioni del task (codice di uscita non nullo) vengono riprovati, gli errori di pre-elaborazione (il Task non poteva essere eseguito) e gli errori di caricamento dei file non vengono riprovati. Il servizio Batch ritenterà il Task fino al limite specificato dai vincoli.
startTime	string (date-time)	L'orario in cui il StartTask iniziò a funzionare. Questo valore viene reimpostato ogni volta che il Task viene riavviato o riprovato (cioè, questa è l'ultima volta in cui il StartTask è iniziato a essere eseguito).
state	BatchStartTaskState	Lo stato dello StartTask sul nodo di calcolo.

BatchStartTaskState

Enumerazione

Enum di BatchStartTaskState

Valore	Descrizione
running	Lo StartTask è attualmente in esecuzione.
completed	Il StartTask è uscito con il codice di uscita 0, oppure il StartTask è fallito e il limite di ritentativi è raggiunto, oppure il processo StartTask non è stato eseguito a causa di errori nella preparazione del Task (come fallimenti nel download del file di risorse).

BatchTaskContainerExecutionInfo

Oggetto

Contiene informazioni sul contenitore in cui è in esecuzione un'attività.

Nome	Tipo	Descrizione
containerId	string	L'ID del contenitore.
error	string	Informazioni dettagliate sugli errori sul contenitore. Questa è la stringa di errore dettagliata del servizio Docker, se disponibile. È equivalente al campo errore restituito da "docker inspect".
state	string	Lo stato del contenitore. Questo è lo stato del container secondo il servizio Docker. È equivalente al campo stato restituito da "docker inspect".

BatchTaskContainerSettings

Oggetto

Impostazioni del contenitore per un'attività.

Nome	Tipo	Descrizione
containerHostBatchBindMounts	ContainerHostBatchBindMountEntry[]	Percorsi da montare nell'attività contenitore. Se questa matrice è null o non è presente, l'attività contenitore monta l'intera unità disco temporanea in Windows (o AZ_BATCH_NODE_ROOT_DIR in Linux). Se questa matrice è impostata come vuota, non verrà montato alcun percorso dati nel contenitore.
containerRunOptions	string	Opzioni aggiuntive per il comando create del contenitore. Queste opzioni aggiuntive vengono fornite come argomenti al comando "docker create", oltre a quelli controllati dal servizio Batch.
imageName	string	L'immagine da usare per creare il contenitore in cui verrà eseguito il Task. Questa è la referenza completa all'Image, come specificato per "docker pull". Se non viene fornito alcun tag come parte del nome dell'Immagine, il tag ":latest" viene usato come predefinito.
registry	ContainerRegistryReference	Il registro privato che contiene l'immagine del contenitore. Questa impostazione può essere omessa se era già stata fornita alla creazione del Pool.
workingDirectory	ContainerWorkingDirectory	La posizione della directory di lavoro Task del container. Il valore predefinito è 'taskWorkingDirectory'.

BatchTaskExecutionInfo

Oggetto

Informazioni sull'esecuzione di un'attività.

Nome	Tipo	Descrizione
containerInfo	BatchTaskContainerExecutionInfo	Informazioni sul contenitore sotto cui il Task viene eseguito. Questa proprietà è impostata solo se il Task viene eseguito in un contesto container.
endTime	string (date-time)	Il momento in cui il Compito fu completato. Questa proprietà viene impostata solo se il compito è nello stato Completato.
exitCode	integer (int32)	Il codice di uscita del programma specificato nella riga di comando Task. Questa proprietà viene impostata solo se il Compito è nello stato completato. In generale, il codice di uscita di un processo riflette la convenzione specifica implementata dallo sviluppatore dell'applicazione per quel processo. Se usi il valore del codice di uscita per prendere decisioni nel tuo codice, assicurati di conoscere la convenzione del codice di uscita usata dal processo di applicazione. Tuttavia, se il servizio Batch termina il Task (a causa del timeout o della terminazione dell'utente tramite API) potresti vedere un codice di uscita definito dal sistema operativo.
failureInfo	BatchTaskFailureInfo	Informazioni che descrivono il fallimento del Compito, se ce ne sono. Questa proprietà viene impostata solo se il Compito è nello stato completato e ha incontrato un fallimento.
lastRequeueTime	string (date-time)	L'ultima volta in cui il Task è stato re-codato dal servizio Batch a seguito di una richiesta dell'utente. Questa proprietà viene impostata solo se il requeueCount è diverso da zero.
lastRetryTime	string (date-time)	L'ultima volta in cui è iniziato a eseguire un nuovo tentativo del Compito. Questo elemento è presente solo se il Task è stato riprovato (cioè il retryCount è diverso da zero). Se presente, questo è tipicamente lo stesso di startTime, ma può essere diverso se il Task è stato riavviato per motivi diversi dal ritento; ad esempio, se il Nodo di Calcolo è stato riavviato durante un retentativo, allora il startTime viene aggiornato ma il lastRetryTime no.
requeueCount	integer (int32)	Il numero di volte in cui il Task è stato rimesso in coda dal servizio Batch a seguito di una richiesta dell'utente. Quando l'utente rimuove i Nodi di Calcolo da un Pool (ridimensionando/riducendo il pool) o quando il Job viene disabilitato, può specificare che i Task in esecuzione sui Nodi di Calcolo vengano rimessi in coda per l'esecuzione. Questo conteggio tiene traccia di quante volte il Compito è stato rimesso in coda per questi motivi.
result	BatchTaskExecutionResult	Il risultato dell'esecuzione del Compito. Se il valore è 'fallito', allora i dettagli del guasto si trovano nella proprietà failureInfo.
retryCount	integer (int32)	Il numero di volte in cui il compito è stato riprovato dal servizio batch. I fallimenti delle applicazioni del task (codice di uscita non nullo) vengono riprovati, gli errori di pre-elaborazione (il Task non poteva essere eseguito) e gli errori di caricamento dei file non vengono riprovati. Il servizio Batch ritenterà il Task fino al limite specificato dai vincoli.
startTime	string (date-time)	L'ora in cui il Compito iniziò a svolgersi. 'Running' corrisponde allo stato in esecuzione, quindi se il Task specifica file di risorse o Package, allora l'orario di inizio riflette il momento in cui il Task ha iniziato a scaricare o distribuire questi dati. Se il Task è stato riavviato o riprovato, questo è l'ultimo momento in cui il Task è iniziato a essere eseguito. Questa proprietà è presente solo per i Compiti che sono in esecuzione o completati.

BatchTaskExecutionResult

Enumerazione

Enum BatchTaskExecutionResult

Valore	Descrizione
success	Il compito fu eseguito con successo.
failure	C'è stato un errore durante l'elaborazione del Compito. Il guasto potrebbe essersi verificato prima che il processo Task venisse avviato, mentre il processo Task era in esecuzione o dopo che il processo Task è stato concluso.

BatchTaskFailureInfo

Oggetto

Informazioni su un errore di attività.

Nome	Tipo	Descrizione
category	BatchErrorSourceCategory	La categoria dell'errore Task.
code	string	Un identificatore per l'errore Task. I codici sono invarianti e devono essere utilizzati a livello di codice.
details	NameValuePair[]	Un elenco di dettagli aggiuntivi relativi all'errore.
message	string	Un messaggio che descrive l'errore Task, pensato per essere adatto alla visualizzazione in un'interfaccia utente.

BatchTaskInfo

Oggetto

Informazioni su un'attività in esecuzione in un nodo di calcolo.

Nome	Tipo	Descrizione
executionInfo	BatchTaskExecutionInfo	Informazioni sull'esecuzione del compito.
jobId	string	L'ID del Lavoro a cui appartiene il Compito.
subtaskId	integer (int32)	L'ID del sottocompito se il Compito è un Compito multi-istanze.
taskId	string	L'ID del compito.
taskState	BatchTaskState	Lo stato attuale del Compito.
taskUrl	string (uri)	L'URL del Task.

BatchTaskState

Enumerazione

Enum di BatchTaskState

Valore	Descrizione
active	Il Task è in coda e può essere eseguito, ma attualmente non è assegnato a un Nodo di Calcolo. Un Task entra in questo stato quando viene creato, quando viene abilitato dopo essere stato disabilitato, o quando è in attesa di un nuovo tentativo dopo un'esecuzione fallita.
preparing	Il compito è stato assegnato a un Nodo di Calcolo, ma sta aspettando che un compito di Preparazione del Lavoro richiesto venga completato sul Nodo di Calcolo. Se il compito di Preparazione del Lavoro ha successo, il compito passerà a essere eseguito. Se il compito di preparazione del lavoro fallisce, il compito tornerà attivo e sarà idoneo ad essere assegnato a un diverso nodo di calcolo.
running	Il compito viene eseguito su un nodo di calcolo. Questo include la preparazione a livello di task, come scaricare file di risorse o distribuire Pacchetti specificati sul Task - non significa necessariamente che la riga di comando del Task abbia iniziato a essere eseguita.
completed	Il Compito non è più idoneo a essere eseguito, di solito perché è stato completato con successo o perché il Compito è stato completato senza successo e ha esaurito il limite di ritentativi. Un Compito viene inoltre segnato come completato se si è verificato un errore all'avvio del Compito, o quando il Compito è stato terminato.

BatchVmImageReference

Oggetto

Riferimento a un'immagine del Marketplace di macchine virtuali di Azure o a un'immagine della raccolta di calcolo di Azure. Per ottenere l'elenco di tutti i riferimenti alle immagini di Azure Marketplace verificati da Azure Batch, vedere l'operazione "Elenca immagini supportate".

Nome	Tipo	Descrizione
communityGalleryImageId	string	L'immagine della galleria comunitaria identifica l'unico indicatore. Questa proprietà si escludono a vicenda con altre proprietà e possono essere recuperate dalla chiamata GET dell'immagine della raccolta della community.
exactVersion	string	La versione specifica dell'immagine della piattaforma o dell'immagine marketplace utilizzata per creare il nodo. Questo campo di sola lettura differisce da 'version' solo se il valore specificato per 'version' al momento della creazione del pool era 'latest'.
offer	string	Il tipo di offerta dell'immagine Azure Virtual Machines Marketplace. Ad esempio, UbuntuServer o WindowsServer.
publisher	string	L'editore dell'immagine Azure Virtual Machines Marketplace. Ad esempio, Canonical o MicrosoftWindowsServer.
sharedGalleryImageId	string	L'immagine della galleria condivisa identifica unico. Questa proprietà si escludono a vicenda con altre proprietà e possono essere recuperate dalla chiamata GET dell'immagine della raccolta condivisa.
sku	string	La SKU dell'immagine Azure Virtual Machines Marketplace. Ad esempio, 18.04-LTS o 2019-Datacenter.
version	string	La versione dell'immagine Azure Virtual Machines Marketplace. Un valore 'latest' può essere specificato per selezionare l'ultima versione di un'Immagine. Se omesso, il valore predefinito è 'latest'.
virtualMachineImageId	string (arm-id)	Identificatore della risorsa ARM dell'immagine della raccolta di calcolo di Azure. I nodi di calcolo nel Pool saranno creati utilizzando questo ID Immagine. Questo è della forma /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} oppure /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} per utilizzare sempre l'ultima versione dell'immagine. Questa proprietà è mutuamente esclusiva con le altre proprietà di ImageReference. L'immagine Azure Compute Gallery deve avere repliche nella stessa regione e deve essere nello stesso abbonamento dell'account batch Azure. Se la versione dell'immagine non è specificata nell'imageId, verrà utilizzata l'ultima versione. Per informazioni sulle impostazioni del firewall per l'agente Batch Compute Node per comunicare con il servizio Batch, vedi https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration.

ContainerHostBatchBindMountEntry

Oggetto

Voce di percorso e modalità di montaggio da montare nel contenitore di attività.

Nome	Tipo	Descrizione
isReadOnly	boolean	Montare o meno questo percorso di origine come modalità di sola lettura. Il valore predefinito è false (modalità lettura/scrittura). Per Linux, se si monta questo percorso come modalità di lettura/scrittura, ciò non significa che tutti gli utenti nel contenitore dispongano dell'accesso in lettura/scrittura per il percorso, dipende dall'accesso nella macchina virtuale host. Se questo percorso viene montato in sola lettura, tutti gli utenti all'interno del contenitore non potranno modificare il percorso.
source	ContainerHostDataPath	Il percorso che può essere montato nel cliente del contenitore può selezionare.

ContainerHostDataPath

Enumerazione

Percorsi che verranno montati nel contenitore dell'attività contenitore.

Valore	Descrizione
Shared	Percorso dell'attività a più istanze in cui condividere i propri file.
Startup	Percorso dell'attività di avvio.
VfsMounts	Il percorso contiene tutti i file system virtuali montati in questo nodo.
Task	Percorso dell'attività.
JobPrep	Percorso dell'attività di preparazione del processo.
Applications	Percorso delle applicazioni.

ContainerRegistryReference

Oggetto

Registro contenitori privato.

Nome	Tipo	Descrizione
identityReference	BatchNodeIdentityReference	Riferimento all'identità assegnata dall'utente da usare per accedere a un Registro Azure Container invece di nome utente e password.
password	string (password)	Password per accedere al server del Registro di sistema.
registryServer	string (uri)	URL del Registro di sistema. Se omesso, il valore predefinito è "docker.io".
username	string	Nome utente per accedere al server del Registro di sistema.

ContainerWorkingDirectory

Enumerazione

ContainerWorkingDirectory enums

Valore	Descrizione
taskWorkingDirectory	Usa la directory standard di lavoro Task di servizio Batch, che conterrà i File Risorsa Task popolati per Batch.
containerImageDefault	Usa la directory di lavoro definita nell'immagine del container. Attenzione che questa directory non conterrà i File Risorse scaricati da Batch.

ElevationLevel

Enumerazione

Enum di ElevationLevel

Valore	Descrizione
nonadmin	L'utente è un utente standard senza accesso con privilegi elevati.
admin	L'utente è un utente con accesso con privilegi elevati e opera con autorizzazioni di amministratore complete.

EnvironmentSetting

Oggetto

Variabile di ambiente da impostare in un processo task.

Nome	Tipo	Descrizione
name	string	Nome della variabile di ambiente.
value	string	Valore della variabile di ambiente.

InboundEndpoint

Oggetto

Endpoint in ingresso in un nodo di calcolo.

Nome	Tipo	Descrizione
backendPort	integer (int32)	Il numero della porta backend dell'endpoint.
frontendPort	integer (int32)	Il numero di porta pubblica dell'endpoint.
name	string	Nome dell'endpoint.
protocol	InboundEndpointProtocol	Protocollo dell'endpoint.
publicFQDN	string	Il dominio pubblico completamente qualificato per il Nodo di Calcolo.
publicIPAddress	string	L'indirizzo IP pubblico del Nodo di Calcolo.

InboundEndpointProtocol

Enumerazione

InboundEndpointProtocol enums

Valore	Descrizione
tcp	Usare TCP per l'endpoint.
udp	Usare UDP per l'endpoint.

NameValuePair

Oggetto

Rappresenta una coppia nome-valore.

Nome	Tipo	Descrizione
name	string	Il nome nella coppia nome-valore.
value	string	Il valore nella coppia nome-valore.

ResourceFile

Oggetto

Un singolo file o più file da scaricare in un nodo di calcolo.

Nome	Tipo	Descrizione
autoStorageContainerName	string	Il nome del container di archiviazione nell'account di auto storage. Le proprietà autoStorageContainerName, storageContainerUrl e httpUrl si escludono a vicenda e una di esse deve essere specificata.
blobPrefix	string	Prefisso BLOB da usare durante il download di BLOB da un contenitore di Archiviazione di Azure. Verranno scaricati solo i BLOB i cui nomi iniziano con il prefisso specificato. La proprietà è valida solo quando si usa autoStorageContainerName o storageContainerUrl. Questo prefisso può essere un nome file parziale o una sottodirectory. Se non viene specificato un prefisso, verranno scaricati tutti i file nel contenitore.
fileMode	string	Attributo della modalità di autorizzazione file in formato ottale. Questa proprietà si applica solo ai file scaricati su Linux Compute Nodes. Verrà ignorato se viene specificato per un file di risorsa che verrà scaricato su un nodo di calcolo di Windows. Se questa proprietà non è specificata per un nodo Linux Compute, allora viene applicato un valore predefinito 0770 al file.
filePath	string	La posizione sul Nodo di Calcolo su cui scaricare il/i file/i, rispetto alla directory operativa del Task. Se viene specificata la proprietà httpUrl, filePath è obbligatorio e descrive il percorso in cui verrà scaricato il file, incluso il nome file. In caso contrario, se si specifica la proprietà autoStorageContainerName o storageContainerUrl, filePath è facoltativo ed è la directory in cui scaricare i file. Nel caso in cui filePath venga usato come directory, qualsiasi struttura di directory già associata ai dati di input verrà mantenuta in modo completo e accodato alla directory filePath specificata. Il percorso relativo specificato non può uscire dalla directory di lavoro del Task (ad esempio usando '..').
httpUrl	string (uri)	URL del file da scaricare. Le proprietà autoStorageContainerName, storageContainerUrl e httpUrl si escludono a vicenda e una di esse deve essere specificata. Se l'URL punta ad Archiviazione BLOB di Azure, deve essere leggibile dai nodi di calcolo. Esistono tre modi per ottenere tale URL per un BLOB nell'archiviazione di Azure: includere una firma di accesso condiviso (SAS) che concede le autorizzazioni di lettura per il BLOB, usare un'identità gestita con autorizzazione di lettura o impostare l'ACL per il BLOB o il relativo contenitore per consentire l'accesso pubblico.
identityReference	BatchNodeIdentityReference	Il riferimento all'identità assegnata dall'utente da utilizzare per accedere a Azure Blob Storage specificato da storageContainerUrl o httpUrl.
storageContainerUrl	string (uri)	URL del contenitore BLOB all'interno di Archiviazione BLOB di Azure. Le proprietà autoStorageContainerName, storageContainerUrl e httpUrl si escludono a vicenda e una di esse deve essere specificata. Questo URL deve essere leggibile ed elencabile dai nodi di calcolo. Esistono tre modi per ottenere tale URL per un contenitore nell'archiviazione di Azure: includere una firma di accesso condiviso che concede autorizzazioni di lettura ed elenco per il contenitore, usare un'identità gestita con autorizzazioni di lettura ed elenco o impostare l'ACL per il contenitore per consentire l'accesso pubblico.

SchedulingState

Enumerazione

ProgrammazioneElenco degli Status

Valore	Descrizione
enabled	Le attività possono essere programmate sul Nodo di Calcolo.
disabled	Non verranno programmati nuovi Task sul Nodo di Calcolo. I compiti già in esecuzione sul Nodo di Calcolo possono comunque essere eseguiti fino al completamento. Tutti i Nodi di Calcolo iniziano con la pianificazione attivata.

UserIdentity

Oggetto

Definizione dell'identità utente in cui viene eseguita l'attività. Specificare la proprietà userName o autoUser, ma non entrambe.

Nome	Tipo	Descrizione
autoUser	AutoUserSpecification	L'utente automatico sotto cui viene eseguito il Task. Le proprietà userName e autoUser si escludono a vicenda; è necessario specificarne uno ma non entrambi.
username	string	Il nome dell'identità utente con cui viene eseguito il Task. Le proprietà userName e autoUser si escludono a vicenda; è necessario specificarne uno ma non entrambi.

VirtualMachineInfo

Oggetto

Informazioni sullo stato corrente della macchina virtuale.

Nome	Tipo	Descrizione
imageReference	BatchVmImageReference	Il riferimento all'immagine Marketplace di Azure Virtual Machine.
scaleSetVmResourceId	string	L'ID della risorsa della VM attuale Virtual Machine Scale Set del Nodo di Calcolo. Definito solo se l'Account Batch è stato creato con la proprietà poolAllocationMode impostata su 'UserSubscription'.

Condividi tramite

Nodes - List Nodes

Parametri dell'URI

Intestazione della richiesta

Risposte

Sicurezza

OAuth2Auth

Ambiti

Esempio

Node list

Esempio di richiesta

Risposta di esempio

Definizioni

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