CloudTask interface

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

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.

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.

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

Vincoli di esecuzione che si applicano a questa attività.

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.

Ora di creazione dell'attività.

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.

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

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

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.

Informazioni sull'esecuzione dell'attività.

Risposta del servizio Batch al completamento dell'attività.

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.

Ora dell'ultima modifica dell'attività.

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

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

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.

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

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

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.

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.

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

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

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

URL dell'attività.

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