Condividi tramite

az batch job-schedule

  • Riferimento

Gestire le pianificazioni dei processi batch.

Comandi

Nome Descrizione Tipo Status
az batch job-schedule create

Aggiungere una pianificazione del processo batch a un account.

 Memoria centrale Disponibilità generale
az batch job-schedule delete

Elimina una pianificazione processo dall'account specificato.

 Memoria centrale Disponibilità generale
az batch job-schedule disable

Disabilita una pianificazione del processo.

 Memoria centrale Disponibilità generale
az batch job-schedule enable

Abilita una pianificazione del processo.

 Memoria centrale Disponibilità generale
az batch job-schedule list

Elenca tutte le pianificazioni dei processi nell'account specificato.

 Memoria centrale Disponibilità generale
az batch job-schedule reset

Reimpostare le proprietà di una pianificazione del processo. Una specifica del processo aggiornata si applica solo ai nuovi processi.

 Memoria centrale Disponibilità generale
az batch job-schedule set

Aggiornare le proprietà di una pianificazione del processo.

 Memoria centrale Disponibilità generale
az batch job-schedule show

Ottiene informazioni sulla pianificazione del processo specificata.

 Memoria centrale Disponibilità generale
az batch job-schedule stop

Termina una pianificazione del processo.

 Memoria centrale Disponibilità generale

az batch job-schedule create

Modifica

Aggiungere una pianificazione del processo batch a un account.

az batch job-schedule create [--account-endpoint]
                             [--account-key]
                             [--account-name]
                             [--allow-task-preemption]
                             [--do-not-run-after]
                             [--do-not-run-until]
                             [--id]
                             [--job-manager-task-command-line]
                             [--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 {noaction, terminatejob}]
                             [--pool-id]
                             [--priority]
                             [--recurrence-interval]
                             [--required-slots]
                             [--start-window]
                             [--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.

--do-not-run-after

Se non si specifica un'ora doNotRunAfter e si sta creando una pianificazione dei processi ricorrente, la pianificazione dei processi rimarrà attiva fino a quando non verrà terminata in modo esplicito. Il formato previsto è un timestamp ISO-8601.

--do-not-run-until

Se non si specifica un'ora doNotRunUntil, la pianificazione diventa pronta per creare immediatamente i processi. Il formato previsto è un timestamp ISO-8601.

--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-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 della pianificazione del processo cloud in JSON (formattato in modo che corrisponda al rispettivo corpo dell'API REST). Se questo parametro viene specificato, tutti gli argomenti di pianificazione processo cloud 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'.

--on-all-tasks-complete

L'azione che il servizio Batch deve eseguire quando tutte le attività in un processo creato in questa pianificazione 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.

Valori accettati: noaction, terminatejob
--pool-id

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

--priority

Priorità dei processi creati in base a questa pianificazione. 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. Questa priorità viene usata come predefinita per tutti i processi nella pianificazione del processo. È possibile aggiornare la priorità di un processo dopo che è stata creata usando l'API processo di aggiornamento.

--recurrence-interval

Poiché una pianificazione processo può avere al massimo un processo attivo in un determinato momento, se è il momento di creare un nuovo processo in una pianificazione processo, ma il processo precedente è ancora in esecuzione, il servizio Batch non creerà il nuovo processo fino al termine del processo precedente. Se il processo precedente non viene completato entro il periodo startWindow della nuova ricorrenzaInterval, non verrà pianificato alcun nuovo processo per tale intervallo. Per i processi ricorrenti, in genere è consigliabile specificare un jobManagerTask nel processoSpecification. Se non si usa jobManagerTask, sarà necessario un processo esterno per monitorare quando vengono creati processi, aggiungere Attività ai processi e terminare i processi pronti per la ricorrenza successiva. L'impostazione predefinita è che la pianificazione non si verifica nuovamente: viene creato un processo, all'interno di startWindow dopo l'ora doNotRunUntil e la pianificazione viene completata non appena termina il processo. Il valore minimo è 1 minuto. Se si specifica un valore inferiore, il servizio Batch rifiuta la pianificazione con un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida). Il formato previsto è una durata ISO-8601.

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

--start-window

Se un processo non viene creato entro l'intervallo startWindow, la "opportunità" viene persa; nessun processo verrà creato fino alla successiva ricorrenza della pianificazione. Se la pianificazione è ricorrente e startWindow è più lungo dell'intervallo di ricorrenza, questo equivale a un oggetto startWindow infinito, perché il processo "dovuto" in una ricorrenzaInterval non viene portato avanti nell'intervallo di ricorrenza successivo. Il valore predefinito è infinito. Il valore minimo è 1 minuto. Se si specifica un valore inferiore, il servizio Batch rifiuta la pianificazione con un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida). Il formato previsto è una durata ISO-8601.

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

Modifica

Elimina una pianificazione processo dall'account specificato.

Quando si elimina una pianificazione processo, vengono eliminati anche tutti i processi e le attività in base a tale pianificazione. Quando vengono eliminate le attività, vengono eliminati anche tutti i file nelle directory di lavoro nei nodi di calcolo (il periodo di conservazione viene ignorato). Le statistiche di Pianificazione processo non sono più accessibili dopo l'eliminazione della pianificazione del processo, anche se vengono ancora conteggiate per le statistiche di durata dell'account.

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

Parametri necessari

--job-schedule-id

ID della pianificazione 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-schedule disable

Modifica

Disabilita una pianificazione del processo.

Non verranno creati nuovi processi fino a quando non viene nuovamente abilitata la pianificazione processo.

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

Parametri necessari

--job-schedule-id

ID della pianificazione 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.

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

Modifica

Abilita una pianificazione del processo.

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

Parametri necessari

--job-schedule-id

ID della pianificazione 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-schedule list

Modifica

Elenca tutte le pianificazioni dei processi nell'account specificato.

az batch job-schedule list [--account-endpoint]
                           [--account-key]
                           [--account-name]
                           [--expand]
                           [--filter]
                           [--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. Per altre informazioni sulla costruzione di questo filtro, vedere https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-job-schedules.

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

Modifica

Reimpostare le proprietà di una pianificazione del processo. Una specifica del processo aggiornata si applica solo ai nuovi processi.

az batch job-schedule reset --job-schedule-id
                            [--account-endpoint]
                            [--account-key]
                            [--account-name]
                            [--allow-task-preemption]
                            [--do-not-run-after]
                            [--do-not-run-until]
                            [--if-match]
                            [--if-modified-since]
                            [--if-none-match]
                            [--if-unmodified-since]
                            [--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-metadata]
                            [--json-file]
                            [--max-parallel-tasks]
                            [--metadata]
                            [--on-all-tasks-complete {noaction, terminatejob}]
                            [--pool-id]
                            [--priority]
                            [--recurrence-interval]
                            [--required-slots]
                            [--start-window]
                            [--uses-task-dependencies]

Parametri necessari

--job-schedule-id

ID della pianificazione del processo da aggiornare.

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.

--do-not-run-after

Se non si specifica un'ora doNotRunAfter e si sta creando una pianificazione dei processi ricorrente, la pianificazione dei processi rimarrà attiva fino a quando non verrà terminata in modo esplicito. Il formato previsto è un timestamp ISO-8601.

--do-not-run-until

Se non si specifica un'ora doNotRunUntil, la pianificazione diventa pronta per creare immediatamente i processi. Il formato previsto è un timestamp ISO-8601.

--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-manager-task-application-package-references

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

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

--json-file

File contenente la specifica del parametro di aggiornamento della pianificazione del processo in JSON (formattato in modo che corrisponda al rispettivo corpo dell'API REST). Se questo parametro viene specificato, tutti gli argomenti di pianificazione 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 non si specifica questo elemento, 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à in un processo creato in questa pianificazione 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.

Valori accettati: noaction, terminatejob
--pool-id

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

--priority

Priorità dei processi creati in base a questa pianificazione. 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. Questa priorità viene usata come predefinita per tutti i processi nella pianificazione del processo. È possibile aggiornare la priorità di un processo dopo che è stata creata usando l'API processo di aggiornamento.

--recurrence-interval

Poiché una pianificazione processo può avere al massimo un processo attivo in un determinato momento, se è il momento di creare un nuovo processo in una pianificazione processo, ma il processo precedente è ancora in esecuzione, il servizio Batch non creerà il nuovo processo fino al termine del processo precedente. Se il processo precedente non viene completato entro il periodo startWindow della nuova ricorrenzaInterval, non verrà pianificato alcun nuovo processo per tale intervallo. Per i processi ricorrenti, in genere è consigliabile specificare un jobManagerTask nel processoSpecification. Se non si usa jobManagerTask, sarà necessario un processo esterno per monitorare quando vengono creati processi, aggiungere Attività ai processi e terminare i processi pronti per la ricorrenza successiva. L'impostazione predefinita è che la pianificazione non si verifica nuovamente: viene creato un processo, all'interno di startWindow dopo l'ora doNotRunUntil e la pianificazione viene completata non appena termina il processo. Il valore minimo è 1 minuto. Se si specifica un valore inferiore, il servizio Batch rifiuta la pianificazione con un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida). Il formato previsto è una durata ISO-8601.

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

--start-window

Se un processo non viene creato entro l'intervallo startWindow, la "opportunità" viene persa; nessun processo verrà creato fino alla successiva ricorrenza della pianificazione. Se la pianificazione è ricorrente e startWindow è più lungo dell'intervallo di ricorrenza, questo equivale a un oggetto startWindow infinito, perché il processo "dovuto" in una ricorrenzaInterval non viene portato avanti nell'intervallo di ricorrenza successivo. Il valore predefinito è infinito. Il valore minimo è 1 minuto. Se si specifica un valore inferiore, il servizio Batch rifiuta la pianificazione con un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida). Il formato previsto è una durata ISO-8601.

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

Modifica

Aggiornare le proprietà di una pianificazione del processo.

È possibile aggiornare in modo indipendente la pianificazione e la specifica del processo, ma qualsiasi modifica apportata a una di queste entità reimposta tutte le proprietà in tale entità.

az batch job-schedule set --job-schedule-id
                          [--account-endpoint]
                          [--account-key]
                          [--account-name]
                          [--allow-task-preemption]
                          [--do-not-run-after]
                          [--do-not-run-until]
                          [--if-match]
                          [--if-modified-since]
                          [--if-none-match]
                          [--if-unmodified-since]
                          [--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-metadata]
                          [--json-file]
                          [--max-parallel-tasks]
                          [--metadata]
                          [--on-all-tasks-complete {noaction, terminatejob}]
                          [--pool-id]
                          [--priority]
                          [--recurrence-interval]
                          [--required-slots]
                          [--start-window]
                          [--uses-task-dependencies]

Parametri necessari

--job-schedule-id

ID della pianificazione del processo da aggiornare.

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

--do-not-run-after

Se non si specifica un'ora doNotRunAfter e si sta creando una pianificazione dei processi ricorrente, la pianificazione dei processi rimarrà attiva fino a quando non verrà terminata in modo esplicito. Il formato previsto è un timestamp ISO-8601.

--do-not-run-until

Se non si specifica un'ora doNotRunUntil, la pianificazione diventa pronta per creare immediatamente i processi. Il formato previsto è un timestamp ISO-8601.

--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-manager-task-application-package-references

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

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

--json-file

File contenente la specifica del parametro patch della pianificazione del processo in JSON (formattato in modo che corrisponda al rispettivo corpo dell'API REST). Se questo parametro viene specificato, tutti gli argomenti di pianificazione 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 non si specifica questo elemento, i metadati 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à in un processo creato in questa pianificazione 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.

Valori accettati: noaction, terminatejob
--pool-id

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

--priority

Priorità dei processi creati in base a questa pianificazione. 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. Questa priorità viene usata come predefinita per tutti i processi nella pianificazione del processo. È possibile aggiornare la priorità di un processo dopo che è stata creata usando l'API processo di aggiornamento.

--recurrence-interval

Poiché una pianificazione processo può avere al massimo un processo attivo in un determinato momento, se è il momento di creare un nuovo processo in una pianificazione processo, ma il processo precedente è ancora in esecuzione, il servizio Batch non creerà il nuovo processo fino al termine del processo precedente. Se il processo precedente non viene completato entro il periodo startWindow della nuova ricorrenzaInterval, non verrà pianificato alcun nuovo processo per tale intervallo. Per i processi ricorrenti, in genere è consigliabile specificare un jobManagerTask nel processoSpecification. Se non si usa jobManagerTask, sarà necessario un processo esterno per monitorare quando vengono creati processi, aggiungere Attività ai processi e terminare i processi pronti per la ricorrenza successiva. L'impostazione predefinita è che la pianificazione non si verifica nuovamente: viene creato un processo, all'interno di startWindow dopo l'ora doNotRunUntil e la pianificazione viene completata non appena termina il processo. Il valore minimo è 1 minuto. Se si specifica un valore inferiore, il servizio Batch rifiuta la pianificazione con un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida). Il formato previsto è una durata ISO-8601.

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

--start-window

Se un processo non viene creato entro l'intervallo startWindow, la "opportunità" viene persa; nessun processo verrà creato fino alla successiva ricorrenza della pianificazione. Se la pianificazione è ricorrente e startWindow è più lungo dell'intervallo di ricorrenza, questo equivale a un oggetto startWindow infinito, perché il processo "dovuto" in una ricorrenzaInterval non viene portato avanti nell'intervallo di ricorrenza successivo. Il valore predefinito è infinito. Il valore minimo è 1 minuto. Se si specifica un valore inferiore, il servizio Batch rifiuta la pianificazione con un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida). Il formato previsto è una durata ISO-8601.

--uses-task-dependencies

Indica se le attività nel processo possono definire le dipendenze l'una dall'altra. L'impostazione predefinita è false. Specificare 'true' o 'false' per aggiornare la proprietà.

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

Modifica

Ottiene informazioni sulla pianificazione del processo specificata.

az batch job-schedule show --job-schedule-id
                           [--account-endpoint]
                           [--account-key]
                           [--account-name]
                           [--expand]
                           [--if-match]
                           [--if-modified-since]
                           [--if-none-match]
                           [--if-unmodified-since]
                           [--select]

Parametri necessari

--job-schedule-id

ID della pianificazione del processo da ottenere.

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

Modifica

Termina una pianificazione del processo.

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

Parametri necessari

--job-schedule-id

ID della pianificazione 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.

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.