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 Stato
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

--account-endpoint

Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.

--allow-task-preemption

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.

--id

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.

--job-manager-task-command-line

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

--job-manager-task-environment-settings

Valori separati da spazi nel formato 'key=value'.

--job-manager-task-id

Obbligatorio. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura e non può contenere più di 64 caratteri.

--job-manager-task-resource-files

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.

--job-max-task-retry-count

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.

--job-max-wall-clock-time

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.

--json-file

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.

--max-parallel-tasks

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 .

--metadata

Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente. Valori separati da spazi nel formato 'key=value'.

--pool-id

ID di un pool esistente. Tutte le attività del processo verranno eseguite nel pool specificato.

--priority

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.

--required-slots

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.

--uses-task-dependencies

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
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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

--account-endpoint

Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.

--allow-task-preemption

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.

--id

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.

--job-manager-task-command-line

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.

--job-manager-task-environment-settings

Elenco delle impostazioni delle variabili di ambiente per l'attività Gestione processi. Spazia valori separati in formato 'key=value'.

--job-manager-task-id

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.

--job-manager-task-resource-files

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.

--job-max-task-retry-count

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.

--job-max-wall-clock-time

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.

--json-file

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.

--max-parallel-tasks

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 .

--metadata

Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente.

--parameters

Valori dei parametri per un file di modello JSON del processo Batch. Può essere usato solo con --template.

--pool-id

ID di un pool esistente. Tutte le attività del processo verranno eseguite nel pool specificato.

--priority

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.

--required-slots

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.

--resource-group

Gruppo di risorse dell'account Batch.

--template

Un file di modello JSON del processo Batch. Se si specifica questo parametro, tutti gli altri parametri vengono ignorati.

--uses-task-dependencies

Flag che determina se questo processo userà attività con dipendenze. True se il flag è presente.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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

--job-id

ID del processo da eliminare.

Parametri facoltativi

--account-endpoint

Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.

--if-match

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-modified-since

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-none-match

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-unmodified-since

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.

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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

--job-id

ID del processo da disabilitare.

Parametri facoltativi

--account-endpoint

Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.

--disable-tasks

I valori possibili includono: 'requeue', 'terminate', 'wait'.

--if-match

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-modified-since

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-none-match

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-unmodified-since

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
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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

--job-id

ID del processo da abilitare.

Parametri facoltativi

--account-endpoint

Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.

--if-match

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-modified-since

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-none-match

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-unmodified-since

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
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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

--account-endpoint

Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.

--expand

Clausola di $expand OData.

--filter

Clausola di $filter OData.

--job-schedule-id

ID della pianificazione del processo da cui si desidera ottenere un elenco di processi. Se omesso, elenca tutti i processi nell'account.

--select

Clausola di $select OData.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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

--job-id

ID del processo di cui si desidera aggiornare le proprietà.

Parametri facoltativi

--account-endpoint

Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.

--allow-task-preemption

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.

--if-match

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-modified-since

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-none-match

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-unmodified-since

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.

--job-max-task-retry-count

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.

--job-max-wall-clock-time

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.

--json-file

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.

--max-parallel-tasks

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 .

--metadata

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

--on-all-tasks-complete

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.

valori accettati: noaction, terminatejob
--pool-id

ID di un pool esistente. Tutte le attività del processo verranno eseguite nel pool specificato.

--priority

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
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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

--job-id

ID del processo di cui si desidera aggiornare le proprietà.

Parametri facoltativi

--account-endpoint

Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.

--allow-task-preemption

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

--if-match

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-modified-since

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-none-match

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-unmodified-since

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.

--job-max-task-retry-count

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.

--job-max-wall-clock-time

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.

--json-file

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.

--max-parallel-tasks

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.

--metadata

Se omesso, i metadati del processo esistenti vengono lasciati invariati. Valori separati da spazi nel formato 'key=value'.

--on-all-tasks-complete

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

valori accettati: noaction, terminatejob
--pool-id

ID di un pool esistente. Tutte le attività del processo verranno eseguite nel pool specificato.

--priority

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
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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

--job-id

ID del processo.

Parametri facoltativi

--account-endpoint

Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.

--expand

Clausola di $expand OData.

--if-match

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-modified-since

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-none-match

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-unmodified-since

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.

--select

Clausola di $select OData.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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

--job-id

ID del processo da terminare.

Parametri facoltativi

--account-endpoint

Endpoint del servizio Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chiave dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome dell'account Batch. In alternativa, impostare per variabile di ambiente: AZURE_BATCH_ACCOUNT.

--if-match

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-modified-since

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-none-match

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-unmodified-since

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.

--terminate-reason

Motivo della terminazione.

Testo che si vuole visualizzare come TerminateReason del processo. Il valore predefinito è 'UserTerminate'.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.