Condividi tramite


az batch job

Gestire i processi batch.

Comandi

Nome Descrizione Tipo Status
az batch job create

Aggiungere un processo a un account Batch.

Core GA
az batch job delete

Elimina un processo da un account Batch.

Core GA
az batch job disable

Disabilitare un processo batch.

Core GA
az batch job enable

Abilitare un processo Batch.

Core GA
az batch job list

Elencare tutti i processi o la pianificazione dei processi in un account Batch.

Core GA
az batch job prep-release-status

Visualizzare lo stato delle attività di preparazione e rilascio dei processi batch.

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

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

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

Core GA
az batch job show

Ottiene informazioni sul processo Batch specificato.

Core GA
az batch job stop

Arrestare un processo Batch in esecuzione.

Core GA
az batch job task-counts

Visualizzare il numero di attività e slot in un processo Batch e i relativi stati.

Core GA
az batch job task-counts show

Ottiene il conteggio delle attività per il processo specificato.

Core GA

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

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--account-endpoint

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--account-key

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--account-name

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--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.

Proprietà Valore
Gruppo di parametri: Job Arguments
--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. Required.

Proprietà Valore
Gruppo di parametri: Job Arguments
--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]".

Proprietà Valore
Gruppo di parametri: Job: Job Manager Task Arguments
--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). Required.

Proprietà Valore
Gruppo di parametri: Job: Job Manager Task Arguments
--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'.

Proprietà Valore
Gruppo di parametri: Job: Job Manager Task Arguments
--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. Required.

Proprietà Valore
Gruppo di parametri: Job: Job Manager Task Arguments
--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.

Proprietà Valore
Gruppo di parametri: Job: Job Manager Task Arguments
--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).

Proprietà Valore
Gruppo di parametri: Job: Constraints Arguments
--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.

Proprietà Valore
Gruppo di parametri: Job: Constraints Arguments
--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.

Proprietà Valore
Gruppo di parametri: Job Arguments
--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'.

Proprietà Valore
Gruppo di parametri: Job Arguments
--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".

Proprietà Valore
Gruppo di parametri: Job Arguments
--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.

Proprietà Valore
Gruppo di parametri: Job: Pool Info Arguments
--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.

Proprietà Valore
Gruppo di parametri: Job Arguments
--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.

Proprietà Valore
Gruppo di parametri: Job: Job Manager Task Arguments
--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.

Proprietà Valore
Gruppo di parametri: Job Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az batch job delete

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--account-endpoint

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--account-key

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--account-name

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--yes -y

Non richiedere conferma.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az batch job disable

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--account-endpoint

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--account-key

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--account-name

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--disable-tasks

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

Proprietà Valore
Gruppo di parametri: Content Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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 la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az batch job enable

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--account-endpoint

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--account-key

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--account-name

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

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]

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

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--account-endpoint

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--account-key

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--account-name

Nome dell'account Batch. È necessario solo in alternativa, impostato dalla variabile di ambiente: AZURE_BATCH_ACCOUNT.

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--expand

Clausola di $expand OData.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

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]
                   [--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à. Required.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--account-endpoint

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--account-key

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--account-name

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--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.

Proprietà Valore
Gruppo di parametri: Job Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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).

Proprietà Valore
Gruppo di parametri: Job: Constraints Arguments
--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.

Proprietà Valore
Gruppo di parametri: Job: Constraints Arguments
--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.

Proprietà Valore
Gruppo di parametri: Job Arguments
--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'.

Proprietà Valore
Gruppo di parametri: Job Arguments
--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".

Proprietà Valore
Gruppo di parametri: Job Arguments
--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.

Proprietà Valore
Gruppo di parametri: Job: Pool Info Arguments
--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.

Proprietà Valore
Gruppo di parametri: Job Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

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]
                 [--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à. Required.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--account-endpoint

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--account-key

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--account-name

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--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.

Proprietà Valore
Gruppo di parametri: Job Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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).

Proprietà Valore
Gruppo di parametri: Job: Constraints Arguments
--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.

Proprietà Valore
Gruppo di parametri: Job: Constraints Arguments
--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.

Proprietà Valore
Gruppo di parametri: Job Arguments
--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'.

Proprietà Valore
Gruppo di parametri: Job Arguments
--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".

Proprietà Valore
Gruppo di parametri: Job Arguments
--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.

Proprietà Valore
Gruppo di parametri: Job: Pool Info Arguments
--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.

Proprietà Valore
Gruppo di parametri: Job Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az batch job show

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--account-endpoint

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--account-key

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--account-name

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--expand

Clausola di $expand OData.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--select

Clausola di $select OData.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

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]

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--account-endpoint

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--account-key

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--account-name

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

Proprietà Valore
Gruppo di parametri: Batch Account Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--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.

Proprietà Valore
Gruppo di parametri: Pre-condition and Query Arguments
--terminate-reason

Motivo della terminazione.

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

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False