CloudTask interface

Pacchetto:

@azure/batch

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.

Proprietà

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. I pacchetti dell'applicazione vengono scaricati e distribuiti in una directory condivisa, non nella directory di lavoro attività. Pertanto, se un pacchetto a cui si fa riferimento è già presente nel nodo ed è aggiornato, non viene scaricato nuovamente; viene usata la copia esistente nel nodo di calcolo. Se non è possibile installare un pacchetto a cui si fa riferimento, ad esempio perché il pacchetto è stato eliminato o perché il download non è riuscito, l'attività ha esito negativo.
authenticationTokenSettings	Impostazioni per un token di autenticazione che l'attività può usare per eseguire operazioni del servizio Batch. Se questa proprietà è impostata, il servizio Batch fornisce all'attività un token di autenticazione che può essere usato per autenticare le operazioni del servizio Batch senza richiedere una chiave di accesso dell'account. Il token viene fornito tramite la variabile di ambiente AZ_BATCH_AUTHENTICATION_TOKEN. Le operazioni che l'attività può eseguire usando il token dipendono dalle impostazioni. Ad esempio, un'attività può richiedere autorizzazioni di processo per aggiungere altre attività al processo o controllare lo stato del processo o di altre attività nel processo.
commandLine	Riga di comando dell'attività. Per le attività a istanze multiple, la riga di comando viene eseguita come attività primaria, dopo che l'attività primaria e tutte le sottoattività hanno terminato l'esecuzione della riga di comando di coordinamento. 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/en-us/azure/batch/batch-compute-node-environment-variables).
constraints	Vincoli di esecuzione che si applicano a questa attività.
containerSettings	Impostazioni per il contenitore in cui viene eseguita l'attività. Se il pool che eseguirà questa attività ha impostato containerConfiguration, è necessario impostare anche questo valore. Se il pool che eseguirà questa attività non include containerConfiguration impostato, non deve essere impostato. 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.
creationTime	Ora di creazione dell'attività.
dependsOn	Le attività da cui dipende questa attività. Questa attività non verrà pianificata fino a quando tutte le attività da cui dipende non sono state completate correttamente. Se una di queste attività non riesce e esaurisce il numero di tentativi, questa attività non verrà mai pianificata.
displayName	Nome visualizzato per l'attività. Il nome visualizzato non deve essere univoco e può contenere caratteri Unicode fino a una lunghezza massima di 1024.
environmentSettings	Elenco delle impostazioni delle variabili di ambiente per l'attività.
eTag	ETag dell'attività. Si tratta di una stringa opaca. È possibile usarlo per rilevare se l'attività è cambiata tra le richieste. In particolare, è possibile passare l'ETag durante l'aggiornamento di un'attività per specificare che le modifiche devono essere applicate solo se nessun altro utente ha modificato l'attività nel frattempo.
executionInfo	Informazioni sull'esecuzione dell'attività.
exitConditions	Risposta del servizio Batch al completamento dell'attività.
id	Stringa che identifica in modo univoco l'attività all'interno del processo. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura, e non può contenere più di 64 caratteri.
lastModified	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. Per le attività a istanze multiple, i file verranno caricati solo dal nodo di calcolo in cui viene eseguita l'attività primaria.
previousState	Stato precedente dell'attività. Questa proprietà non è impostata se l'oggetto Task è nello stato Attivo iniziale. I valori possibili includono: 'active', 'preparing', 'running', 'completed'
previousStateTransitionTime	Ora in cui l'attività ha immesso lo stato precedente. Questa proprietà non è impostata se l'oggetto Task è nello stato Attivo iniziale.
requiredSlots	Numero di slot di pianificazione necessari per l'esecuzione dell'attività. Il valore predefinito è 1. Un'attività può essere pianificata solo per l'esecuzione in un nodo di calcolo se il nodo dispone di slot di pianificazione gratuiti sufficienti. Per le attività a istanze multiple, deve essere 1.
resourceFiles	Elenco di file scaricati dal servizio Batch nel nodo di calcolo prima di eseguire la riga di comando. Per le attività a istanze multiple, i file di risorse verranno scaricati solo nel nodo di calcolo in cui viene eseguita l'attività primaria. È 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.
state	Stato corrente dell'attività. I valori possibili includono: 'active', 'preparing', 'running', 'completed'
stateTransitionTime	Ora in cui l'attività ha immesso lo stato corrente.
stats	Statistiche sull'utilizzo delle risorse per l'attività.
url	URL dell'attività.
userIdentity	Identità utente con cui viene eseguita l'attività. Se omesso, l'attività viene eseguita come utente non amministrativo univoco per l'attività.

Dettagli proprietà

affinityInfo

Hint di località che può essere usato dal servizio Batch per selezionare un nodo di calcolo in cui avviare la nuova attività.

affinityInfo?: AffinityInformation

Valore della proprietà

AffinityInformation

applicationPackageReferences

Elenco di pacchetti che il servizio Batch distribuirà nel nodo di calcolo prima di eseguire la riga di comando. I pacchetti dell'applicazione vengono scaricati e distribuiti in una directory condivisa, non nella directory di lavoro attività. Pertanto, se un pacchetto a cui si fa riferimento è già presente nel nodo ed è aggiornato, non viene scaricato nuovamente; viene usata la copia esistente nel nodo di calcolo. Se non è possibile installare un pacchetto a cui si fa riferimento, ad esempio perché il pacchetto è stato eliminato o perché il download non è riuscito, l'attività ha esito negativo.

applicationPackageReferences?: ApplicationPackageReference[]

Valore della proprietà

ApplicationPackageReference[]

authenticationTokenSettings

Impostazioni per un token di autenticazione che l'attività può usare per eseguire operazioni del servizio Batch. Se questa proprietà è impostata, il servizio Batch fornisce all'attività un token di autenticazione che può essere usato per autenticare le operazioni del servizio Batch senza richiedere una chiave di accesso dell'account. Il token viene fornito tramite la variabile di ambiente AZ_BATCH_AUTHENTICATION_TOKEN. Le operazioni che l'attività può eseguire usando il token dipendono dalle impostazioni. Ad esempio, un'attività può richiedere autorizzazioni di processo per aggiungere altre attività al processo o controllare lo stato del processo o di altre attività nel processo.

authenticationTokenSettings?: AuthenticationTokenSettings

Valore della proprietà

AuthenticationTokenSettings

commandLine

Riga di comando dell'attività. Per le attività a istanze multiple, la riga di comando viene eseguita come attività primaria, dopo che l'attività primaria e tutte le sottoattività hanno terminato l'esecuzione della riga di comando di coordinamento. 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/en-us/azure/batch/batch-compute-node-environment-variables).

commandLine?: string

Valore della proprietà

string

constraints

Vincoli di esecuzione che si applicano a questa attività.

constraints?: TaskConstraints

Valore della proprietà

TaskConstraints

containerSettings

Impostazioni per il contenitore in cui viene eseguita l'attività. Se il pool che eseguirà questa attività ha impostato containerConfiguration, è necessario impostare anche questo valore. Se il pool che eseguirà questa attività non include containerConfiguration impostato, non deve essere impostato. 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.

containerSettings?: TaskContainerSettings

Valore della proprietà

TaskContainerSettings

creationTime

Ora di creazione dell'attività.

creationTime?: Date

Valore della proprietà

Date

dependsOn

Le attività da cui dipende questa attività. Questa attività non verrà pianificata fino a quando tutte le attività da cui dipende non sono state completate correttamente. Se una di queste attività non riesce e esaurisce il numero di tentativi, questa attività non verrà mai pianificata.

dependsOn?: TaskDependencies

Valore della proprietà

TaskDependencies

displayName

Nome visualizzato per l'attività. Il nome visualizzato non deve essere univoco e può contenere caratteri Unicode fino a una lunghezza massima di 1024.

displayName?: string

Valore della proprietà

string

environmentSettings

Elenco delle impostazioni delle variabili di ambiente per l'attività.

environmentSettings?: EnvironmentSetting[]

Valore della proprietà

EnvironmentSetting[]

eTag

ETag dell'attività. Si tratta di una stringa opaca. È possibile usarlo per rilevare se l'attività è cambiata tra le richieste. In particolare, è possibile passare l'ETag durante l'aggiornamento di un'attività per specificare che le modifiche devono essere applicate solo se nessun altro utente ha modificato l'attività nel frattempo.

eTag?: string

Valore della proprietà

string

executionInfo

Informazioni sull'esecuzione dell'attività.

executionInfo?: TaskExecutionInformation

Valore della proprietà

TaskExecutionInformation

exitConditions

Risposta del servizio Batch al completamento dell'attività.

exitConditions?: ExitConditions

Valore della proprietà

ExitConditions

id

Stringa che identifica in modo univoco l'attività all'interno del processo. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura, e non può contenere più di 64 caratteri.

id?: string

Valore della proprietà

string

lastModified

Ora dell'ultima modifica dell'attività.

lastModified?: Date

Valore della proprietà

Date

multiInstanceSettings

Oggetto che indica che l'attività è un'attività a istanze multipla e contiene informazioni su come eseguire l'attività a istanze multipla.

multiInstanceSettings?: MultiInstanceSettings

Valore della proprietà

MultiInstanceSettings

nodeInfo

Informazioni sul nodo di calcolo in cui è stata eseguita l'attività.

nodeInfo?: ComputeNodeInformation

Valore della proprietà

ComputeNodeInformation

outputFiles

Elenco di file che il servizio Batch caricherà dal nodo di calcolo dopo l'esecuzione della riga di comando. Per le attività a istanze multiple, i file verranno caricati solo dal nodo di calcolo in cui viene eseguita l'attività primaria.

outputFiles?: OutputFile[]

Valore della proprietà

OutputFile[]

previousState

Stato precedente dell'attività. Questa proprietà non è impostata se l'oggetto Task è nello stato Attivo iniziale. I valori possibili includono: 'active', 'preparing', 'running', 'completed'

previousState?: TaskState

Valore della proprietà

TaskState

previousStateTransitionTime

Ora in cui l'attività ha immesso lo stato precedente. Questa proprietà non è impostata se l'oggetto Task è nello stato Attivo iniziale.

previousStateTransitionTime?: Date

Valore della proprietà

Date

requiredSlots

Numero di slot di pianificazione necessari per l'esecuzione dell'attività. Il valore predefinito è 1. Un'attività può essere pianificata solo per l'esecuzione in un nodo di calcolo se il nodo dispone di slot di pianificazione gratuiti sufficienti. Per le attività a istanze multiple, deve essere 1.

requiredSlots?: number

Valore della proprietà

number

resourceFiles

Elenco di file scaricati dal servizio Batch nel nodo di calcolo prima di eseguire la riga di comando. Per le attività a istanze multiple, i file di risorse verranno scaricati solo nel nodo di calcolo in cui viene eseguita l'attività primaria. È 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.

resourceFiles?: ResourceFile[]

Valore della proprietà

ResourceFile[]

state

Stato corrente dell'attività. I valori possibili includono: 'active', 'preparing', 'running', 'completed'

state?: TaskState

Valore della proprietà

TaskState

stateTransitionTime

Ora in cui l'attività ha immesso lo stato corrente.

stateTransitionTime?: Date

Valore della proprietà

Date

stats

Statistiche sull'utilizzo delle risorse per l'attività.

stats?: TaskStatistics

Valore della proprietà

TaskStatistics

url

URL dell'attività.

url?: string

Valore della proprietà

string

userIdentity

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

userIdentity?: UserIdentity

Valore della proprietà

UserIdentity