az ml component

  • Riferimento

Nota

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

Gestire i componenti di Azure ML.

Il componente Azure ML definisce la configurazione del componente per i processi della pipeline. È possibile configurare le porte di input/output, l'ambiente di esecuzione e il comando del componente. Dopo aver creato il componente, è possibile fare riferimento ai componenti nel processo della pipeline per eseguirli nei contenitori Docker.

Comandi

Nome Descrizione Tipo Stato
az ml component archive

Archiviare un componente.

 Estensione Disponibilità generale
az ml component create

Creare un componente.

 Estensione Disponibilità generale
az ml component list

Elencare i componenti in un'area di lavoro.

 Estensione Disponibilità generale
az ml component restore

Ripristinare un componente archiviato.

 Estensione Disponibilità generale
az ml component show

Mostra i dettagli per un componente.

 Estensione Disponibilità generale
az ml component update

Aggiornare un componente. Attualmente solo alcuni campi (descrizione, display_name) supportano l'aggiornamento.

 Estensione Disponibilità generale

az ml component archive

Archiviare un componente.

L'archiviazione di un componente lo nasconde per impostazione predefinita dalle query di elenco (az ml component list). È comunque possibile continuare a fare riferimento e usare un componente archiviato nelle pipeline. È possibile archiviare un contenitore di componenti o una versione specifica del componente. L'archiviazione di un contenitore di componenti archivierà tutte le versioni del componente con il nome specificato. È possibile ripristinare un componente archiviato usando az ml component restore. Se l'intero contenitore di componenti è archiviato, non è possibile ripristinare singole versioni del componente. Sarà necessario ripristinare il contenitore del componente.

az ml component archive --name
                        [--label]
                        [--registry-name]
                        [--resource-group]
                        [--version]
                        [--workspace-name]

Esempio

Archiviare un contenitore di componenti (archivia tutte le versioni di tale componente)

az ml component archive --name my-component --resource-group my-resource-group --workspace-name my-workspace

Archiviare una versione specifica del componente

az ml component archive --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Parametri necessari

--name -n

Nome del componente.

Parametri facoltativi

--label -l

Etichetta del componente.

--registry-name

Se specificato, il comando avrà come destinazione il Registro di sistema anziché un'area di lavoro. Di conseguenza, il gruppo di risorse e l'area di lavoro non saranno necessari.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--version -v

Versione del componente.

--workspace-name -w

Nome dell'area di lavoro di Azure ML. È possibile configurare l'area di lavoro predefinita usando az configure --defaults workspace=<name>.

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

Creare un componente.

az ml component create --file
                       [--name]
                       [--registry-name]
                       [--resource-group]
                       [--set]
                       [--skip-validation]
                       [--version]
                       [--workspace-name]

Esempio

Creare un componente da un file di specifica YAML

az ml component create --file my_component.yml --resource-group my-resource-group --workspace-name my-workspace

Creare un componente da un file di specifica YAML con la versione specificata

az ml component create --file my_component.yml --version 1 --resource-group my-resource-group --workspace-name my-workspace

Creare un componente nel Registro di sistema da un file di specifica YAML

az ml component create --file my_component.yml --registry-name my-registry-name --resource-group my-resource-group

Creare un componente nel Registro di sistema da un file di specifica YAML con la versione specificata

az ml component create --file my_component.yml --version 1 --registry-name my-registry-name --resource-group my-resource-group

Parametri necessari

--file -f

Percorso locale del file YAML contenente la specifica del componente Azure ML. La documentazione di riferimento YAML per il componente è disponibile in: https://aka.ms/ml-cli-v2-component-command-yaml-reference.

Parametri facoltativi

--name -n

Nome del componente.

--registry-name

Se specificato, il comando avrà come destinazione il Registro di sistema anziché un'area di lavoro. Di conseguenza, il gruppo di risorse e l'area di lavoro non saranno necessari.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=.

--skip-validation

Ignorare la convalida durante la creazione della risorsa. Si noti che le risorse dipendenti non ignorano la convalida durante la creazione.

valore predefinito: False
--version -v

Versione del componente.

--workspace-name -w

Nome dell'area di lavoro di Azure ML. È possibile configurare l'area di lavoro predefinita usando az configure --defaults workspace=<name>.

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

Elencare i componenti in un'area di lavoro.

az ml component list [--archived-only]
                     [--include-archived]
                     [--max-results]
                     [--name]
                     [--registry-name]
                     [--resource-group]
                     [--workspace-name]

Esempio

Elencare tutti i componenti in un'area di lavoro

az ml component list --resource-group my-resource-group --workspace-name my-workspace

Elencare tutte le versioni dei componenti per il nome specificato in un'area di lavoro

az ml component list --name my-component --resource-group my-resource-group --workspace-name my-workspace

Elencare tutti i componenti in un'area di lavoro usando l'argomento --query per eseguire una query JMESPath sui risultati dei comandi.

az ml component list --query "[].{Name:name}"  --output table --resource-group my-resource-group --workspace-name my-workspace

Elencare tutti i componenti in un registro

az ml component list --registry-name my-registry-name --resource-group my-resource-group

Elencare tutte le versioni del componente per il nome specificato in un registro

az ml component list --name my-component --registry-name my-registry-name --resource-group my-resource-group

Elencare tutti i componenti di un Registro di sistema usando l'argomento --query per eseguire una query JMESPath sui risultati dei comandi.

az ml component list --query "[].{Name:name}"  --output table --registry-name my-registry-name --resource-group my-resource-group

Parametri facoltativi

--archived-only

Elencare solo i componenti archiviati.

valore predefinito: False
--include-archived

Elencare i componenti archiviati e i componenti attivi.

valore predefinito: False
--max-results -r

Numero massimo di risultati da restituire.

--name -n

Nome del componente.

--registry-name

Se specificato, il comando avrà come destinazione il Registro di sistema anziché un'area di lavoro. Di conseguenza, il gruppo di risorse e l'area di lavoro non saranno necessari.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--workspace-name -w

Nome dell'area di lavoro di Azure ML. È possibile configurare l'area di lavoro predefinita usando az configure --defaults workspace=<name>.

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

Ripristinare un componente archiviato.

Quando viene ripristinato un componente archiviato, non verrà più nascosto dalle query di elenco (az ml component list). Se viene archiviato un intero contenitore di componenti, è possibile ripristinare il contenitore archiviato. In questo modo verranno ripristinate tutte le versioni del componente con il nome specificato. Non è possibile ripristinare solo una versione specifica del componente se l'intero contenitore di componenti è archiviato. Sarà necessario ripristinare l'intero contenitore. Se è stata archiviata solo una singola versione del componente, è possibile ripristinare tale versione specifica.

az ml component restore --name
                        [--label]
                        [--registry-name]
                        [--resource-group]
                        [--version]
                        [--workspace-name]

Esempio

Ripristinare un contenitore di componenti archiviati (ripristina tutte le versioni di tale componente)

az ml component restore --name my-component --resource-group my-resource-group --workspace-name my-workspace

Ripristinare una versione specifica del componente archiviato

az ml component restore --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Parametri necessari

--name -n

Nome del componente.

Parametri facoltativi

--label -l

Etichetta del componente.

--registry-name

Se specificato, il comando avrà come destinazione il Registro di sistema anziché un'area di lavoro. Di conseguenza, il gruppo di risorse e l'area di lavoro non saranno necessari.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--version -v

Versione del componente.

--workspace-name -w

Nome dell'area di lavoro di Azure ML. È possibile configurare l'area di lavoro predefinita usando az configure --defaults workspace=<name>.

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

Mostra i dettagli per un componente.

az ml component show --name
                     [--label]
                     [--registry-name]
                     [--resource-group]
                     [--version]
                     [--workspace-name]

Esempio

Mostra dettagli per un componente con il nome e la versione specificati

az ml component show --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Mostra dettagli per un componente nel Registro di sistema con il nome e la versione specificati

az ml component show --name my-component --version 1 --registry-name my-registry-name --resource-group my-resource-group

Parametri necessari

--name -n

Nome del componente.

Parametri facoltativi

--label -l

Etichetta del componente.

--registry-name

Se specificato, il comando avrà come destinazione il Registro di sistema anziché un'area di lavoro. Di conseguenza, il gruppo di risorse e l'area di lavoro non saranno necessari.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--version -v

Versione del componente.

--workspace-name -w

Nome dell'area di lavoro di Azure ML. È possibile configurare l'area di lavoro predefinita usando az configure --defaults workspace=<name>.

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

Aggiornare un componente. Attualmente solo alcuni campi (descrizione, display_name) supportano l'aggiornamento.

az ml component update --name
                       --resource-group
                       --workspace-name
                       [--add]
                       [--force-string]
                       [--label]
                       [--registry-name]
                       [--remove]
                       [--set]
                       [--version]

Esempio

Aggiornare la descrizione di un componente

az ml component update -n my_component -v 1 --set description="new description" -g my-resource-group -w my-workspace

Parametri necessari

--name -n

Nome del componente.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--workspace-name -w

Nome dell'area di lavoro di Azure ML. È possibile configurare l'area di lavoro predefinita usando az configure --defaults workspace=<name>.

Parametri facoltativi

--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, string or JSON string>.

valore predefinito: []
--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

valore predefinito: False
--label -l

Etichetta del componente.

--registry-name

Se specificato, il comando avrà come destinazione il Registro di sistema anziché un'area di lavoro. Di conseguenza, il gruppo di risorse e l'area di lavoro non saranno necessari.

--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove> OR --remove propertyToRemove.

valore predefinito: []
--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=<value>.

valore predefinito: []
--version -v

Versione del componente.

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.