az ml registry

  • 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 registry . Altre informazioni sulle estensioni.

Gestire i registri di Azure ML.

Un registro di Azure ML è una risorsa di primo livello per Azure Machine Learning. Offre uno spazio di primo livello per archiviare altre risorse, a cui è quindi possibile accedere da più aree di lavoro in aree diverse.

Comandi

Nome Descrizione Tipo Stato
az ml registry create

Creare un registro.

 Estensione Disponibilità generale
az ml registry delete

Eliminare un determinato registro.

 Estensione Disponibilità generale
az ml registry list

Elencare tutti i registri in una sottoscrizione o in un gruppo di risorse.

 Estensione Disponibilità generale
az ml registry show

Mostra i dettagli per un Registro di sistema.

 Estensione Disponibilità generale
az ml registry update

Aggiornare un registro.

 Estensione Disponibilità generale

az ml registry create

Creare un registro.

Quando viene creato un Registro di sistema, diverse risorse di Azure che verranno usate dal Registro di sistema vengono create per impostazione predefinita, in particolare un Archiviazione di Azure e Registro Azure Container. L'uso di istanze di risorse di Azure esistenti per quelle quando si crea il Registro di sistema non è supportato.

az ml registry create --resource-group
                      [--display-name]
                      [--file]
                      [--name]
                      [--no-wait]
                      [--public-network-access]
                      [--set]
                      [--tags]

Esempio

Creare un registro da un file di specifica YAML.

az ml registry create --resource-group my-resource-group --file registry.yml

Parametri necessari

--resource-group -g

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

Parametri facoltativi

--display-name

Nome visualizzato per il Registro di sistema.

--file -f

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

--name -n

Nome del Registro di sistema di Azure ML.

--no-wait

Non attendere il completamento della creazione del Registro di sistema.

valore predefinito: False
--public-network-access

Consentire la connettività dell'endpoint pubblico per un registro.

--set

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

--tags

Coppie chiave-valore separate da spazi per i tag dell'oggetto.

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

Eliminare un determinato registro.

az ml registry delete [--name]
                      [--resource-group]

Esempio

Eliminare un registro da un gruppo di risorse specifico.

az ml registry delete --resource-group my-resource-group --name my-registry-name

Parametri facoltativi

--name -n

Nome del Registro di sistema di Azure ML. È possibile configurare il gruppo predefinito con az configure --defaults registry=<name>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<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 registry list

Elencare tutti i registri in una sottoscrizione o in un gruppo di risorse.

az ml registry list [--max-results]
                    [--resource-group]

Esempio

Elencare tutti i registri nel gruppo di risorse e nell'ID sottoscrizione predefiniti.

az ml registry list

Elencare tutti i registri nel gruppo di risorse predefinito nella sottoscrizione specificata. Se non è impostato alcun gruppo di risorse predefinito, elencare tutti i registri nella sottoscrizione.

az ml registry list --subscription my-subscription-id

Elencare tutti i registri in un gruppo di risorse e una sottoscrizione specifici.

az ml registry list --resource-group my-resource-group --subscription my-subscription-id

Elencare tutti i registri usando l'argomento --query per eseguire una query JMESPath sui risultati dei comandi.

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

Parametri facoltativi

--max-results -r

Numero massimo di risultati da restituire.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<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 registry show

Mostra i dettagli per un Registro di sistema.

az ml registry show --name
                    --resource-group

Esempio

Mostra i dettagli di un registro denominato che si trova nel gruppo di risorse e nella sottoscrizione specificati.

az ml registry show --resource-group my-resource-group --subscription my-subscription-id --name my-registry-name

Parametri necessari

--name -n

Nome del Registro di sistema di Azure ML. È possibile configurare il gruppo predefinito con az configure --defaults registry=<name>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<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 registry update

Aggiornare un registro.

Aggiornare un registro. Questo comando si comporta principalmente come il comando create, ad eccezione di ciò garantisce che il Registro di sistema di destinazione esista e possa essere eseguito senza un input --file se viene fornito un input --name valido. I campi possono essere modificati definendo nuovi valori in YAML, l'argomento --set o gli argomenti di input normali dei campi. Non tutti i campi sono attualmente sicuri da modificare. Le modifiche valide includono: modifiche arbitrarie ai tag del Registro di sistema e aggiunta di nuovi valori al campo region_details. AVVISO: l'argomento --file non è compatibile con la modifica dei valori tramite --set. Se si vuole impostare il Registro di sistema usando una combinazione di file e argomenti dell'interfaccia della riga di comando, usare gli argomenti dell'interfaccia della riga di comando diretti per i valori che si desidera modificare, come illustrato di seguito.

az ml registry update --resource-group
                      [--add]
                      [--display-name]
                      [--file]
                      [--force-string]
                      [--name]
                      [--no-wait]
                      [--public-network-access]
                      [--remove]
                      [--set]
                      [--tags]

Esempio

Aggiornare un registro da un file di specifica YAML.

az ml registry update --resource-group my-resource-group --file registry.yml --tags tag=value

Aggiornare campi specifici di un Registro di sistema

az ml registry update --resource-group my-resource-group --name myRegistry --set tags.tag=value

Parametri necessari

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<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: []
--display-name

Nome visualizzato per il Registro di sistema.

--file -f

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

--force-string

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

valore predefinito: False
--name -n

Nome del Registro di sistema di Azure ML.

--no-wait

Non attendere il completamento dell'aggiornamento del Registro di sistema.

valore predefinito: False
--public-network-access

Consentire la connettività dell'endpoint pubblico per un registro.

--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: []
--tags

Coppie chiave-valore separate da spazi per i tag dell'oggetto.

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.