az batch job
Nota
Questo gruppo di comandi include comandi definiti sia nell'interfaccia della riga di comando di Azure che in almeno un'estensione. Installare ogni estensione per trarre vantaggio dalle funzionalità estese. Altre informazioni sulle estensioni.
Gestire i processi batch.
Comandi
Nome | Descrizione | Tipo | Status |
---|---|---|---|
az batch job create |
Aggiungere un processo a un account Batch. |
Memoria centrale | Disponibilità generale |
az batch job create (azure-batch-cli-extensions estensione) |
Aggiungere un processo e le attività associate a un account Batch. |
Estensione | Disponibilità generale |
az batch job delete |
Elimina un processo. |
Memoria centrale | Disponibilità generale |
az batch job disable |
Disabilita il processo specificato, impedendo l'esecuzione di nuove attività. |
Memoria centrale | Disponibilità generale |
az batch job enable |
Abilita il processo specificato, consentendo l'esecuzione di nuove attività. |
Memoria centrale | Disponibilità generale |
az batch job list |
Elencare tutti i processi o la pianificazione dei processi in un account Batch. |
Memoria centrale | Disponibilità generale |
az batch job prep-release-status |
Visualizzare lo stato delle attività di preparazione e rilascio dei processi batch. |
Memoria centrale | Disponibilità generale |
az batch job prep-release-status list |
Elenca lo stato di esecuzione dell'attività Preparazione processo e rilascio processo per il processo specificato nei nodi di calcolo in cui è stato eseguito il processo. |
Memoria centrale | Disponibilità generale |
az batch job reset |
Aggiornare le proprietà di un processo Batch. Le proprietà non specificate che possono essere aggiornate vengono reimpostate sulle impostazioni predefinite. |
Memoria centrale | Disponibilità generale |
az batch job set |
Aggiornare le proprietà di un processo Batch. L'aggiornamento di una proprietà in un sottogruppo reimposta le proprietà non specificate di tale gruppo. |
Memoria centrale | Disponibilità generale |
az batch job show |
Ottiene informazioni sul processo specificato. |
Memoria centrale | Disponibilità generale |
az batch job stop |
Arrestare un processo Batch in esecuzione. |
Memoria centrale | Disponibilità generale |
az batch job task-counts |
Visualizzare il numero di attività e slot in un processo Batch e i relativi stati. |
Memoria centrale | Disponibilità generale |
az batch job task-counts show |
Ottiene il conteggio delle attività per il processo specificato. |
Memoria centrale | Disponibilità generale |
az batch job create
Aggiungere un processo a un account Batch.
az batch job create [--account-endpoint]
[--account-key]
[--account-name]
[--allow-task-preemption]
[--id]
[--job-manager-task-command-line]
[--job-manager-task-environment-settings]
[--job-manager-task-id]
[--job-manager-task-resource-files]
[--job-max-task-retry-count]
[--job-max-wall-clock-time]
[--json-file]
[--max-parallel-tasks]
[--metadata]
[--pool-id]
[--priority]
[--required-slots]
[--uses-task-dependencies]
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.
Indica se le attività in questo processo possono essere annullate da altri processi con priorità alta. Se il valore è impostato su True, altri processi con priorità alta inviati al sistema avranno la precedenza e saranno in grado di rieseguere le attività da questo processo. È possibile aggiornare allowTaskPreemption di un processo dopo che è stato creato usando l'API del processo di aggiornamento. True se il flag è presente.
Obbligatorio. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura, e non può contenere più di 64 caratteri. L'ID mantiene la distinzione tra maiuscole e minuscole e non fa distinzione tra maiuscole e minuscole, ovvero potrebbe non avere due ID all'interno di un account che differisce solo per caso.
Obbligatorio. 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).
Valori separati da spazi nel formato 'key=value'.
Obbligatorio. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura e non può contenere più di 64 caratteri.
I file elencati in questo elemento si trovano nella directory di lavoro dell'attività. È 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 i file ZIP, i pacchetti dell'applicazione o i contenitori Docker. Riferimenti a risorse separate da spazi in formato filename=httpurl.
Numero massimo di tentativi per ogni attività. Il servizio Batch ritenta un'attività se il codice di uscita è diverso da zero. Si noti che questo valore controlla specificamente il numero di tentativi. Il servizio Batch proverà ogni attività una sola volta e potrebbe quindi riprovare fino a questo limite. Ad esempio, se il numero massimo di tentativi è 3, Batch prova un'attività fino a 4 volte (un tentativo iniziale e 3 tentativi). Se il numero massimo di tentativi è 0, il servizio Batch non riprova attività. Se il numero massimo di tentativi è -1, il servizio Batch ritenta attività senza limiti. Il valore predefinito è 0, ovvero nessun tentativo.
Se il processo non viene completato entro il limite di tempo, il servizio Batch lo termina e tutte le attività ancora in esecuzione. In questo caso, il motivo della terminazione sarà MaxWallClockTimeExpiry. Se questa proprietà non viene specificata, non è previsto alcun limite di tempo per quanto tempo può essere eseguito il processo. Il formato previsto è una durata ISO-8601.
File contenente la specifica del processo in JSON (formattato in modo che corrisponda al rispettivo corpo dell'API REST). Se questo parametro viene specificato, tutti gli argomenti del processo vengono ignorati.
Numero massimo di attività che è possibile eseguire in parallelo per il processo. Il valore di maxParallelTasks deve essere -1 o maggiore di 0 se specificato. Se non specificato, il valore predefinito è -1, ovvero non esiste alcun limite al numero di attività che possono essere eseguite contemporaneamente. È possibile aggiornare maxParallelTasks di un processo dopo che è stato creato usando l'API del processo di aggiornamento. Valore predefinito: -1 .
Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente. Valori separati da spazi nel formato 'key=value'.
ID di un pool esistente. Tutte le attività del processo verranno eseguite nel pool specificato.
Priorità del processo. I valori di priorità possono variare da -1000 a 1000, con -1000 come priorità più bassa e 1000 come priorità più alta. Il valore predefinito è 0.
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, questa proprietà non è supportata e non deve essere specificata.
Indica se le attività nel processo possono definire le dipendenze l'una dall'altra. L'impostazione predefinita è false. True se il flag è presente.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
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
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az batch job create (azure-batch-cli-extensions estensione)
Aggiungere un processo e le attività associate a un account Batch.
az batch job create [--account-endpoint]
[--account-key]
[--account-name]
[--allow-task-preemption]
[--id]
[--job-manager-task-command-line]
[--job-manager-task-environment-settings]
[--job-manager-task-id]
[--job-manager-task-resource-files]
[--job-max-task-retry-count]
[--job-max-wall-clock-time]
[--json-file]
[--max-parallel-tasks]
[--metadata]
[--parameters]
[--pool-id]
[--priority]
[--required-slots]
[--resource-group]
[--template]
[--uses-task-dependencies]
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.
Indica se le attività in questo processo possono essere annullate da altri processi con priorità alta. Se il valore è impostato su True, altri processi con priorità alta inviati al sistema avranno la precedenza e saranno in grado di rieseguere le attività da questo processo. È possibile aggiornare allowTaskPreemption di un processo dopo che è stato creato usando l'API del processo di aggiornamento.
Obbligatorio. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura, e non può contenere più di 64 caratteri. L'ID mantiene la distinzione tra maiuscole e minuscole e non fa distinzione tra maiuscole e minuscole, ovvero potrebbe non avere due ID all'interno di un account che differisce solo per caso.
Riga di comando dell'attività Gestione processi. 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à Gestione processi. Spazia valori separati in formato 'key=value'.
Stringa che identifica in modo univoco l'attività Di gestione processi 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.
Elenco di file che il servizio Batch scaricherà nel nodo di calcolo prima di eseguire la riga di comando. I file elencati in questo elemento si trovano nella directory di lavoro dell'attività. Riferimenti a risorse separate da spazi nel formato filename=httpurl.
Numero massimo di tentativi per ogni attività. Il servizio Batch ripete un'attività se il relativo codice di uscita è diverso da zero. Si noti che questo valore controlla specificamente il numero di tentativi. Il servizio Batch proverà ogni attività una sola volta e potrebbe quindi riprovare fino a questo limite. Ad esempio, se il numero massimo di tentativi è 3, il servizio Batch eseguirà l'attività 4 volte, ovvero una iniziale e 3 ulteriori tentativi. Se il numero massimo di tentativi è 0, il servizio Batch non eseguirà ulteriori tentativi. Se il numero massimo di tentativi è -1, il servizio Batch continuerà a eseguire tentativi senza limiti. Il valore predefinito è 0, ovvero nessun tentativo.
Tempo massimo trascorso che il processo può essere eseguito, misurato dal momento in cui viene creato il processo. Se il processo non viene completato entro il limite di tempo, il servizio Batch lo termina e tutte le attività ancora in esecuzione. In questo caso, il motivo della terminazione sarà MaxWallClockTimeExpiry. Se questa proprietà non viene specificata, non è previsto alcun limite di tempo per quanto tempo il processo può essere eseguito. Il formato previsto è una durata ISO-8601.
File contenente la specifica del processo in JSON (formattato in modo che corrisponda al rispettivo corpo dell'API REST). Se questo parametro viene specificato, tutti gli argomenti del processo vengono ignorati.
Numero massimo di attività che è possibile eseguire in parallelo per il processo. Il valore di maxParallelTasks deve essere -1 o maggiore di 0 se specificato. Se non specificato, il valore predefinito è -1, ovvero non esiste alcun limite al numero di attività che possono essere eseguite contemporaneamente. È possibile aggiornare maxParallelTasks di un processo dopo che è stato creato usando l'API del processo di aggiornamento. Valore predefinito: -1 .
Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente.
Valori dei parametri per un file di modello JSON del processo Batch. Può essere usato solo con --template.
ID di un pool esistente. Tutte le attività del processo verranno eseguite nel pool specificato.
Priorità del processo. I valori di priorità possono variare da -1000 a 1000, con -1000 come priorità più bassa e 1000 come priorità più alta. Il valore predefinito è 0.
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, questa proprietà non è supportata e non deve essere specificata.
Gruppo di risorse dell'account Batch.
Un file di modello JSON del processo Batch. Se si specifica questo parametro, tutti gli altri parametri vengono ignorati.
Flag che determina se questo processo userà attività con dipendenze. True se il flag è presente.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
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
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az batch job delete
Elimina un processo.
L'eliminazione di un processo elimina anche tutte le attività che fanno parte di tale processo e tutte le statistiche di processo. Questo esegue anche l'override del periodo di conservazione per i dati attività; ovvero, se il processo contiene attività che vengono ancora mantenute nei nodi di calcolo, i servizi Batch eliminano le directory di lavoro delle attività e tutto il relativo contenuto. Quando viene ricevuta una richiesta di eliminazione processo, il servizio Batch imposta il processo sullo stato di eliminazione. Tutte le operazioni di aggiornamento in un processo in stato di eliminazione avranno esito negativo con il codice di stato 409 (Conflitto), con informazioni aggiuntive che indicano che il processo è in corso di eliminazione.
az batch job delete --job-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 eliminare.
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 non è stata modificata dall'ora specificata.
Indica che non è richiesta la conferma.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
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
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az batch job disable
Disabilita il processo specificato, impedendo l'esecuzione di nuove attività.
Il servizio Batch sposta immediatamente il processo nello stato di disabilitazione. Batch usa quindi il parametro disableTasks per determinare cosa fare con le attività attualmente in esecuzione del processo. Il processo rimane nello stato di disabilitazione fino al completamento dell'operazione di disabilitazione e tutte le attività sono state gestite in base all'opzione disableTasks; Il processo passa quindi allo stato disabilitato. Nessuna nuova attività viene avviata nel processo fino a quando non torna allo stato attivo. Se si tenta di disabilitare un processo in qualsiasi stato diverso da attivo, disabilitazione o disabilitato, la richiesta ha esito negativo con codice di stato 409.
az batch job disable --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--disable-tasks]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
Parametri necessari
ID del processo da disabilitare.
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.
I valori possibili includono: 'requeue', 'terminate', 'wait'.
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 non è stata modificata dall'ora specificata.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
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
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az batch job enable
Abilita il processo specificato, consentendo l'esecuzione di nuove attività.
Quando si chiama questa API, il servizio Batch imposta un processo disabilitato sullo stato di abilitazione. Al termine dell'operazione, il processo passa allo stato attivo e la pianificazione delle nuove attività nel processo riprende. Il servizio Batch non consente a un'attività di rimanere nello stato attivo per più di 180 giorni. Pertanto, se si abilita un processo contenente attività attive aggiunte più di 180 giorni fa, tali attività non verranno eseguite.
az batch job enable --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
Parametri necessari
ID del processo da abilitare.
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 non è stata modificata dall'ora specificata.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
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
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az batch job list
Elencare tutti i processi o la pianificazione dei processi in un account Batch.
az batch job list [--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--filter]
[--job-schedule-id]
[--select]
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.
ID della pianificazione del processo da cui si desidera ottenere un elenco di processi. Se omesso, elenca tutti i processi nell'account.
Clausola di $select OData.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
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
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az batch job reset
Aggiornare le proprietà di un processo Batch. Le proprietà non specificate che possono essere aggiornate vengono reimpostate sulle impostazioni predefinite.
az batch job reset --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--allow-task-preemption]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--job-max-task-retry-count]
[--job-max-wall-clock-time]
[--json-file]
[--max-parallel-tasks]
[--metadata]
[--on-all-tasks-complete {noaction, terminatejob}]
[--pool-id]
[--priority]
Parametri necessari
ID del processo di cui si desidera aggiornare le proprietà.
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.
Indica se le attività in questo processo possono essere annullate da altri processi con priorità alta. Se il valore è impostato su True, altri processi con priorità alta inviati al sistema avranno la precedenza e saranno in grado di rieseguere le attività da questo processo. È possibile aggiornare allowTaskPreemption di un processo dopo che è stato creato usando l'API del processo di aggiornamento. True se il flag è presente.
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 non è stata modificata dall'ora specificata.
Numero massimo di tentativi per ogni attività. Il servizio Batch ritenta un'attività se il codice di uscita è diverso da zero. Si noti che questo valore controlla specificamente il numero di tentativi. Il servizio Batch proverà ogni attività una sola volta e potrebbe quindi riprovare fino a questo limite. Ad esempio, se il numero massimo di tentativi è 3, Batch prova un'attività fino a 4 volte (un tentativo iniziale e 3 tentativi). Se il numero massimo di tentativi è 0, il servizio Batch non riprova attività. Se il numero massimo di tentativi è -1, il servizio Batch ritenta attività senza limiti. Il valore predefinito è 0, ovvero nessun tentativo.
Se il processo non viene completato entro il limite di tempo, il servizio Batch lo termina e tutte le attività ancora in esecuzione. In questo caso, il motivo della terminazione sarà MaxWallClockTimeExpiry. Se questa proprietà non viene specificata, non è previsto alcun limite di tempo per quanto tempo può essere eseguito il processo. Il formato previsto è una durata ISO-8601.
File contenente la specifica del parametro di aggiornamento del processo in JSON (formattato in modo che corrisponda al rispettivo corpo dell'API REST). Se questo parametro viene specificato, tutti gli argomenti del processo vengono ignorati.
Numero massimo di attività che è possibile eseguire in parallelo per il processo. Il valore di maxParallelTasks deve essere -1 o maggiore di 0 se specificato. Se non specificato, il valore predefinito è -1, ovvero non esiste alcun limite al numero di attività che possono essere eseguite contemporaneamente. È possibile aggiornare maxParallelTasks di un processo dopo che è stato creato usando l'API del processo di aggiornamento. Valore predefinito: -1 .
Se omesso, accetta il valore predefinito di un elenco vuoto; in effetti, tutti i metadati esistenti vengono eliminati. Valori separati da spazi nel formato 'key=value'.
L'azione che il servizio Batch deve eseguire quando tutte le attività nel processo sono nello stato completato. Se omesso, il comportamento di completamento viene impostato su noaction. Se il valore corrente è terminatejob, si tratta di un errore perché il comportamento di completamento di un processo potrebbe non essere modificato da terminatejob a noaction. Non è possibile modificare il valore da terminatejob a noaction, ovvero dopo aver attivato la terminazione automatica del processo, non è possibile disattivarlo di nuovo. Se si tenta di eseguire questa operazione, la richiesta ha esito negativo e Batch restituisce il codice di stato 400 (richiesta non valida) e una risposta di errore "valore della proprietà non valida". Se non si specifica questo elemento in una richiesta PUT, equivale al passaggio di noaction. Si tratta di un errore se il valore corrente è terminatejob.
ID di un pool esistente. Tutte le attività del processo verranno eseguite nel pool specificato.
Priorità del processo. I valori di priorità possono variare da -1000 a 1000, con -1000 come priorità più bassa e 1000 come priorità più alta. Se omesso, viene impostato sul valore predefinito 0.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
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
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az batch job set
Aggiornare le proprietà di un processo Batch. L'aggiornamento di una proprietà in un sottogruppo reimposta le proprietà non specificate di tale gruppo.
az batch job set --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--allow-task-preemption]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--job-max-task-retry-count]
[--job-max-wall-clock-time]
[--json-file]
[--max-parallel-tasks]
[--metadata]
[--on-all-tasks-complete {noaction, terminatejob}]
[--pool-id]
[--priority]
Parametri necessari
ID del processo di cui si desidera aggiornare le proprietà.
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.
Indica se le attività in questo processo possono essere annullate da altri processi con priorità alta. Se il valore è impostato su True, altri processi con priorità alta inviati al sistema avranno la precedenza e saranno in grado di rieseguere le attività da questo processo. È possibile aggiornare allowTaskPreemption di un processo dopo che è stato creato usando l'API del processo di aggiornamento. Specificare 'true' o 'false' per aggiornare la proprietà.
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 non è stata modificata dall'ora specificata.
Numero massimo di tentativi per ogni attività. Il servizio Batch ritenta un'attività se il codice di uscita è diverso da zero. Si noti che questo valore controlla specificamente il numero di tentativi. Il servizio Batch proverà ogni attività una sola volta e potrebbe quindi riprovare fino a questo limite. Ad esempio, se il numero massimo di tentativi è 3, Batch prova un'attività fino a 4 volte (un tentativo iniziale e 3 tentativi). Se il numero massimo di tentativi è 0, il servizio Batch non riprova attività. Se il numero massimo di tentativi è -1, il servizio Batch ritenta attività senza limiti. Il valore predefinito è 0, ovvero nessun tentativo.
Se il processo non viene completato entro il limite di tempo, il servizio Batch lo termina e tutte le attività ancora in esecuzione. In questo caso, il motivo della terminazione sarà MaxWallClockTimeExpiry. Se questa proprietà non viene specificata, non è previsto alcun limite di tempo per quanto tempo può essere eseguito il processo. Il formato previsto è una durata ISO-8601.
File contenente la specifica del parametro patch del processo in JSON (formattato in modo che corrisponda al rispettivo corpo dell'API REST). Se questo parametro viene specificato, tutti gli argomenti del processo vengono ignorati.
Numero massimo di attività che è possibile eseguire in parallelo per il processo. Il valore di maxParallelTasks deve essere -1 o maggiore di 0 se specificato. Se non specificato, il valore predefinito è -1, ovvero non esiste alcun limite al numero di attività che possono essere eseguite contemporaneamente. È possibile aggiornare maxParallelTasks di un processo dopo che è stato creato usando l'API del processo di aggiornamento.
Se omesso, i metadati del processo esistenti vengono lasciati invariati. Valori separati da spazi nel formato 'key=value'.
L'azione che il servizio Batch deve eseguire quando tutte le attività nel processo sono nello stato completato. Se omesso, il comportamento di completamento rimane invariato. Non è possibile modificare il valore da terminatejob a noaction, ovvero dopo aver attivato la terminazione automatica del processo, non è possibile disattivarlo di nuovo. Se si tenta di eseguire questa operazione, la richiesta ha esito negativo con una risposta di errore "valore della proprietà non valida". se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).
ID di un pool esistente. Tutte le attività del processo verranno eseguite nel pool specificato.
Priorità del processo. I valori di priorità possono variare da -1000 a 1000, con -1000 come priorità più bassa e 1000 come priorità più alta. Se omesso, la priorità del processo viene lasciata invariata.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
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
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az batch job show
Ottiene informazioni sul processo specificato.
az batch job show --job-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.
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 non è stata modificata dall'ora specificata.
Clausola di $select OData.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
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
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az batch job stop
Arrestare un processo Batch in esecuzione.
Terminare il processo specificato, contrassegnandolo come completato. Quando viene ricevuta una richiesta termina processo, il servizio Batch imposta il processo sullo stato di terminazione. Il servizio Batch termina quindi tutte le attività in esecuzione associate al processo ed esegue tutte le attività di rilascio del processo necessarie. Il processo passa quindi allo stato completato. Se nel processo sono presenti attività nello stato attivo, rimarranno nello stato attivo. Una volta terminato un processo, non è possibile aggiungere nuove attività e le attività attive rimanenti non verranno pianificate.
az batch job stop --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--terminate-reason]
Parametri necessari
ID del processo da terminare.
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 non è stata modificata dall'ora specificata.
Motivo della terminazione.
Testo che si vuole visualizzare come TerminateReason del processo. Il valore predefinito è 'UserTerminate'.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
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
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.