az batch job

Riferimento

Gestire i processi batch.

Comandi

Nome	Descrizione	Tipo	Status
az batch job create	Aggiungere un processo a un account Batch.	Nucleo	GA
az batch job delete	Elimina un processo da un account Batch.	Nucleo	GA
az batch job disable	Disabilitare un processo batch.	Nucleo	GA
az batch job enable	Abilitare un processo Batch.	Nucleo	GA
az batch job list	Elencare tutti i processi o la pianificazione dei processi in un account Batch.	Nucleo	GA
az batch job prep-release-status	Visualizzare lo stato delle attività di preparazione e rilascio dei processi batch.	Nucleo	GA
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.	Nucleo	GA
az batch job reset	Aggiornare le proprietà di un processo Batch. Le proprietà non specificate che possono essere aggiornate vengono reimpostate sulle impostazioni predefinite.	Nucleo	GA
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.	Nucleo	GA
az batch job show	Ottiene informazioni sul processo Batch specificato.	Nucleo	GA
az batch job stop	Arrestare un processo Batch in esecuzione.	Nucleo	GA
az batch job task-counts	Visualizzare il numero di attività e slot in un processo Batch e i relativi stati.	Nucleo	GA
az batch job task-counts show	Ottiene il conteggio delle attività per il processo specificato.	Nucleo	GA

az batch job create

Modifica

Aggiungere un processo a un account Batch.

az batch job create [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--allow-task-preemption]
                    [--id]
                    [--job-manager-task-application-package-references]
                    [--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]
                    [--on-all-tasks-complete]
                    [--pool-id]
                    [--priority]
                    [--required-slots]
                    [--uses-task-dependencies]

Esempio

Creare un nuovo processo associato a un pool esistente.

az batch job create --id job1 --pool-id pool1

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

Stringa che identifica in modo univoco il processo all'interno dell'account. 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.

--job-manager-task-application-package-references

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

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

--job-manager-task-environment-settings

Elenco delle impostazioni delle variabili di ambiente per l'attività Gestione processi. Valori separati da spazi nel 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. Obbligatorio.

--job-manager-task-resource-files

Elenco di file scaricati dal servizio Batch 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à. È prevista una dimensione massima per l'elenco dei file di risorse. Quando viene superata la dimensione massima, la richiesta avrà esito negativo e il codice di errore della risposta sarà RequestEntityTooLarge. In questo caso, la raccolta di ResourceFiles deve essere ridotta di dimensioni. A tale scopo, è possibile usare .zip file, pacchetti di applicazioni o contenitori Docker. 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 in modo specifico 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 (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 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.

--metadata

Elenco di coppie nome-valore associate al processo come metadati. Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente. 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. Si noti che se un processo non contiene attività, tutte le attività vengono considerate complete. Questa opzione è quindi più comunemente usata con un'attività di Gestione processi; Se si vuole usare la terminazione automatica dei processi senza Gestione processi, è necessario impostare inizialmente onAllTasksComplete su noaction e aggiornare le proprietà job per impostare onAllTasksComplete su terminatejob dopo aver completato l'aggiunta di Attività. Il valore predefinito è noaction. I valori noti sono: "noaction" e "terminatejob".

--pool-id

ID di un pool esistente. Tutte le attività del processo verranno eseguite nel pool specificato. È necessario assicurarsi che il pool a cui fa riferimento questa proprietà esista. Se il pool non esiste al momento in cui il servizio Batch tenta di pianificare un processo, nessuna attività per il processo verrà eseguita fino a quando non si crea un pool con tale ID. Si noti che il servizio Batch non rifiuterà la richiesta di processo; non eseguirà semplicemente attività finché il pool non esiste. È necessario specificare l'ID pool o la specifica del pool automatico, ma non entrambi.

--priority

Priorità del processo. I valori di priorità possono variare da -1000 a 1000, con -1000 la 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. Il valore predefinito è false. True se il flag è presente.

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az batch job delete

Modifica

Elimina un processo da un account Batch.

az batch job delete --job-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--if-match]
                    [--if-modified-since]
                    [--if-none-match]
                    [--if-unmodified-since]
                    [--yes]

Esempio

Eliminare un processo usando l'ID processo senza richiedere conferma.

az batch job delete --job-id job1 --yes

Parametri necessari

--job-id

ID del processo da eliminare. Obbligatorio.

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 è stata modificata dall'ora specificata.

--yes -y

Non richiedere conferma.

Valore predefinito: False

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az batch job disable

Modifica

Disabilitare un processo batch.

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]
                     [--json-file]

Esempio

Disabilitare un processo e rieseguere le attività in esecuzione.

az batch job disable --job-id job1 --disable-tasks requeue

Parametri necessari

--job-id

ID del processo da disabilitare. Obbligatorio.

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

Operazioni da eseguire con le attività attive associate al processo. Obbligatorio. I valori noti sono: "requeue", "terminate" e "wait".

--if-match

--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 è stata modificata dall'ora specificata.

--json-file

File contenente la specifica del contenuto in JSON (formattato in modo che corrisponda al rispettivo corpo dell'API REST). Se questo parametro viene specificato, tutti gli argomenti del contenuto vengono ignorati.

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az batch job enable

Modifica

Abilitare un processo Batch.

az batch job enable --job-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--if-match]
                    [--if-modified-since]
                    [--if-none-match]
                    [--if-unmodified-since]

Esempio

Abilitare un processo.

az batch job enable --job-id job1

Parametri necessari

--job-id

ID del processo da abilitare. Obbligatorio.

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

--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 è stata modificata dall'ora specificata.

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az batch job list

Modifica

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]

Esempio

Elencare tutti i processi in un account Batch

az batch job list

Elencare tutta la pianificazione del processo in un account Batch

az batch job list --job-schedule-id jobschedule1

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. È necessario solo in alternativa, impostato dalla variabile di ambiente: AZURE_BATCH_ACCOUNT.

--expand

Clausola di $expand OData.

--filter

Clausola di $filter OData. Per altre informazioni sulla costruzione di questo filtro, vedere https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.

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

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az batch job reset

Modifica

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]
                   [--pool-id]
                   [--priority]

Esempio

Reimpostare tutte le proprietà del processo ad eccezione della priorità.

az batch job reset --job-id job1 --priority 100

Parametri necessari

--job-id

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

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

--if-match

--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 è stata modificata dall'ora specificata.

--job-max-task-retry-count

--job-max-wall-clock-time

--json-file

--max-parallel-tasks

--metadata

--on-all-tasks-complete

L'azione che il servizio Batch deve eseguire quando tutte le attività nel processo sono nello stato completato. Il valore predefinito è noaction. I valori noti sono: "noaction" e "terminatejob".

--pool-id

--priority

Priorità del processo. I valori di priorità possono variare da -1000 a 1000, con -1000 la priorità più bassa e 1000 come priorità più alta. Il valore predefinito è 0.

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az batch job set

Modifica

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]
                 [--pool-id]
                 [--priority]

Esempio

Aggiornare la priorità del processo.

az batch job set --job-id job1 --priority 100

Parametri necessari

--job-id

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

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

--if-match

--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 è stata modificata dall'ora specificata.

--job-max-task-retry-count

--job-max-wall-clock-time

--json-file

--max-parallel-tasks

--metadata

Elenco di coppie nome-valore associate al processo come metadati. 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). I valori noti sono: "noaction" e "terminatejob".

--pool-id

--priority

Priorità del processo. I valori di priorità possono variare da -1000 a 1000, con -1000 la priorità più bassa e 1000 come priorità più alta. Se omesso, la priorità del processo viene lasciata invariata.

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az batch job show

Modifica

Ottiene informazioni sul processo Batch 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]

Esempio

Mostra informazioni dettagliate su un processo.

az batch job show --job-id job1

Parametri necessari

--job-id

ID del processo. Obbligatorio.

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

--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 è stata modificata dall'ora specificata.

--select

Clausola di $select OData.

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az batch job stop

Modifica

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]

Esempio

Arrestare un processo e fornire un motivo di terminazione

az batch job stop --job-id job1 --terminate-reason "Completed workflow"

Parametri necessari

--job-id

ID del processo da terminare. Obbligatorio.

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

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

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

Condividi tramite

az batch job

Comandi

az batch job create

Esempio

Parametri facoltativi

az batch job delete

Esempio

Parametri necessari

Parametri facoltativi

az batch job disable

Esempio

Parametri necessari

Parametri facoltativi

az batch job enable

Esempio

Parametri necessari

Parametri facoltativi

az batch job list

Esempio

Parametri facoltativi

az batch job reset

Esempio

Parametri necessari

Parametri facoltativi

az batch job set

Esempio

Parametri necessari

Parametri facoltativi

az batch job show

Esempio

Parametri necessari

Parametri facoltativi

az batch job stop

Esempio

Parametri necessari

Parametri facoltativi

Risorse aggiuntive