Task - Get
Ottiene informazioni sull'attività specificata.
Per le attività a istanze multiple, informazioni quali affinityId, executionInfo e nodeInfo fanno riferimento all'attività primaria. Usare l'API list subtasks per recuperare informazioni sulle sottoattività.
GET {batchUrl}/jobs/{jobId}/tasks/{taskId}?api-version=2024-07-01.20.0
GET {batchUrl}/jobs/{jobId}/tasks/{taskId}?$select={$select}&$expand={$expand}&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. |
job
|
path | True |
string |
ID del processo che contiene l'attività. |
task
|
path | True |
string |
ID dell'attività per ottenere informazioni. |
api-version
|
query | True |
string |
Versione dell'API client. |
$expand
|
query |
string |
Clausola di $expand OData. |
|
$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. |
|
If-Match |
string |
Valore ETag associato alla versione della risorsa nota al client. L'operazione verrà eseguita solo se l'ETag corrente della risorsa nel servizio corrisponde esattamente al valore specificato dal client. |
|
If-None-Match |
string |
Valore ETag associato alla versione della risorsa nota al client. L'operazione verrà eseguita solo se l'ETag corrente della risorsa nel servizio non corrisponde al valore specificato dal client. |
|
If-Modified-Since |
string date-time-rfc1123 |
Timestamp che indica l'ora dell'ultima modifica della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio è stata modificata dall'ora specificata. |
|
If-Unmodified-Since |
string date-time-rfc1123 |
Timestamp che indica l'ora dell'ultima modifica della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio non è stata modificata dall'ora specificata. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Risposta contenente l'attività. 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
Task get
Esempio di richiesta
GET account.region.batch.azure.com/jobs/jobId/tasks/taskId?api-version=2024-07-01.20.0
Risposta di esempio
{
"id": "testTask",
"url": "https://account.region.batch.azure.com/jobs/jobId/tasks/taskId",
"eTag": "0x8D3D62350711C55",
"creationTime": "2016-09-06T06:59:15.1161429Z",
"lastModified": "2016-09-06T06:59:15.1161429Z",
"state": "active",
"stateTransitionTime": "2016-09-06T06:59:15.1161429Z",
"commandLine": "cmd /c hostname",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"multiInstanceSettings": {
"numberOfInstances": 3,
"coordinationCommandLine": "cmd /c echo coordinating"
},
"constraints": {
"maxWallClockTime": "P10675199DT2H48M5.4775807S",
"retentionTime": "P10675199DT2H48M5.4775807S",
"maxTaskRetryCount": 0
},
"requiredSlots": 2,
"executionInfo": {
"retryCount": 0,
"requeueCount": 0
}
}
Definizioni
Nome | Descrizione |
---|---|
Access |
Risorse batch a cui il token concede l'accesso. |
Affinity |
Hint di località che può essere usato dal servizio Batch per selezionare un nodo di calcolo in cui avviare un'attività. |
Application |
Riferimento a un pacchetto da distribuire nei nodi di calcolo. |
Authentication |
Impostazioni per un token di autenticazione che l'attività può usare per eseguire operazioni del servizio Batch. |
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. |
Cloud |
Un'attività di Azure Batch. |
Compute |
Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo. |
Compute |
Informazioni sul nodo di calcolo in cui è stata eseguita un'attività. |
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. |
Dependency |
Azione eseguita dal servizio Batch in Attività che dipendono da questa attività. |
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. |
Exit |
Modalità di risposta del servizio Batch se un'attività viene chiusa con un codice di uscita specifico. |
Exit |
Un intervallo di codici di uscita e il modo in cui il servizio Batch deve rispondere ai codici di uscita all'interno di tale intervallo. |
Exit |
Specifica la modalità di risposta del servizio Batch al termine dell'attività. |
Exit |
Specifica il modo in cui il servizio Batch risponde a una determinata condizione di uscita. |
Http |
Coppia nome-valore intestazione HTTP |
Job |
Azione da eseguire sul processo contenente l'attività, se l'attività viene completata con la condizione di uscita specificata e la proprietà onTaskFailed di Job è "performExitOptionsJobAction". |
Multi |
Impostazioni che specificano come eseguire un'attività a istanze multipla. |
Name |
Rappresenta una coppia nome-valore. |
Output |
Specifica per il caricamento di file da un nodo di calcolo di Azure Batch in un'altra posizione dopo che il servizio Batch ha terminato l'esecuzione del processo attività. |
Output |
Specifica una destinazione di caricamento di file all'interno di un contenitore di archiviazione BLOB di Azure. |
Output |
Destinazione in cui caricare un file. |
Output |
Condizioni in base alle quali deve essere caricato un file di output attività o un set di file. |
Output |
Informazioni dettagliate su un'operazione di caricamento dei file di output, incluse le condizioni per eseguire il caricamento. |
Resource |
Un singolo file o più file da scaricare in un nodo di calcolo. |
Task |
Vincoli di esecuzione da applicare a un'attività. |
Task |
Contiene informazioni sul contenitore in cui è in esecuzione un'attività. |
Task |
Impostazioni del contenitore per un'attività. |
Task |
Specifica le dipendenze di un'attività. Qualsiasi attività specificata in modo esplicito o all'interno di un intervallo di dipendenze deve essere completata prima che l'attività dipendente venga pianificata. |
Task |
Informazioni sull'esecuzione di un'attività. |
Task |
Risultato dell'esecuzione dell'attività. |
Task |
Informazioni su un errore di attività. |
Task |
Intervallo di ID attività da cui può dipendere un'attività. Tutte le attività con ID nell'intervallo devono essere completate correttamente prima che l'attività dipendente possa essere pianificata. |
Task |
Stato dell'attività. |
Task |
Statistiche di utilizzo delle risorse per un'attività. |
User |
Definizione dell'identità utente in cui viene eseguita l'attività. |
AccessScope
Risorse batch a cui il token concede l'accesso.
Nome | Tipo | Descrizione |
---|---|---|
job |
string |
Concede l'accesso per eseguire tutte le operazioni sul processo contenente l'attività. |
AffinityInformation
Hint di località che può essere usato dal servizio Batch per selezionare un nodo di calcolo in cui avviare un'attività.
Nome | Tipo | Descrizione |
---|---|---|
affinityId |
string |
Stringa opaca che rappresenta la posizione di un nodo di calcolo o di un'attività eseguita in precedenza. |
ApplicationPackageReference
Riferimento a un pacchetto da distribuire nei nodi di calcolo.
Nome | Tipo | Descrizione |
---|---|---|
applicationId |
string |
ID dell'applicazione da distribuire. |
version |
string |
Versione dell'applicazione da distribuire. Se omesso, viene distribuita la versione predefinita. |
AuthenticationTokenSettings
Impostazioni per un token di autenticazione che l'attività può usare per eseguire operazioni del servizio Batch.
Nome | Tipo | Descrizione |
---|---|---|
access |
Risorse batch a cui il token concede l'accesso. |
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. |
CloudTask
Un'attività di Azure Batch.
Nome | Tipo | Descrizione |
---|---|---|
affinityInfo |
Hint di località che può essere usato dal servizio Batch per selezionare un nodo di calcolo in cui avviare la nuova attività. |
|
applicationPackageReferences |
Elenco di pacchetti che il servizio Batch distribuirà nel nodo di calcolo prima di eseguire la riga di comando. |
|
authenticationTokenSettings |
Impostazioni per un token di autenticazione che l'attività può usare per eseguire operazioni del servizio Batch. |
|
commandLine |
string |
Riga di comando dell'attività. |
constraints |
Vincoli di esecuzione che si applicano a questa attività. |
|
containerSettings |
Impostazioni per il contenitore in cui viene eseguita l'attività. |
|
creationTime |
string |
Ora di creazione dell'attività. |
dependsOn |
Le attività da cui dipende questa attività. |
|
displayName |
string |
Nome visualizzato per l'attività. |
eTag |
string |
ETag dell'attività. |
environmentSettings |
Elenco delle impostazioni delle variabili di ambiente per l'attività. |
|
executionInfo |
Informazioni sull'esecuzione dell'attività. |
|
exitConditions |
Specifica la modalità di risposta del servizio Batch al termine dell'attività. |
|
id |
string |
Stringa che identifica in modo univoco l'attività all'interno del processo. |
lastModified |
string |
Ora dell'ultima modifica dell'attività. |
multiInstanceSettings |
Oggetto che indica che l'attività è un'attività a istanze multipla e contiene informazioni su come eseguire l'attività a istanze multipla. |
|
nodeInfo |
Informazioni sul nodo di calcolo in cui è stata eseguita l'attività. |
|
outputFiles |
Elenco di file che il servizio Batch caricherà dal nodo di calcolo dopo l'esecuzione della riga di comando. |
|
previousState |
Stato precedente dell'attività. |
|
previousStateTransitionTime |
string |
Ora in cui l'attività ha immesso lo stato precedente. |
requiredSlots |
integer |
Numero di slot di pianificazione necessari per l'esecuzione dell'attività. |
resourceFiles |
Elenco di file scaricati dal servizio Batch nel nodo di calcolo prima di eseguire la riga di comando. |
|
state |
Stato corrente dell'attività. |
|
stateTransitionTime |
string |
Ora in cui l'attività ha immesso lo stato corrente. |
stats |
Statistiche sull'utilizzo delle risorse per l'attività. |
|
url |
string |
URL dell'attività. |
userIdentity |
Identità utente con cui viene eseguita l'attività. |
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. |
ComputeNodeInformation
Informazioni sul nodo di calcolo in cui è stata eseguita un'attività.
Nome | Tipo | Descrizione |
---|---|---|
affinityId |
string |
Identificatore del nodo in cui è stata eseguita l'attività, che può essere passato quando si aggiunge un'attività per richiedere che l'attività sia pianificata in questo nodo di calcolo. |
nodeId |
string |
ID del nodo di calcolo in cui è stata eseguita l'attività. |
nodeUrl |
string |
URL del nodo di calcolo in cui è stata eseguita l'attività. |
poolId |
string |
ID del pool in cui è stata eseguita l'attività. |
taskRootDirectory |
string |
Directory radice dell'attività nel nodo di calcolo. |
taskRootDirectoryUrl |
string |
URL della directory radice dell'attività nel nodo di calcolo. |
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. |
DependencyAction
Azione eseguita dal servizio Batch in Attività che dipendono da questa attività.
Nome | Tipo | Descrizione |
---|---|---|
block |
string |
Blocca le attività in attesa di questa attività, impedendone la pianificazione. |
satisfy |
string |
Soddisfare le attività in attesa di questa attività; una volta soddisfatte tutte le dipendenze, l'attività verrà pianificata per l'esecuzione. |
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. |
ExitCodeMapping
Modalità di risposta del servizio Batch se un'attività viene chiusa con un codice di uscita specifico.
Nome | Tipo | Descrizione |
---|---|---|
code |
integer |
Codice di uscita del processo. |
exitOptions |
Modalità di risposta del servizio Batch se l'attività viene chiusa con questo codice di uscita. |
ExitCodeRangeMapping
Un intervallo di codici di uscita e il modo in cui il servizio Batch deve rispondere ai codici di uscita all'interno di tale intervallo.
Nome | Tipo | Descrizione |
---|---|---|
end |
integer |
Ultimo codice di uscita nell'intervallo. |
exitOptions |
Modalità di risposta del servizio Batch se l'attività viene chiusa con un codice di uscita nell'intervallo di inizio alla fine (inclusivo). |
|
start |
integer |
Primo codice di uscita nell'intervallo. |
ExitConditions
Specifica la modalità di risposta del servizio Batch al termine dell'attività.
Nome | Tipo | Descrizione |
---|---|---|
default |
Modalità di risposta del servizio Batch se l'attività ha esito negativo con una condizione di uscita non coperta da nessuna delle altre proprietà. |
|
exitCodeRanges |
Elenco di intervalli di codice di uscita dell'attività e modalità di risposta del servizio Batch. |
|
exitCodes |
Elenco dei singoli codici di uscita delle attività e del modo in cui il servizio Batch deve rispondere. |
|
fileUploadError |
Modalità di risposta del servizio Batch se si verifica un errore di caricamento di file. |
|
preProcessingError |
Risposta del servizio Batch se l'attività non viene avviata a causa di un errore. |
ExitOptions
Specifica il modo in cui il servizio Batch risponde a una determinata condizione di uscita.
Nome | Tipo | Descrizione |
---|---|---|
dependencyAction |
Azione eseguita dal servizio Batch in Attività che dipendono da questa attività. |
|
jobAction |
Azione da eseguire sul processo contenente l'attività, se l'attività viene completata con la condizione di uscita specificata e la proprietà onTaskFailed di Job è "performExitOptionsJobAction". |
HttpHeader
Coppia nome-valore intestazione HTTP
Nome | Tipo | Descrizione |
---|---|---|
name |
string |
Nome senza distinzione tra maiuscole e minuscole dell'intestazione da usare durante il caricamento dei file di output |
value |
string |
Valore dell'intestazione da usare durante il caricamento dei file di output |
JobAction
Azione da eseguire sul processo contenente l'attività, se l'attività viene completata con la condizione di uscita specificata e la proprietà onTaskFailed di Job è "performExitOptionsJobAction".
Nome | Tipo | Descrizione |
---|---|---|
disable |
string |
Disabilitare il processo. Equivale a chiamare l'API di disabilitazione del processo, con un valore disableTasks di accodamento. |
none |
string |
Non eseguire alcuna azione. |
terminate |
string |
Terminare il processo. TerminateReason in executionInfo del processo è impostato su "TaskFailed". |
MultiInstanceSettings
Impostazioni che specificano come eseguire un'attività a istanze multipla.
Nome | Tipo | Descrizione |
---|---|---|
commonResourceFiles |
Elenco di file scaricati dal servizio Batch prima di eseguire la riga di comando di coordinamento. |
|
coordinationCommandLine |
string |
Riga di comando da eseguire in tutti i nodi di calcolo per consentire loro di coordinare quando il database primario esegue il comando task principale. |
numberOfInstances |
integer |
Numero di nodi di calcolo richiesti dall'attività. |
NameValuePair
Rappresenta una coppia nome-valore.
Nome | Tipo | Descrizione |
---|---|---|
name |
string |
Nome nella coppia nome-valore. |
value |
string |
Valore nella coppia nome-valore. |
OutputFile
Specifica per il caricamento di file da un nodo di calcolo di Azure Batch in un'altra posizione dopo che il servizio Batch ha terminato l'esecuzione del processo attività.
Nome | Tipo | Descrizione |
---|---|---|
destination |
Destinazione dei file di output. |
|
filePattern |
string |
Modello che indica quali file caricare. |
uploadOptions |
Opzioni aggiuntive per l'operazione di caricamento, incluse le condizioni per eseguire il caricamento. |
OutputFileBlobContainerDestination
Specifica una destinazione di caricamento di file all'interno di un contenitore di archiviazione BLOB di Azure.
Nome | Tipo | Descrizione |
---|---|---|
containerUrl |
string |
URL del contenitore all'interno di Archiviazione BLOB di Azure in cui caricare i file. |
identityReference |
Riferimento all'identità assegnata dall'utente da usare per accedere all'archiviazione BLOB di Azure specificata da containerUrl |
|
path |
string |
BLOB di destinazione o directory virtuale all'interno del contenitore di Archiviazione di Azure. |
uploadHeaders |
Elenco di coppie nome-valore per le intestazioni da usare nel caricamento dei file di output |
OutputFileDestination
Destinazione in cui caricare un file.
Nome | Tipo | Descrizione |
---|---|---|
container |
Percorso nell'archivio BLOB di Azure in cui vengono caricati i file. |
OutputFileUploadCondition
Condizioni in base alle quali deve essere caricato un file di output attività o un set di file.
Nome | Tipo | Descrizione |
---|---|---|
taskcompletion |
string |
Caricare i file dopo l'uscita del processo attività, indipendentemente dal codice di uscita. |
taskfailure |
string |
Caricare i file solo dopo che il processo attività viene chiuso con un codice di uscita diverso da zero. |
tasksuccess |
string |
Caricare i file solo dopo la chiusura del processo attività con un codice di uscita pari a 0. |
OutputFileUploadOptions
Informazioni dettagliate su un'operazione di caricamento dei file di output, incluse le condizioni per eseguire il caricamento.
Nome | Tipo | Descrizione |
---|---|---|
uploadCondition |
Condizioni in base alle quali deve essere caricato il file o il set di file di output dell'attività. |
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. |
TaskConstraints
Vincoli di esecuzione da applicare a un'attività.
Nome | Tipo | Descrizione |
---|---|---|
maxTaskRetryCount |
integer |
Numero massimo di tentativi dell'attività. Il servizio Batch ritenta un'attività se il codice di uscita è diverso da zero. |
maxWallClockTime |
string |
Tempo massimo trascorso che l'attività può essere eseguita, misurata dal momento in cui viene avviata l'attività. Se l'attività non viene completata entro il limite di tempo, il servizio Batch lo termina. |
retentionTime |
string |
Tempo minimo per conservare la directory Task nel nodo di calcolo in cui è stata eseguita, dal momento in cui viene completata l'esecuzione. Dopo questo periodo, il servizio Batch può eliminare la directory Attività e tutto il relativo contenuto. |
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. |
TaskDependencies
Specifica le dipendenze di un'attività. Qualsiasi attività specificata in modo esplicito o all'interno di un intervallo di dipendenze deve essere completata prima che l'attività dipendente venga pianificata.
Nome | Tipo | Descrizione |
---|---|---|
taskIdRanges |
Elenco di intervalli di ID attività da cui dipende questa attività. Tutte le attività in tutti gli intervalli devono essere completate correttamente prima che l'attività dipendente possa essere pianificata. |
|
taskIds |
string[] |
Elenco di ID attività da cui dipende questa attività. Tutte le attività in questo elenco devono essere completate correttamente prima che l'attività dipendente possa essere pianificata. |
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. |
TaskIdRange
Intervallo di ID attività da cui può dipendere un'attività. Tutte le attività con ID nell'intervallo devono essere completate correttamente prima che l'attività dipendente possa essere pianificata.
Nome | Tipo | Descrizione |
---|---|---|
end |
integer |
Ultimo ID attività nell'intervallo. |
start |
integer |
Primo ID attività nell'intervallo. |
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. |
TaskStatistics
Statistiche di utilizzo delle risorse per un'attività.
Nome | Tipo | Descrizione |
---|---|---|
kernelCPUTime |
string |
Tempo totale cpu in modalità kernel (sommato tra tutti i core e tutti i nodi di calcolo) utilizzato dall'attività. |
lastUpdateTime |
string |
Ora dell'ultimo aggiornamento delle statistiche. Tutte le statistiche sono limitate all'intervallo tra startTime e lastUpdateTime. |
readIOGiB |
number |
I gibibyte totali letti dal disco dall'attività. |
readIOps |
integer |
Numero totale di operazioni di lettura su disco eseguite dall'attività. |
startTime |
string |
Ora di inizio dell'intervallo di tempo coperto dalle statistiche. |
url |
string |
URL delle statistiche. |
userCPUTime |
string |
Tempo totale cpu in modalità utente (sommato tra tutti i core e tutti i nodi di calcolo) utilizzato dall'attività. |
waitTime |
string |
Tempo di attesa totale dell'attività. Il tempo di attesa per un'attività viene definito come tempo trascorso tra la creazione dell'attività e l'inizio dell'esecuzione dell'attività. Se l'attività viene ritentata a causa di errori, il tempo di attesa è l'ora dell'esecuzione più recente dell'attività. |
wallClockTime |
string |
Tempo totale dell'orologio a parete dell'attività. |
writeIOGiB |
number |
I gibibyte totali scritti su disco dall'attività. |
writeIOps |
integer |
Numero totale di operazioni di scrittura su disco eseguite dall'attività. |
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à. |