az batch task
Gestire le attività di Batch.
Comandi
| Nome | Descrizione | Tipo | Status |
|---|---|---|---|
| az batch task create |
Creare attività batch. |
Nucleo | GA |
| az batch task delete |
Elimina un'attività dal processo specificato. |
Nucleo | GA |
| az batch task file |
Gestire i file delle attività di Batch. |
Nucleo | GA |
| az batch task file delete |
Elimina il file attività specificato dal nodo di calcolo in cui è stata eseguita l'attività. |
Nucleo | GA |
| az batch task file download |
Scaricare il contenuto di un file di attività batch. |
Nucleo | GA |
| az batch task file list |
Elenca i file nella directory di un'attività nel nodo di calcolo. |
Nucleo | GA |
| az batch task file show |
Ottiene le proprietà del file attività specificato. |
Nucleo | GA |
| az batch task list |
Elenca tutte le attività associate al processo specificato. |
Nucleo | GA |
| az batch task reactivate |
Riattiva un'attività, consentendone l'esecuzione anche se il numero di tentativi è stato esaurito. |
Nucleo | GA |
| az batch task reset |
Reimpostare le proprietà di un'attività Batch. |
Nucleo | GA |
| az batch task show |
Ottiene informazioni sull'attività specificata. |
Nucleo | GA |
| az batch task stop |
Termina l'attività specificata. |
Nucleo | GA |
| az batch task subtask |
Gestire le informazioni della sottoattività di un'attività Batch. |
Nucleo | GA |
| az batch task subtask list |
Elenca tutte le sottoattività associate all'attività a istanza multipla specificata. |
Nucleo | GA |
az batch task create
Creare attività batch.
az batch task create --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--affinity-id]
[--application-package-references]
[--command-line]
[--environment-settings]
[--json-file]
[--max-task-retry-count]
[--max-wall-clock-time]
[--resource-files]
[--retention-time]
[--task-id]Esempio
Creare un'attività che viene interrotta per 1 minuto.
az batch task create --task-id task1 --job-id job1 --command-line "sleep 60"Parametri necessari
ID del processo contenente l'attività.
Parametri facoltativi
Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.
Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.
Nome dell'account Batch. È necessario solo in alternativa, impostato dalla variabile di ambiente: AZURE_BATCH_ACCOUNT.
Obbligatorio. È possibile passare l'affinityId di un nodo per indicare che questa attività deve essere eseguita in tale 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.
Elenco di ID separati da spazi che specificano i pacchetti dell'applicazione da installare. ID applicazione separati da spazi con versione facoltativa nel formato "id[#version]".
Riga di comando dell'attività. 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.
Elenco delle impostazioni delle variabili di ambiente per l'attività. Valori separati da spazi nel formato 'key=value'.
File contenente le attività da creare in JSON (formattato in modo che corrisponda al corpo della richiesta dell'API REST). Quando si inviano più attività, accetta una matrice di attività o taskAddCollectionParamater. Se si specifica questo parametro, tutti gli altri parametri vengono ignorati.
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 per l'eseguibile task a causa di un codice di uscita diverso da zero. 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à dopo il primo tentativo. 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).
Se non viene specificato, non è previsto alcun limite di tempo per quanto tempo l'attività può essere eseguita.
Elenco di file che il servizio Batch scaricherà nel nodo di calcolo prima di eseguire la riga di comando. Riferimenti a risorse separate da spazi in formato filename=httpurl, con httpurl come qualsiasi URL HTTP con accesso pubblico o url di firma di accesso condiviso con accesso in lettura.
Il valore predefinito è 7 giorni, ad esempio la directory Attività verrà mantenuta per 7 giorni, a meno che il nodo di calcolo non venga rimosso o che il processo venga eliminato.
ID dell'attività.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az batch task delete
Elimina un'attività dal processo specificato.
Quando un'attività viene eliminata, vengono eliminati anche tutti i file nella directory nel nodo di calcolo in cui è stato eseguito (indipendentemente dal tempo di conservazione). Per le attività a istanze multiple, l'operazione di eliminazione dell'attività si applica in modo sincrono all'attività primaria; le sottoattività e i relativi file vengono quindi eliminati in modo asincrono in background.
az batch task delete --job-id
--task-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--yes]Parametri necessari
ID del processo da cui eliminare l'attività. Obbligatorio.
ID dell'attività da eliminare. Obbligatorio.
Parametri facoltativi
Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.
Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.
Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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.
Non richiedere conferma.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az batch task list
Elenca tutte le attività associate al processo specificato.
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à.
az batch task list --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--filter]
[--select]Parametri necessari
ID del processo. Obbligatorio.
Parametri facoltativi
Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.
Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.
Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.
Clausola di $expand OData.
Clausola di $filter OData. Per altre informazioni sulla costruzione di questo filtro, vedere https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.
Clausola di $select OData.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az batch task reactivate
Riattiva un'attività, consentendone l'esecuzione anche se il numero di tentativi è stato esaurito.
La riattivazione rende un'attività idonea per essere ritentata fino al numero massimo di tentativi. Lo stato dell'attività viene modificato in attivo. Poiché l'attività non è più nello stato completato, eventuali informazioni precedenti sul codice di uscita o sugli errori non sono più disponibili dopo la riattivazione. Ogni volta che un'attività viene riattivata, il numero di tentativi viene reimpostato su 0. La riattivazione avrà esito negativo per Le attività non completate o completate in precedenza (con un codice di uscita pari a 0). Inoltre, avrà esito negativo se il processo è stato completato (o termina o elimina).
az batch task reactivate --job-id
--task-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]Parametri necessari
ID del processo contenente l'attività. Obbligatorio.
ID dell'attività da riattivare. Obbligatorio.
Parametri facoltativi
Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.
Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.
Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az batch task reset
Reimpostare le proprietà di un'attività Batch.
az batch task reset --job-id
--task-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--json-file]
[--max-task-retry-count]
[--max-wall-clock-time]
[--retention-time]Esempio
Impostare il numero massimo di tentativi su 3 e reimpostare le altre proprietà sulle impostazioni predefinite
az batch task reset --task-id task1 --job-id job1 --max-task-retry-count 3Parametri necessari
ID del processo contenente l'attività.
ID dell'attività da aggiornare.
Parametri facoltativi
Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.
Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.
Nome dell'account Batch. È necessario solo in alternativa, impostato dalla variabile di ambiente: AZURE_BATCH_ACCOUNT.
L'operazione verrà eseguita solo se l'ETag corrente della risorsa corrisponde esattamente al valore specificato.
L'operazione verrà eseguita solo se la risorsa è stata modificata dopo il timestamp specificato.
L'operazione non verrà eseguita solo se l'ETag corrente della risorsa corrisponde esattamente al valore specificato.
L'operazione non verrà eseguita solo se la risorsa è stata modificata dopo il timestamp specificato.
File contenente la specifica del parametro delle proprietà di aggiornamento del pool in JSON (formattato in modo che corrisponda al corpo della richiesta dell'API REST). Se si specifica questo parametro, tutti gli argomenti del parametro 'Pool Update Properties Parameters' vengono ignorati.
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 per l'eseguibile task a causa di un codice di uscita diverso da zero. 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à dopo il primo tentativo. 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).
Se non viene specificato, non è previsto alcun limite di tempo per quanto tempo l'attività può essere eseguita. Il formato previsto è una durata ISO-8601.
Il valore predefinito è 7 giorni, ad esempio la directory Attività verrà mantenuta per 7 giorni, a meno che il nodo di calcolo non venga rimosso o che il processo venga eliminato. Il formato previsto è una durata ISO-8601.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az batch task show
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à.
az batch task show --job-id
--task-id
[--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--select]Parametri necessari
ID del processo che contiene l'attività. Obbligatorio.
ID dell'attività per ottenere informazioni. Obbligatorio.
Parametri facoltativi
Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.
Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.
Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.
Clausola di $expand OData.
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.
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.
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.
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.
Clausola di $select OData.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az batch task stop
Termina l'attività specificata.
Quando l'attività è stata terminata, passa allo stato completato. Per le attività a istanze multiple, l'operazione di termina attività si applica in modo sincrono all'attività primaria; le sottoattività vengono quindi terminate in modo asincrono in background.
az batch task stop --job-id
--task-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]Parametri necessari
ID del processo contenente l'attività. Obbligatorio.
ID dell'attività da terminare. Obbligatorio.
Parametri facoltativi
Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.
Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.
Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
