Condividi tramite


Compute Node - Get

Ottiene informazioni sul nodo di calcolo specificato.

GET {batchUrl}/pools/{poolId}/nodes/{nodeId}?api-version=2024-07-01.20.0
GET {batchUrl}/pools/{poolId}/nodes/{nodeId}?$select={$select}&timeout={timeout}&api-version=2024-07-01.20.0

Parametri dell'URI

Nome In Necessario Tipo Descrizione
batchUrl
path True

string

URL di base per tutte le richieste del servizio Azure Batch.

nodeId
path True

string

ID del nodo di calcolo su cui si desidera ottenere informazioni.

poolId
path True

string

ID del pool che contiene il nodo di calcolo.

api-version
query True

string

Versione dell'API client.

$select
query

string

Clausola di $select OData.

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 è maggiore di 30, verrà usato il valore predefinito.

Intestazione della richiesta

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

Nome Necessario Tipo Descrizione
client-request-id

string

uuid

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

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

ComputeNode

Risposta contenente il nodo di calcolo.

Intestazioni

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

BatchError

Errore del servizio Batch.

Sicurezza

azure_auth

Flusso del codice di autenticazione di Microsoft Entra OAuth 2.0

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

Ambiti

Nome Descrizione
user_impersonation Rappresentare l'account utente

Authorization

Tipo: apiKey
In: header

Esempio

Node get

Esempio di richiesta

GET account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z?api-version=2024-07-01.20.0


Risposta di esempio

{
  "id": "tvm-1695681911_2-20161122t193202z",
  "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z",
  "state": "idle",
  "schedulingState": "enabled",
  "stateTransitionTime": "2016-11-22T19:37:31.4285526Z",
  "lastBootTime": "2016-11-22T19:37:28.623369Z",
  "allocationTime": "2016-11-22T19:32:02.8155319Z",
  "ipAddress": "1.1.1.1",
  "affinityId": "TVM:tvm-1695681911_2-20161122t193202z",
  "vmSize": "small",
  "totalTasksRun": 0,
  "totalTasksSucceeded": 0,
  "runningTasksCount": 0,
  "isDedicated": true,
  "startTask": {
    "commandLine": "cmd /c echo hello",
    "userIdentity": {
      "autoUser": {
        "scope": "task",
        "elevationLevel": "nonadmin"
      }
    },
    "maxTaskRetryCount": 0,
    "waitForSuccess": false
  },
  "startTaskInfo": {
    "state": "completed",
    "startTime": "2016-11-22T19:37:31.4285526Z",
    "endTime": "2016-11-22T19:37:31.838028Z",
    "exitCode": 0,
    "retryCount": 0
  },
  "nodeAgentInfo": {
    "version": "1.2.0.0",
    "lastUpdateTime": "2016-11-22T19:37:28.623369Z"
  }
}

Definizioni

Nome Descrizione
AutoUserScope

Ambito dell'utente automatico

AutoUserSpecification

Specifica i parametri per l'utente automatico che esegue un'attività nel servizio Batch.

BatchError

Risposta di errore ricevuta dal servizio Azure Batch.

BatchErrorDetail

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

CertificateReference

Riferimento a un certificato da installare nei nodi di calcolo in un pool.

CertificateStoreLocation

Percorso dell'archivio certificati nel nodo di calcolo in cui installare il certificato.

CertificateVisibility

Quali account utente nel nodo di calcolo devono avere accesso ai dati privati del certificato.

ComputeNode

Nodo di calcolo nel servizio Batch.

ComputeNodeEndpointConfiguration

Configurazione dell'endpoint per il nodo di calcolo.

ComputeNodeError

Errore rilevato da un nodo di calcolo.

ComputeNodeIdentityReference

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

ComputeNodeState

Stato corrente del nodo di calcolo.

ContainerHostBatchBindMountEntry

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

ContainerHostDataPath

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

ContainerRegistry

Registro contenitori privato.

ContainerWorkingDirectory

Percorso della directory di lavoro dell'attività del contenitore.

ElevationLevel

Livello di elevazione dell'utente.

EnvironmentSetting

Variabile di ambiente da impostare in un processo task.

ErrorCategory

Categoria dell'errore.

ErrorMessage

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

ImageReference

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

InboundEndpoint

Endpoint in ingresso in un nodo di calcolo.

InboundEndpointProtocol

Protocollo dell'endpoint.

NameValuePair

Rappresenta una coppia nome-valore.

NodeAgentInformation

Informazioni sull'agente del nodo di calcolo.

ResourceFile

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

SchedulingState

Indica se il nodo di calcolo è disponibile per la pianificazione delle attività.

StartTask

Attività eseguita quando un nodo viene aggiunto a un pool nel servizio Azure Batch o quando il nodo di calcolo viene riavviato o ricreato l'immagine.

StartTaskInformation

Informazioni su startTask in esecuzione in un nodo di calcolo.

StartTaskState

Stato di StartTask nel nodo di calcolo.

TaskContainerExecutionInformation

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

TaskContainerSettings

Impostazioni del contenitore per un'attività.

TaskExecutionInformation

Informazioni sull'esecuzione di un'attività.

TaskExecutionResult

Risultato dell'esecuzione dell'attività.

TaskFailureInformation

Informazioni su un errore di attività.

TaskInformation

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

TaskState

Stato dell'attività.

UserIdentity

Definizione dell'identità utente in cui viene eseguita l'attività.

VirtualMachineInfo

Informazioni sullo stato corrente della macchina virtuale.

AutoUserScope

Ambito dell'utente automatico

Nome Tipo Descrizione
pool

string

Specifica che l'attività viene eseguita come account utente automatico comune creato in ogni nodo di calcolo in un pool.

task

string

Specifica che il servizio deve creare un nuovo utente per l'attività.

AutoUserSpecification

Specifica i parametri per l'utente automatico che esegue un'attività nel servizio 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 modo da influire su altre attività o se i certificati sono stati specificati nel pool che non devono essere accessibili dalle normali attività, ma devono essere accessibili da StartTasks.

BatchError

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

ErrorMessage

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

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.

CertificateReference

Riferimento a un certificato da installare nei nodi di calcolo in un pool.

Nome Tipo Descrizione
storeLocation

CertificateStoreLocation

Percorso dell'archivio certificati nel nodo di calcolo in cui installare il certificato.
Il valore predefinito è currentuser. Questa proprietà è applicabile solo per i pool configurati con nodi di calcolo Windows. Per i nodi di calcolo Linux, i certificati vengono archiviati in una directory all'interno della directory di lavoro attività e viene fornita una variabile di ambiente AZ_BATCH_CERTIFICATES_DIR all'attività per eseguire una query per questo percorso. Per i certificati con visibilità di 'remoteUser', viene creata una directory 'certs' nella home directory dell'utente (ad esempio, /home/{user-name}/certs) e i certificati vengono inseriti in tale directory.

storeName

string

Nome dell'archivio certificati nel nodo di calcolo in cui installare il certificato.
Questa proprietà è applicabile solo per i pool configurati con nodi di calcolo Windows. I nomi comuni degli archivi includono: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ma è possibile usare anche qualsiasi nome di archivio personalizzato. Il valore predefinito è My.

thumbprint

string

Identificazione personale del certificato.

thumbprintAlgorithm

string

Algoritmo a cui è associata l'identificazione personale. Deve essere sha1.

visibility

CertificateVisibility[]

Quali account utente nel nodo di calcolo devono avere accesso ai dati privati del certificato.
È possibile specificare più visibilità in questa raccolta. Il valore predefinito è tutti Gli account.

CertificateStoreLocation

Percorso dell'archivio certificati nel nodo di calcolo in cui installare il certificato.

Nome Tipo Descrizione
currentuser

string

I certificati devono essere installati nell'archivio certificati CurrentUser.

localmachine

string

I certificati devono essere installati nell'archivio certificati LocalMachine.

CertificateVisibility

Quali account utente nel nodo di calcolo devono avere accesso ai dati privati del certificato.

Nome Tipo Descrizione
remoteuser

string

Il certificato deve essere visibile agli account utente in cui gli utenti accedono in remoto al nodo di calcolo.

starttask

string

Il certificato deve essere visibile all'account utente in cui viene eseguito StartTask. Si noti che se l'ambito dell'utente automatico è Pool sia per StartTask che per un'attività, questo certificato sarà visibile anche all'attività.

task

string

Il certificato deve essere visibile agli account utente in cui vengono eseguite le attività di processo.

ComputeNode

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

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.

certificateReferences

CertificateReference[]

Elenco dei certificati installati nel nodo di calcolo.
Per i nodi Di Windows, il servizio Batch installa i certificati nell'archivio certificati e nel percorso specificati. Per i nodi di calcolo Linux, i certificati vengono archiviati in una directory all'interno della directory di lavoro attività e viene fornita una variabile di ambiente AZ_BATCH_CERTIFICATES_DIR all'attività per eseguire una query per questo percorso. Per i certificati con visibilità di 'remoteUser', viene creata una directory 'certs' nella home directory dell'utente (ad esempio, /home/{user-name}/certs) e i certificati vengono inseriti in tale directory.

Avviso: questa proprietà è deprecata e verrà rimossa dopo febbraio 2024. Usare invece 'estensione Azure KeyVault.

endpointConfiguration

ComputeNodeEndpointConfiguration

Configurazione dell'endpoint per il nodo di calcolo.

errors

ComputeNodeError[]

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.

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

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

NodeAgentInformation

Informazioni sulla versione dell'agente del nodo di calcolo e sull'ora in cui il nodo di calcolo è stato aggiornato a una nuova versione.
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.

recentTasks

TaskInformation[]

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

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

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

StartTask

L'attività specificata per l'esecuzione nel nodo di calcolo durante l'aggiunta al pool.
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.

startTaskInfo

StartTaskInformation

Informazioni di runtime sull'esecuzione di StartTask nel nodo di calcolo.

state

ComputeNodeState

Stato corrente del nodo di calcolo.
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.

stateTransitionTime

string

Ora in cui il nodo di calcolo ha immesso lo stato corrente.

totalTasksRun

integer

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

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

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://docs.microsoft.com/azure/batch/batch-pool-vm-sizes).

ComputeNodeEndpointConfiguration

Configurazione dell'endpoint per il nodo di calcolo.

Nome Tipo Descrizione
inboundEndpoints

InboundEndpoint[]

Elenco di endpoint in ingresso accessibili nel nodo di calcolo.

ComputeNodeError

Errore rilevato da un nodo di calcolo.

Nome Tipo Descrizione
code

string

Identificatore per l'errore del nodo di calcolo. I codici sono invarianti e devono essere utilizzati a livello di codice.

errorDetails

NameValuePair[]

Elenco di dettagli aggiuntivi relativi all'errore del nodo di calcolo.

message

string

Messaggio che descrive l'errore del nodo di calcolo, destinato a essere adatto per la visualizzazione in un'interfaccia utente.

ComputeNodeIdentityReference

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

ID risorsa ARM dell'identità assegnata dall'utente.

ComputeNodeState

Stato corrente del nodo di calcolo.

Nome Tipo Descrizione
creating

string

Il servizio Batch ha ottenuto la macchina virtuale sottostante da Calcolo di Azure, ma non è ancora stata avviata l'aggiunta al pool.

deallocated

string

Il nodo di calcolo viene deallocato.

deallocating

string

Il nodo di calcolo sta deallocazione.

idle

string

Il nodo di calcolo non esegue attualmente un'attività.

leavingpool

string

Il nodo di calcolo sta lasciando il pool, perché l'utente l'ha rimossa in modo esplicito o perché il pool sta ridimensionando o ridimensionando automaticamente.

offline

string

Il nodo di calcolo non esegue attualmente un'attività e la pianificazione delle nuove attività nel nodo di calcolo è disabilitata.

preempted

string

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.

rebooting

string

Il nodo di calcolo viene riavviato.

reimaging

string

Il nodo di calcolo sta ricreando l'immagini.

running

string

Il nodo di calcolo esegue una o più attività (diverse da startTask).

starting

string

Il servizio Batch viene avviato nella macchina virtuale sottostante.

starttaskfailed

string

StartTask non è riuscito nel nodo di calcolo e ha esaurito tutti i tentativi e waitForSuccess è impostato. Il nodo di calcolo non è utilizzabile per l'esecuzione di attività.

unknown

string

Il servizio Batch ha perso il contatto con il nodo di calcolo e non conosce lo stato effettivo.

unusable

string

Il nodo di calcolo non può essere usato per l'esecuzione dell'attività a causa di errori.

upgradingos

string

Il nodo di calcolo è in corso un'operazione di aggiornamento del sistema operativo.

waitingforstarttask

string

StartTask è stato avviato in esecuzione nel nodo di calcolo, ma waitForSuccess è impostato e StartTask non è ancora stato completato.

ContainerHostBatchBindMountEntry

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

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

Nome Tipo Descrizione
Applications

string

Percorso delle applicazioni.

JobPrep

string

Percorso dell'attività di preparazione del processo.

Shared

string

Percorso dell'attività a più istanze in cui condividere i propri file.

Startup

string

Percorso dell'attività di avvio.

Task

string

Percorso dell'attività.

VfsMounts

string

Il percorso contiene tutti i file system virtuali montati in questo nodo.

ContainerRegistry

Registro contenitori privato.

Nome Tipo Descrizione
identityReference

ComputeNodeIdentityReference

Riferimento all'identità assegnata dall'utente da usare per accedere a un Registro Azure Container invece di nome utente e password.
Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo.

password

string

Password per accedere al server del Registro di sistema.

registryServer

string

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

Percorso della directory di lavoro dell'attività del contenitore.

Nome Tipo Descrizione
containerImageDefault

string

Usare la directory di lavoro definita nell'immagine del contenitore. Tenere presente che questa directory non conterrà i file di risorse scaricati da Batch.

taskWorkingDirectory

string

Usare la directory di lavoro dell'attività del servizio Batch standard, che conterrà i file di risorse attività popolati da Batch.

ElevationLevel

Livello di elevazione dell'utente.

Nome Tipo Descrizione
admin

string

L'utente è un utente con accesso con privilegi elevati e opera con autorizzazioni di amministratore complete.

nonadmin

string

L'utente è un utente standard senza accesso con privilegi elevati.

EnvironmentSetting

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.

ErrorCategory

Categoria dell'errore.

Nome Tipo Descrizione
servererror

string

L'errore è dovuto a un problema interno del server.

usererror

string

L'errore è dovuto a un problema dell'utente, ad esempio la configurazione errata.

ErrorMessage

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

Nome Tipo Descrizione
lang

string

Codice linguistico del messaggio di errore

value

string

Testo del messaggio.

ImageReference

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

Identificatore univoco dell'immagine della raccolta community
Questa proprietà si escludono a vicenda con altre proprietà e possono essere recuperate dalla chiamata GET dell'immagine della raccolta della community.

exactVersion

string

Versione specifica dell'immagine della piattaforma o dell'immagine del marketplace usata per creare il nodo. Questo campo di sola lettura è diverso da 'version' solo se il valore specificato per 'version' quando il pool è stato creato è stato 'latest'.

offer

string

Tipo di offerta dell'immagine marketplace di Macchine virtuali di Azure.
Ad esempio, UbuntuServer o WindowsServer.

publisher

string

Autore dell'immagine del Marketplace delle macchine virtuali di Azure.
Ad esempio, Canonical o MicrosoftWindowsServer.

sharedGalleryImageId

string

Identificatore univoco dell'immagine della raccolta condivisa
Questa proprietà si escludono a vicenda con altre proprietà e possono essere recuperate dalla chiamata GET dell'immagine della raccolta condivisa.

sku

string

SKU dell'immagine del Marketplace delle macchine virtuali di Azure.
Ad esempio, 18.04-LTS o 2019-Datacenter.

version

string

Versione dell'immagine marketplace di Macchine virtuali di Azure.
È possibile specificare il valore 'latest' per selezionare la versione più recente di un'immagine. Se omesso, il valore predefinito è 'latest'.

virtualMachineImageId

string

Identificatore della risorsa ARM dell'immagine della raccolta di calcolo di Azure. I nodi di calcolo nel pool verranno creati usando questo ID immagine. Si tratta del formato /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} o /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} per l'impostazione predefinita alla versione più recente dell'immagine.
Questa proprietà si escludono a vicenda con altre proprietà ImageReference. L'immagine della raccolta di calcolo di Azure deve avere repliche nella stessa area e deve trovarsi nella stessa sottoscrizione dell'account Azure Batch. Se la versione dell'immagine non è specificata nell'imageId, verrà usata la versione più recente. Per informazioni sulle impostazioni del firewall per l'agente del nodo di calcolo Batch per comunicare con il servizio Batch, vedere https://docs.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration.

InboundEndpoint

Endpoint in ingresso in un nodo di calcolo.

Nome Tipo Descrizione
backendPort

integer

Numero di porta back-end dell'endpoint.

frontendPort

integer

Numero di porta pubblica dell'endpoint.

name

string

Nome dell'endpoint.

protocol

InboundEndpointProtocol

Protocollo dell'endpoint.

publicFQDN

string

Nome di dominio completo pubblico per il nodo di calcolo.

publicIPAddress

string

Indirizzo IP pubblico del nodo di calcolo.

InboundEndpointProtocol

Protocollo dell'endpoint.

Nome Tipo Descrizione
tcp

string

Usare TCP per l'endpoint.

udp

string

Usare UDP per l'endpoint.

NameValuePair

Rappresenta una coppia nome-valore.

Nome Tipo Descrizione
name

string

Nome nella coppia nome-valore.

value

string

Valore nella coppia nome-valore.

NodeAgentInformation

Informazioni sull'agente del nodo di calcolo.

Nome Tipo Descrizione
lastUpdateTime

string

Ora in cui l'agente del nodo di calcolo è stato aggiornato nel nodo di calcolo.
Questa è l'ora più recente in cui l'agente del nodo di calcolo è stato aggiornato a una nuova versione.

version

string

Versione dell'agente del nodo di calcolo Batch in esecuzione nel nodo di calcolo.
Questo numero di versione può essere controllato in base alle note sulla versione dell'agente del nodo di calcolo disponibili in https://github.com/Azure/Batch/blob/master/changelogs/nodeagent/CHANGELOG.md.

ResourceFile

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

Nome Tipo Descrizione
autoStorageContainerName

string

Nome del contenitore di archiviazione nell'account di archiviazione automatico.
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 nei nodi di calcolo Linux. Verrà ignorato se viene specificato per un oggetto resourceFile che verrà scaricato in un nodo di calcolo Windows. Se questa proprietà non viene specificata per un nodo di calcolo Linux, al file viene applicato il valore predefinito 0770.

filePath

string

Percorso nel nodo di calcolo in cui scaricare i file rispetto alla directory di lavoro dell'attività.
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 dell'attività, ad esempio tramite '..'.

httpUrl

string

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

ComputeNodeIdentityReference

Riferimento all'identità assegnata dall'utente da usare per accedere all'archiviazione BLOB di Azure specificata da storageContainerUrl o httpUrl
Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo.

storageContainerUrl

string

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

Indica se il nodo di calcolo è disponibile per la pianificazione delle attività.

Nome Tipo Descrizione
disabled

string

Nessuna nuova attività verrà pianificata nel nodo di calcolo. Le attività già in esecuzione nel nodo di calcolo possono comunque essere eseguite fino al completamento. Tutti i nodi di calcolo iniziano con la pianificazione abilitata.

enabled

string

Le attività possono essere pianificate nel nodo di calcolo.

StartTask

Attività eseguita quando un nodo viene aggiunto a un pool nel servizio Azure Batch o quando il nodo di calcolo viene riavviato o ricreato l'immagine.

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://docs.microsoft.com/azure/batch/batch-compute-node-environment-variables).

containerSettings

TaskContainerSettings

Impostazioni per il contenitore in cui viene eseguito StartTask.
Quando viene specificato questo parametro, tutte le directory vengono mappate in modo ricorsivo al di sotto del AZ_BATCH_NODE_ROOT_DIR (la radice delle directory di Azure Batch nel nodo) nel contenitore, tutte le variabili di ambiente delle attività vengono mappate nel contenitore e la riga di comando Task viene eseguita nel contenitore. I file prodotti nel contenitore all'esterno di AZ_BATCH_NODE_ROOT_DIR potrebbero non essere riflessi sul disco host, ovvero le API di file batch non saranno in grado di accedere a tali file.

environmentSettings

EnvironmentSetting[]

Elenco delle impostazioni delle variabili di ambiente per StartTask.

maxTaskRetryCount

integer

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

Identità utente con cui viene eseguito StartTask.
Se omesso, l'attività viene eseguita come utente non amministrativo univoco per l'attività.

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

StartTaskInformation

Informazioni su startTask in esecuzione in un nodo di calcolo.

Nome Tipo Descrizione
containerInfo

TaskContainerExecutionInformation

Informazioni sul contenitore in cui è in esecuzione l'attività.
Questa proprietà viene impostata solo se l'attività viene eseguita in un contesto contenitore.

endTime

string

Ora in cui StartTask ha interrotto l'esecuzione.
Questa è l'ora di fine dell'esecuzione più recente di StartTask, se l'esecuzione è stata completata (anche se l'esecuzione non è riuscita e un nuovo tentativo è in sospeso). Questo elemento non è presente se StartTask è attualmente in esecuzione.

exitCode

integer

Codice di uscita del programma specificato nella riga di comando StartTask.
Questa proprietà viene impostata solo se StartTask è nello stato completato. In generale, il codice di uscita per un processo riflette la convenzione specifica implementata dallo sviluppatore dell'applicazione per tale processo. Se si usa il valore del codice di uscita per prendere decisioni nel codice, assicurarsi di conoscere la convenzione di codice di uscita usata dal processo dell'applicazione. Tuttavia, se il servizio Batch termina StartTask (a causa del timeout o la terminazione dell'utente tramite l'API), è possibile che venga visualizzato un codice di uscita definito dal sistema operativo.

failureInfo

TaskFailureInformation

Informazioni che descrivono l'errore dell'attività, se presenti.
Questa proprietà viene impostata solo se l'oggetto Task è nello stato completato e si è verificato un errore.

lastRetryTime

string

Ora più recente in cui è stata avviata l'esecuzione di un nuovo tentativo dell'attività.
Questo elemento è presente solo se l'attività è stata ritentata (ad esempio retryCount è diverso da zero). Se presente, si tratta in genere dello stesso valore di startTime, ma può essere diverso se l'attività è stata riavviata per motivi diversi dai tentativi; Ad esempio, se il nodo di calcolo è stato riavviato durante un nuovo tentativo, startTime viene aggiornato ma lastRetryTime non è.

result

TaskExecutionResult

Risultato dell'esecuzione dell'attività.
Se il valore è "failed", i dettagli dell'errore sono disponibili nella proprietà failureInfo.

retryCount

integer

Numero di tentativi di esecuzione dell'attività da parte del servizio Batch.
Gli errori dell'applicazione attività (codice di uscita diverso da zero) vengono ritentati, vengono eseguiti errori di pre-elaborazione (non è stato possibile eseguire l'attività) e gli errori di caricamento dei file non vengono ritentati. Il servizio Batch ritenta l'attività fino al limite specificato dai vincoli.

startTime

string

Ora di avvio dell'esecuzione di StartTask.
Questo valore viene reimpostato ogni volta che l'attività viene riavviata o ritentata( ovvero l'ora più recente in cui StartTask ha avviato l'esecuzione).

state

StartTaskState

Stato di StartTask nel nodo di calcolo.

StartTaskState

Stato di StartTask nel nodo di calcolo.

Nome Tipo Descrizione
completed

string

StartTask è stato chiuso con codice di uscita 0 oppure StartTask non è riuscito e il limite di tentativi è stato raggiunto oppure il processo StartTask non è stato eseguito a causa di errori di preparazione delle attività (ad esempio errori di download del file di risorse).

running

string

StartTask è attualmente in esecuzione.

TaskContainerExecutionInformation

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

Nome Tipo Descrizione
containerId

string

ID del contenitore.

error

string

Informazioni dettagliate sull'errore sul contenitore.
Questa è la stringa di errore dettagliata del servizio Docker, se disponibile. Equivale al campo di errore restituito da "docker inspect".

state

string

Stato del contenitore.
Questo è lo stato del contenitore in base al servizio Docker. Equivale al campo di stato restituito da "docker inspect".

TaskContainerSettings

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

Immagine da usare per creare il contenitore in cui verrà eseguita l'attività.
Si tratta del riferimento completo all'immagine, come specificato in "docker pull". Se non viene specificato alcun tag come parte del nome dell'immagine, il tag ":latest" viene usato come valore predefinito.

registry

ContainerRegistry

Registro privato che contiene l'immagine del contenitore.
Questa impostazione può essere omessa se è già stata specificata durante la creazione del pool.

workingDirectory

ContainerWorkingDirectory

Percorso della directory di lavoro dell'attività del contenitore.
Il valore predefinito è 'taskWorkingDirectory'.

TaskExecutionInformation

Informazioni sull'esecuzione di un'attività.

Nome Tipo Descrizione
containerInfo

TaskContainerExecutionInformation

Informazioni sul contenitore in cui è in esecuzione l'attività.
Questa proprietà viene impostata solo se l'attività viene eseguita in un contesto contenitore.

endTime

string

Ora di completamento dell'attività.
Questa proprietà viene impostata solo se l'oggetto Task è nello stato Completato.

exitCode

integer

Codice di uscita del programma specificato nella riga di comando Task.
Questa proprietà viene impostata solo se l'oggetto Task è nello stato completato. In generale, il codice di uscita per un processo riflette la convenzione specifica implementata dallo sviluppatore dell'applicazione per tale processo. Se si usa il valore del codice di uscita per prendere decisioni nel codice, assicurarsi di conoscere la convenzione di codice di uscita usata dal processo dell'applicazione. Tuttavia, se il servizio Batch termina l'attività (a causa del timeout o della terminazione dell'utente tramite l'API), è possibile che venga visualizzato un codice di uscita definito dal sistema operativo.

failureInfo

TaskFailureInformation

Informazioni che descrivono l'errore dell'attività, se presenti.
Questa proprietà viene impostata solo se l'oggetto Task è nello stato completato e si è verificato un errore.

lastRequeueTime

string

Ora più recente in cui l'attività è stata riquedata dal servizio Batch come risultato di una richiesta utente.
Questa proprietà viene impostata solo se requeueCount è diverso da zero.

lastRetryTime

string

Ora più recente in cui è stata avviata l'esecuzione di un nuovo tentativo dell'attività.
Questo elemento è presente solo se l'attività è stata ritentata (ad esempio retryCount è diverso da zero). Se presente, si tratta in genere dello stesso valore di startTime, ma può essere diverso se l'attività è stata riavviata per motivi diversi dai tentativi; Ad esempio, se il nodo di calcolo è stato riavviato durante un nuovo tentativo, startTime viene aggiornato ma lastRetryTime non è.

requeueCount

integer

Numero di volte in cui l'attività è stata accodata dal servizio Batch come risultato di una richiesta utente.
Quando l'utente rimuove i nodi di calcolo da un pool (ridimensionando/compattando il pool) o quando il processo è disabilitato, l'utente può specificare che l'esecuzione di attività nei nodi di calcolo viene riquedata per l'esecuzione. Questo conteggio tiene traccia del numero di volte in cui l'attività è stata riquedata per questi motivi.

result

TaskExecutionResult

Risultato dell'esecuzione dell'attività.
Se il valore è "failed", i dettagli dell'errore sono disponibili nella proprietà failureInfo.

retryCount

integer

Numero di tentativi di esecuzione dell'attività da parte del servizio Batch.
Gli errori dell'applicazione attività (codice di uscita diverso da zero) vengono ritentati, vengono eseguiti errori di pre-elaborazione (non è stato possibile eseguire l'attività) e gli errori di caricamento dei file non vengono ritentati. Il servizio Batch ritenta l'attività fino al limite specificato dai vincoli.

startTime

string

Ora in cui è stata avviata l'esecuzione dell'attività.
'Running' corrisponde allo stato di esecuzione, quindi se l'attività specifica i file di risorse o i pacchetti, l'ora di inizio riflette l'ora di inizio in cui l'attività ha avviato il download o la distribuzione di tali file. Se l'attività è stata riavviata o ritentata, si tratta dell'ora più recente in cui l'attività è stata avviata l'esecuzione. Questa proprietà è presente solo per Attività che si trovano nello stato in esecuzione o completato.

TaskExecutionResult

Risultato dell'esecuzione dell'attività.

Nome Tipo Descrizione
failure

string

Si è verificato un errore durante l'elaborazione dell'attività. L'errore potrebbe essersi verificato prima dell'avvio del processo attività, durante l'esecuzione del processo attività o dopo l'uscita del processo Attività.

success

string

L'attività è stata eseguita correttamente.

TaskFailureInformation

Informazioni su un errore di attività.

Nome Tipo Descrizione
category

ErrorCategory

Categoria dell'errore Attività.

code

string

Identificatore per l'errore task. I codici sono invarianti e devono essere utilizzati a livello di codice.

details

NameValuePair[]

Elenco di dettagli aggiuntivi relativi all'errore.

message

string

Messaggio che descrive l'errore dell'attività, destinato a essere adatto per la visualizzazione in un'interfaccia utente.

TaskInformation

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

Nome Tipo Descrizione
executionInfo

TaskExecutionInformation

Informazioni sull'esecuzione dell'attività.

jobId

string

ID del processo a cui appartiene l'attività.

subtaskId

integer

ID della sottoattività se l'attività è un'attività a istanza multipla.

taskId

string

ID dell'attività.

taskState

TaskState

Stato corrente dell'attività.

taskUrl

string

URL dell'attività.

TaskState

Stato dell'attività.

Nome Tipo Descrizione
active

string

L'attività è in coda e può essere eseguita, ma non è attualmente assegnata a un nodo di calcolo. Un'attività entra in questo stato quando viene creata, quando è abilitata dopo essere stata disabilitata o quando è in attesa di un nuovo tentativo dopo un'esecuzione non riuscita.

completed

string

L'attività non è più idonea per l'esecuzione, in genere perché l'attività è stata completata correttamente o l'attività è stata completata in modo non riuscito e ha esaurito il limite di tentativi. Un'attività viene contrassegnata anche come completata se si è verificato un errore durante l'avvio dell'attività o quando l'attività è stata terminata.

preparing

string

L'attività è stata assegnata a un nodo di calcolo, ma è in attesa del completamento di un'attività di preparazione del processo necessaria nel nodo di calcolo. Se l'attività di preparazione del processo ha esito positivo, l'attività verrà spostata in esecuzione. Se l'attività di preparazione del processo ha esito negativo, l'attività tornerà attiva e sarà idonea per l'assegnazione a un nodo di calcolo diverso.

running

string

L'attività è in esecuzione in un nodo di calcolo. Ciò include la preparazione a livello di attività, ad esempio il download di file di risorse o la distribuzione di pacchetti specificati nell'attività, non significa necessariamente che la riga di comando attività abbia avviato l'esecuzione.

UserIdentity

Definizione dell'identità utente in cui viene eseguita l'attività.

Nome Tipo Descrizione
autoUser

AutoUserSpecification

Utente automatico con cui viene eseguita l'attività.
Le proprietà userName e autoUser si escludono a vicenda; è necessario specificarne uno ma non entrambi.

username

string

Nome dell'identità utente con cui viene eseguita l'attività.
Le proprietà userName e autoUser si escludono a vicenda; è necessario specificarne uno ma non entrambi.

VirtualMachineInfo

Informazioni sullo stato corrente della macchina virtuale.

Nome Tipo Descrizione
imageReference

ImageReference

Riferimento all'immagine del Marketplace della macchina virtuale di Azure.

scaleSetVmResourceId

string

ID risorsa della macchina virtuale corrente del set di scalabilità di macchine virtuali del nodo di calcolo. Definito solo se l'account Batch è stato creato con la proprietà poolAllocationMode impostata su 'UserSubscription'.