az ml run

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione azure-cli-ml per l'interfaccia della riga di comando di Azure (versione 2.0.28 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az ml run . Altre informazioni sulle estensioni.

Comandi per l'invio, l'aggiornamento e il monitoraggio delle esecuzioni.

Comandi

Nome Descrizione Tipo Stato
az ml run cancel

Annullare l'esecuzione.

 Estensione Disponibilità generale
az ml run download-logs

Scarica i file di log.

 Estensione Disponibilità generale
az ml run list

Elencare le esecuzioni.

 Estensione Disponibilità generale
az ml run monitor-logs

Monitorare i log per un'esecuzione esistente.

 Estensione Disponibilità generale
az ml run monitor-tensorboard

Monitorare un'esecuzione esistente usando tensorboard.

 Estensione Disponibilità generale
az ml run show

Mostra esecuzione.

 Estensione Disponibilità generale
az ml run submit-hyperdrive

Inviare uno sweep di parametri hyper usando la configurazione di esecuzione.

 Estensione Disponibilità generale
az ml run submit-pipeline

Inviare una pipeline per l'esecuzione da un ID pipeline pubblicato o da un file YAML della pipeline pubblicato.

 Estensione Disponibilità generale
az ml run submit-script

Inviare uno script per l'esecuzione.

 Estensione Disponibilità generale
az ml run update

Aggiornare l'esecuzione aggiungendo tag.

 Estensione Disponibilità generale

az ml run cancel

Annullare l'esecuzione.

az ml run cancel --run
                 [--experiment-name]
                 [--output-metadata-file]
                 [--path]
                 [--resource-group]
                 [--subscription-id]
                 [--workspace-name]

Parametri necessari

--run -r

RunId di un'esecuzione dell'esperimento.

Parametri facoltativi

--experiment-name -e

Nome esperimento.

--output-metadata-file -t

Specificare un percorso del file di output facoltativo per l'output dell'oggetto strutturato.

--path

Percorso di una directory radice per i file di configurazione di esecuzione.

valore predefinito: .
--resource-group -g

Nome del gruppo di risorse.

--subscription-id

Specifica l'ID sottoscrizione.

--workspace-name -w

Nome dell'area di lavoro.

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 ml run download-logs

Scarica i file di log.

az ml run download-logs --output-dir
                        --run
                        [--experiment-name]
                        [--output-metadata-file]
                        [--path]
                        [--resource-group]
                        [--subscription-id]
                        [--workspace-name]

Parametri necessari

--output-dir -d

Directory di output in cui scaricare i file di log.

--run -r

RunId di un'esecuzione dell'esperimento.

Parametri facoltativi

--experiment-name -e

Nome esperimento.

--output-metadata-file -t

Specificare un percorso del file di output facoltativo per l'output dell'oggetto strutturato.

--path

Percorso di una directory radice per i file di configurazione di esecuzione.

valore predefinito: .
--resource-group -g

Nome del gruppo di risorse.

--subscription-id

Specifica l'ID sottoscrizione.

--workspace-name -w

Nome dell'area di lavoro.

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 ml run list

Elencare le esecuzioni.

az ml run list [--compute-target-name]
               [--experiment-name]
               [--last]
               [--minimal]
               [--output-metadata-file]
               [--parent-run-id]
               [--path]
               [--pipeline-run-id]
               [--resource-group]
               [--status {Completed, Failed, Finalizing, Preparing, Provisioning, Queued, Running, Starting}]
               [--subscription-id]
               [--tags]
               [--workspace-name]

Parametri facoltativi

--compute-target-name

Nome della destinazione di calcolo.

--experiment-name -e

Nome esperimento.

--last

Recuperare gli elementi N più recenti.

valore predefinito: 10
--minimal

Flag per fornire le proprietà minime per l'output di esecuzione.

valore predefinito: False
--output-metadata-file -t

Specificare un percorso del file di output facoltativo per l'output dell'oggetto strutturato.

--parent-run-id

ID esecuzione padre.

--path

Percorso di una directory radice per i file di configurazione di esecuzione.

valore predefinito: .
--pipeline-run-id

ID di esecuzione della pipeline.

--resource-group -g

Nome del gruppo di risorse.

--status

Lo stato dell'esecuzione.

valori accettati: Completed, Failed, Finalizing, Preparing, Provisioning, Queued, Running, Starting
--subscription-id

Specifica l'ID sottoscrizione.

--tags

Tag per un'esecuzione con sintassi 'key[=value]'.

--workspace-name -w

Nome dell'area di lavoro.

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 ml run monitor-logs

Monitorare i log per un'esecuzione esistente.

az ml run monitor-logs --run
                       [--experiment-name]
                       [--output-metadata-file]
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]

Parametri necessari

--run -r

RunId di un'esecuzione dell'esperimento.

Parametri facoltativi

--experiment-name -e

Nome esperimento.

--output-metadata-file -t

Specificare un percorso del file di output facoltativo per l'output dell'oggetto strutturato.

--path

Percorso di una directory radice per i file di configurazione di esecuzione.

valore predefinito: .
--resource-group -g

Nome del gruppo di risorse.

--subscription-id

Specifica l'ID sottoscrizione.

--workspace-name -w

Nome dell'area di lavoro.

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 ml run monitor-tensorboard

Monitorare un'esecuzione esistente usando tensorboard.

az ml run monitor-tensorboard --run
                              [--experiment-name]
                              [--local-directory]
                              [--output-metadata-file]
                              [--path]
                              [--resource-group]
                              [--subscription-id]
                              [--workspace-name]

Parametri necessari

--run -r

RunId di un'esecuzione dell'esperimento.

Parametri facoltativi

--experiment-name -e

Nome esperimento.

--local-directory

Directory locale per preparare i file tensorboard monitorati.

--output-metadata-file -t

Specificare un percorso del file di output facoltativo per l'output dell'oggetto strutturato.

--path

Percorso di una directory radice per i file di configurazione di esecuzione.

valore predefinito: .
--resource-group -g

Nome del gruppo di risorse.

--subscription-id

Specifica l'ID sottoscrizione.

--workspace-name -w

Nome dell'area di lavoro.

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 ml run show

Mostra esecuzione.

az ml run show --run
               [--experiment-name]
               [--output-metadata-file]
               [--path]
               [--resource-group]
               [--subscription-id]
               [--workspace-name]

Parametri necessari

--run -r

RunId di un'esecuzione dell'esperimento.

Parametri facoltativi

--experiment-name -e

Nome esperimento.

--output-metadata-file -t

Specificare un percorso del file di output facoltativo per l'output dell'oggetto strutturato.

--path

Percorso di una directory radice per i file di configurazione di esecuzione.

valore predefinito: .
--resource-group -g

Nome del gruppo di risorse.

--subscription-id

Specifica l'ID sottoscrizione.

--workspace-name -w

Nome dell'area di lavoro.

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 ml run submit-hyperdrive

Inviare uno sweep di parametri hyper usando la configurazione di esecuzione.

az ml run submit-hyperdrive --hyperdrive-configuration-name
                            [--async]
                            [--conda-dependencies]
                            [--ct]
                            [--experiment-name]
                            [--output-metadata-file]
                            [--path]
                            [--resource-group]
                            [--run-configuration-name]
                            [--source-directory]
                            [--subscription-id]
                            [--workspace-name]
                            [<USER_SCRIPT_AND_ARGUMENTS>]

Parametri necessari

--hyperdrive-configuration-name

Nome completo del file di configurazione di hyperdrive. Il file deve trovarsi in una sottocartella della directory specificata dal parametro path.

Parametri facoltativi

--async

Disabilitare lo streaming di output.

valore predefinito: False
--conda-dependencies -d

Eseguire l'override del file di dipendenze Conda predefinito.

--ct --target

Nome della destinazione di calcolo da usare per l'esecuzione.

--experiment-name -e

Nome esperimento.

--output-metadata-file -t

Specificare un percorso del file di output facoltativo per l'output dell'oggetto strutturato.

--path

Percorso di una directory radice per i file di configurazione di esecuzione.

valore predefinito: .
--resource-group -g

Nome del gruppo di risorse.

--run-configuration-name -c

Nome (senza estensione) di un file di configurazione di esecuzione. Il file deve trovarsi in una sottocartella della directory specificata dal parametro path.

--source-directory

Directory locale contenente i file di codice sorgente. L'impostazione predefinita è path se la directory di origine non è specificata.

--subscription-id

Specifica l'ID sottoscrizione.

--workspace-name -w

Nome dell'area di lavoro.

<USER_SCRIPT_AND_ARGUMENTS>

Argomenti di invio dell'esecuzione, ad esempio il nome dello script e gli argomenti dello script.

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 ml run submit-pipeline

Inviare una pipeline per l'esecuzione da un ID pipeline pubblicato o da un file YAML della pipeline pubblicato.

az ml run submit-pipeline [--datapaths]
                          [--experiment-name]
                          [--output-metadata-file]
                          [--output_file]
                          [--parameters]
                          [--path]
                          [--pipeline-id]
                          [--pipeline-yaml]
                          [--resource-group]
                          [--subscription-id]
                          [--workspace-name]

Parametri facoltativi

--datapaths -d

Elenco delimitato da virgole di coppie name=datastore/path per le assegnazioni di parametri del percorso dati.

--experiment-name -n

Nome dell'esperimento per l'invio dell'esecuzione. Se non specificato, usare il nome della pipeline.

--output-metadata-file -t

Specificare un percorso del file di output facoltativo per l'output dell'oggetto strutturato.

--output_file -f

File per scrivere l'output in formato JSON.

--parameters -p

Elenco delimitato da virgole di coppie nome=valore per le assegnazioni di parametri della pipeline.

--path

Percorso di una directory radice per i file di configurazione di esecuzione.

valore predefinito: .
--pipeline-id -i

ID di una pipeline da inviare (GUID).

--pipeline-yaml -y

File YAML che definisce una pipeline.

--resource-group -g

Nome del gruppo di risorse.

--subscription-id

Specifica l'ID sottoscrizione.

--workspace-name -w

Nome dell'area di lavoro.

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 ml run submit-script

Inviare uno script per l'esecuzione.

az ml run submit-script [--async]
                        [--conda-dependencies]
                        [--ct]
                        [--experiment-name]
                        [--output-metadata-file]
                        [--path]
                        [--resource-group]
                        [--run-configuration-name]
                        [--source-directory]
                        [--subscription-id]
                        [--workspace-name]
                        [<USER_SCRIPT_AND_ARGUMENTS>]

Parametri facoltativi

--async

Disabilitare lo streaming di output.

valore predefinito: False
--conda-dependencies -d

Eseguire l'override del file di dipendenze Conda predefinito.

--ct --target

Nome della destinazione di calcolo da usare per l'esecuzione.

--experiment-name -e

Nome esperimento.

--output-metadata-file -t

Specificare un percorso del file di output facoltativo per l'output dell'oggetto strutturato.

--path

Percorso di una directory radice per i file di configurazione di esecuzione.

valore predefinito: .
--resource-group -g

Nome del gruppo di risorse.

--run-configuration-name -c

Nome (senza estensione) di un file di configurazione di esecuzione. Il file deve trovarsi in una sottocartella della directory specificata dal parametro path.

--source-directory

Directory locale contenente i file di codice sorgente. L'impostazione predefinita è path se la directory di origine non è specificata.

--subscription-id

Specifica l'ID sottoscrizione.

--workspace-name -w

Nome dell'area di lavoro.

<USER_SCRIPT_AND_ARGUMENTS>

Argomenti di invio dell'esecuzione, ad esempio il nome dello script e gli argomenti dello script.

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 ml run update

Aggiornare l'esecuzione aggiungendo tag.

az ml run update --run
                 [--add-tag]
                 [--experiment-name]
                 [--output-metadata-file]
                 [--path]
                 [--resource-group]
                 [--subscription-id]
                 [--workspace-name]

Parametri necessari

--run -r

RunId di un'esecuzione dell'esperimento.

Parametri facoltativi

--add-tag

Contrassegna le entità con la sintassi 'key[=value]'.

--experiment-name -e

Nome esperimento.

--output-metadata-file -t

Specificare un percorso del file di output facoltativo per l'output dell'oggetto strutturato.

--path

Percorso di una directory radice per i file di configurazione di esecuzione.

valore predefinito: .
--resource-group -g

Nome del gruppo di risorse.

--subscription-id

Specifica l'ID sottoscrizione.

--workspace-name -w

Nome dell'area di lavoro.

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.