az ml registry

  • Referenz

Hinweis

Diese Referenz ist Teil der ml-Erweiterung für die Azure CLI (Version 2.15.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az ml-Registrierungsbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten von Azure ML-Registrierungen.

Eine Azure ML-Registrierung ist eine Ressource der obersten Ebene für Azure Machine Learning. Sie bietet einen Platz auf oberster Ebene, um andere Ressourcen zu speichern, auf die dann über mehrere Arbeitsbereiche in verschiedenen Regionen zugegriffen werden kann.

Befehle

Name Beschreibung Typ Status
az ml registry create

Erstellen einer Registrierung.

 Erweiterung Allgemein verfügbar
az ml registry delete

Löschen Einer bestimmten Registrierung.

 Erweiterung Allgemein verfügbar
az ml registry list

Listet alle Registrierungen in einem Abonnement oder einer Ressourcengruppe auf.

 Erweiterung Allgemein verfügbar
az ml registry show

Details für eine Registrierung anzeigen.

 Erweiterung Allgemein verfügbar
az ml registry update

Aktualisieren sie eine Registrierung.

 Erweiterung Allgemein verfügbar

az ml registry create

Erstellen einer Registrierung.

Wenn eine Registrierung erstellt wird, werden mehrere Azure-Ressourcen, die von der Registrierung verwendet werden, standardmäßig erstellt, insbesondere eine Azure Storage- und Azure Container-Registrierung. Die Verwendung vorhandener Azure-Ressourceninstanzen für diejenigen beim Erstellen der Registrierung wird nicht unterstützt.

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

Beispiele

Erstellen Sie eine Registrierung aus einer YAML-Spezifikationsdatei.

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

Erforderliche Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--display-name

Anzeigename für die Registrierung.

--file -f

Lokaler Pfad zur YAML-Datei, die die Azure ML-Registrierungsspezifikation enthält. Die YAML-Referenzdokumente für die Registrierung finden Sie unter: https://aka.ms/ml-cli-v2-registry-yaml-reference.

--name -n

Name der Azure ML-Registrierung.

--no-wait

Warten Sie nicht, bis die Registrierungserstellung abgeschlossen ist.

Standardwert: False
--public-network-access

Öffentliche Endpunktkonnektivität für eine Registrierung zulassen.

--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=.

--tags

Leerzeichentrennte Schlüssel-Wert-Paare für die Tags des Objekts.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az ml registry delete

Löschen Einer bestimmten Registrierung.

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

Beispiele

Löschen sie eine Registrierung aus einer bestimmten Ressourcengruppe.

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

Optionale Parameter

--name -n

Name der Azure ML-Registrierung. Sie können die Standardgruppe mit az configure --defaults registry=<name> konfigurieren.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az ml registry list

Listet alle Registrierungen in einem Abonnement oder einer Ressourcengruppe auf.

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

Beispiele

Listet alle Registrierungen in der Standardressourcengruppe und Abonnement-ID auf.

az ml registry list

Listet alle Registrierungen in der Standardressourcengruppe im angegebenen Abonnement auf. Wenn keine Standardressourcengruppe festgelegt ist, führen Sie alle Registrierungen im Abonnement auf.

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

Listet alle Registrierungen in einer bestimmten Ressourcengruppe und einem bestimmten Abonnement auf.

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

Auflisten aller Registrierungen mithilfe des Arguments --query zum Ausführen einer JMESPath-Abfrage für die Ergebnisse von Befehlen.

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

Optionale Parameter

--max-results -r

Maximale Anzahl der zurückzugebenden Ergebnisse.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az ml registry show

Details für eine Registrierung anzeigen.

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

Beispiele

Zeigen Sie Details einer benannten Registrierung an, die sich in der angegebenen Ressourcengruppe und im angegebenen Abonnement befindet.

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

Erforderliche Parameter

--name -n

Name der Azure ML-Registrierung. Sie können die Standardgruppe mit az configure --defaults registry=<name> konfigurieren.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az ml registry update

Aktualisieren sie eine Registrierung.

Aktualisieren sie eine Registrierung. Dieser Befehl verhält sich hauptsächlich wie der Befehl "Erstellen", es sei denn, es wird sichergestellt, dass die Zielregistrierung vorhanden ist, und sie kann ohne --Dateieingabe ausgeführt werden, wenn eine gültige Eingabe mit --name bereitgestellt wird. Felder können geändert werden, indem neue Werte in YAML, das Argument --set oder die normalen Eingabeargumente der Felder definiert werden. Nicht alle Felder sind derzeit sicher zu ändern. Gültige Änderungen sind: Willkürliche Änderungen an den Registrierungstags und hinzufügen neue Werte zum Feld region_details. WARNUNG: Das Argument "-file" ist nicht mit dem Ändern von Werten durch --set kompatibel. Wenn Sie die Registrierung mithilfe einer Kombination aus datei- und CLI-Argumenten festlegen möchten, verwenden Sie die direkten CLI-Argumente für die Werte, die Sie ändern möchten, wie unten dargestellt.

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

Beispiele

Aktualisieren sie eine Registrierung aus einer YAML-Spezifikationsdatei.

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

Aktualisieren bestimmter Felder einer Registrierung

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

Erforderliche Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

Standardwert: []
--display-name

Anzeigename für die Registrierung.

--file -f

Lokaler Pfad zur YAML-Datei, die die Azure ML-Registrierungsspezifikation enthält. Die YAML-Referenzdokumente für die Registrierung finden Sie unter: https://aka.ms/ml-cli-v2-registry-yaml-reference.

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Standardwert: False
--name -n

Name der Azure ML-Registrierung.

--no-wait

Warten Sie nicht, bis das Registrierungsupdate abgeschlossen ist.

Standardwert: False
--public-network-access

Öffentliche Endpunktkonnektivität für eine Registrierung zulassen.

--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

Standardwert: []
--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.

Standardwert: []
--tags

Leerzeichentrennte Schlüssel-Wert-Paare für die Tags des Objekts.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.