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 |
---|---|---|---|---|
batch
|
path | True |
string |
URL di base per tutte le richieste del servizio Azure Batch. |
node
|
path | True |
string |
ID del nodo di calcolo su cui si desidera ottenere informazioni. |
pool
|
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 |
Risposta contenente il nodo di calcolo. Intestazioni
|
|
Other Status Codes |
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 |
---|---|
Auto |
Ambito dell'utente automatico |
Auto |
Specifica i parametri per l'utente automatico che esegue un'attività nel servizio Batch. |
Batch |
Risposta di errore ricevuta dal servizio Azure Batch. |
Batch |
Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch. |
Certificate |
Riferimento a un certificato da installare nei nodi di calcolo in un pool. |
Certificate |
Percorso dell'archivio certificati nel nodo di calcolo in cui installare il certificato. |
Certificate |
Quali account utente nel nodo di calcolo devono avere accesso ai dati privati del certificato. |
Compute |
Nodo di calcolo nel servizio Batch. |
Compute |
Configurazione dell'endpoint per il nodo di calcolo. |
Compute |
Errore rilevato da un nodo di calcolo. |
Compute |
Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo. |
Compute |
Stato corrente del nodo di calcolo. |
Container |
Voce di percorso e modalità di montaggio da montare nel contenitore di attività. |
Container |
Percorsi che verranno montati nel contenitore dell'attività contenitore. |
Container |
Registro contenitori privato. |
Container |
Percorso della directory di lavoro dell'attività del contenitore. |
Elevation |
Livello di elevazione dell'utente. |
Environment |
Variabile di ambiente da impostare in un processo task. |
Error |
Categoria dell'errore. |
Error |
Messaggio di errore ricevuto in una risposta di errore di Azure Batch. |
Image |
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". |
Inbound |
Endpoint in ingresso in un nodo di calcolo. |
Inbound |
Protocollo dell'endpoint. |
Name |
Rappresenta una coppia nome-valore. |
Node |
Informazioni sull'agente del nodo di calcolo. |
Resource |
Un singolo file o più file da scaricare in un nodo di calcolo. |
Scheduling |
Indica se il nodo di calcolo è disponibile per la pianificazione delle attività. |
Start |
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. |
Start |
Informazioni su startTask in esecuzione in un nodo di calcolo. |
Start |
Stato di StartTask nel nodo di calcolo. |
Task |
Contiene informazioni sul contenitore in cui è in esecuzione un'attività. |
Task |
Impostazioni del contenitore per un'attività. |
Task |
Informazioni sull'esecuzione di un'attività. |
Task |
Risultato dell'esecuzione dell'attività. |
Task |
Informazioni su un errore di attività. |
Task |
Informazioni su un'attività in esecuzione in un nodo di calcolo. |
Task |
Stato dell'attività. |
User |
Definizione dell'identità utente in cui viene eseguita l'attività. |
Virtual |
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 |
Livello di elevazione dell'utente automatico. |
|
scope |
Ambito dell'utente automatico |
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 |
Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente. |
|
values |
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 |
Percorso dell'archivio certificati nel nodo di calcolo in cui installare il certificato. |
|
storeName |
string |
Nome dell'archivio certificati nel nodo di calcolo in cui installare il certificato. |
thumbprint |
string |
Identificazione personale del certificato. |
thumbprintAlgorithm |
string |
Algoritmo a cui è associata l'identificazione personale. Deve essere sha1. |
visibility |
Quali account utente nel nodo di calcolo devono avere accesso ai dati privati del certificato. |
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. |
allocationTime |
string |
Ora in cui questo nodo di calcolo è stato allocato al pool. |
certificateReferences |
Elenco dei certificati installati nel nodo di calcolo. Avviso: questa proprietà è deprecata e verrà rimossa dopo febbraio 2024. Usare invece 'estensione Azure KeyVault. |
|
endpointConfiguration |
Configurazione dell'endpoint per il nodo di calcolo. |
|
errors |
Elenco degli errori attualmente rilevati dal nodo di calcolo. |
|
id |
string |
ID del nodo di calcolo. |
ipAddress |
string |
Indirizzo IP che altri nodi possono usare per comunicare con questo nodo 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. |
nodeAgentInfo |
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 |
Elenco di attività il cui stato è stato modificato di recente. |
|
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 |
Indica se il nodo di calcolo è disponibile per la pianificazione delle attività. |
|
startTask |
L'attività specificata per l'esecuzione nel nodo di calcolo durante l'aggiunta al pool. |
|
startTaskInfo |
Informazioni di runtime sull'esecuzione di StartTask nel nodo di calcolo. |
|
state |
Stato corrente del 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 |
Informazioni sullo stato corrente della macchina virtuale. |
|
vmSize |
string |
Dimensioni della macchina virtuale che ospita il nodo di calcolo. |
ComputeNodeEndpointConfiguration
Configurazione dell'endpoint per il nodo di calcolo.
Nome | Tipo | Descrizione |
---|---|---|
inboundEndpoints |
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 |
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). |
source |
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 |
Riferimento all'identità assegnata dall'utente da usare per accedere a un Registro Azure Container invece di nome utente e password. |
|
password |
string |
Password per accedere al server del Registro di sistema. |
registryServer |
string |
URL del Registro di sistema. |
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 |
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. |
publisher |
string |
Autore dell'immagine del Marketplace delle macchine virtuali di Azure. |
sharedGalleryImageId |
string |
Identificatore univoco dell'immagine della raccolta condivisa |
sku |
string |
SKU dell'immagine del Marketplace delle macchine virtuali di Azure. |
version |
string |
Versione dell'immagine marketplace di Macchine virtuali di Azure. |
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. |
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 |
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. |
version |
string |
Versione dell'agente del nodo di calcolo Batch in esecuzione nel nodo di calcolo. |
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. |
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. |
fileMode |
string |
Attributo della modalità di autorizzazione file in formato ottale. |
filePath |
string |
Percorso nel nodo di calcolo in cui scaricare i file rispetto alla directory di lavoro dell'attività. |
httpUrl |
string |
URL del file da scaricare. |
identityReference |
Riferimento all'identità assegnata dall'utente da usare per accedere all'archiviazione BLOB di Azure specificata da storageContainerUrl o httpUrl |
|
storageContainerUrl |
string |
URL del contenitore BLOB all'interno di Archiviazione BLOB di Azure. |
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. |
containerSettings |
Impostazioni per il contenitore in cui viene eseguito StartTask. |
|
environmentSettings |
Elenco delle impostazioni delle variabili di ambiente per StartTask. |
|
maxTaskRetryCount |
integer |
Numero massimo di tentativi dell'attività. |
resourceFiles |
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. |
|
userIdentity |
Identità utente con cui viene eseguito StartTask. |
|
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. |
StartTaskInformation
Informazioni su startTask in esecuzione in un nodo di calcolo.
Nome | Tipo | Descrizione |
---|---|---|
containerInfo |
Informazioni sul contenitore in cui è in esecuzione l'attività. |
|
endTime |
string |
Ora in cui StartTask ha interrotto l'esecuzione. |
exitCode |
integer |
Codice di uscita del programma specificato nella riga di comando StartTask. |
failureInfo |
Informazioni che descrivono l'errore dell'attività, se presenti. |
|
lastRetryTime |
string |
Ora più recente in cui è stata avviata l'esecuzione di un nuovo tentativo dell'attività. |
result |
Risultato dell'esecuzione dell'attività. |
|
retryCount |
integer |
Numero di tentativi di esecuzione dell'attività da parte del servizio Batch. |
startTime |
string |
Ora di avvio dell'esecuzione di StartTask. |
state |
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. |
state |
string |
Stato del contenitore. |
TaskContainerSettings
Impostazioni del contenitore per un'attività.
Nome | Tipo | Descrizione |
---|---|---|
containerHostBatchBindMounts |
Percorsi da montare nell'attività contenitore. |
|
containerRunOptions |
string |
Opzioni aggiuntive per il comando create del contenitore. |
imageName |
string |
Immagine da usare per creare il contenitore in cui verrà eseguita l'attività. |
registry |
Registro privato che contiene l'immagine del contenitore. |
|
workingDirectory |
Percorso della directory di lavoro dell'attività del contenitore. |
TaskExecutionInformation
Informazioni sull'esecuzione di un'attività.
Nome | Tipo | Descrizione |
---|---|---|
containerInfo |
Informazioni sul contenitore in cui è in esecuzione l'attività. |
|
endTime |
string |
Ora di completamento dell'attività. |
exitCode |
integer |
Codice di uscita del programma specificato nella riga di comando Task. |
failureInfo |
Informazioni che descrivono l'errore dell'attività, se presenti. |
|
lastRequeueTime |
string |
Ora più recente in cui l'attività è stata riquedata dal servizio Batch come risultato di una richiesta utente. |
lastRetryTime |
string |
Ora più recente in cui è stata avviata l'esecuzione di un nuovo tentativo dell'attività. |
requeueCount |
integer |
Numero di volte in cui l'attività è stata accodata dal servizio Batch come risultato di una richiesta utente. |
result |
Risultato dell'esecuzione dell'attività. |
|
retryCount |
integer |
Numero di tentativi di esecuzione dell'attività da parte del servizio Batch. |
startTime |
string |
Ora in cui è stata avviata l'esecuzione dell'attività. |
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 |
Categoria dell'errore Attività. |
|
code |
string |
Identificatore per l'errore task. I codici sono invarianti e devono essere utilizzati a livello di codice. |
details |
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 |
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 |
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 |
Utente automatico con cui viene eseguita l'attività. |
|
username |
string |
Nome dell'identità utente con cui viene eseguita l'attività. |
VirtualMachineInfo
Informazioni sullo stato corrente della macchina virtuale.
Nome | Tipo | Descrizione |
---|---|---|
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'. |