Partager via

az ml registry

  • Référence

Remarque

Cette référence fait partie de l’extension ml pour Azure CLI (version 2.15.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az ml Registry . En savoir plus sur les extensions.

Gérer les registres Azure ML.

Un registre Azure ML est une ressource de niveau supérieur pour Azure Machine Apprentissage. Il fournit un espace de niveau supérieur pour stocker d’autres ressources, qui sont ensuite accessibles par plusieurs espaces de travail dans différentes régions.

Commandes

Nom Description Type Statut
az ml registry create

Créer un registre.

 Extension GA
az ml registry delete

Supprimez un registre donné.

 Extension GA
az ml registry list

Répertorier tous les registres d’un abonnement ou d’un groupe de ressources.

 Extension GA
az ml registry show

Afficher les détails d’un registre.

 Extension GA
az ml registry update

Mettez à jour un registre.

 Extension GA

az ml registry create

Créer un registre.

Lorsqu’un registre est créé, plusieurs ressources Azure qui seront utilisées par registre sont créées par défaut, en particulier une Stockage Azure et Azure Container Registry. L’utilisation d’instances de ressources Azure existantes pour celles qui créent le Registre n’est pas prise en charge.

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

Exemples

Créez un registre à partir d’un fichier de spécification YAML.

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

Paramètres obligatoires

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--display-name

Nom complet du Registre.

--file -f

Chemin local du fichier YAML contenant la spécification du Registre Azure ML. Vous trouverez les documents de référence YAML pour le Registre à l’adresse suivante : https://aka.ms/ml-cli-v2-registry-yaml-reference.

--name -n

Nom du registre Azure ML.

--no-wait

N’attendez pas la fin de la création du Registre.

valeur par défaut: False
--public-network-access

Autoriser la connectivité de point de terminaison public pour un registre.

--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=.

--tags

Paires clé-valeur séparées par espace pour les balises de l’objet.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az ml registry delete

Supprimez un registre donné.

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

Exemples

Supprimez un registre d’un groupe de ressources spécifique.

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

Paramètres facultatifs

--name -n

Nom du registre Azure ML. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults registry=<name>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az ml registry list

Répertorier tous les registres d’un abonnement ou d’un groupe de ressources.

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

Exemples

Répertoriez tous les registres dans le groupe de ressources et l’ID d’abonnement par défaut.

az ml registry list

Répertoriez tous les registres du groupe de ressources par défaut dans l’abonnement spécifié. Si aucun groupe de ressources par défaut n’est défini, listez tous les registres de l’abonnement.

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

Répertorie tous les registres d’un groupe de ressources et d’un abonnement spécifiques.

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

Répertoriez tous les registres à l’aide de l’argument --query pour exécuter une requête JMESPath sur les résultats des commandes.

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

Paramètres facultatifs

--max-results -r

Nombre maximal de résultats à retourner.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az ml registry show

Afficher les détails d’un registre.

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

Exemples

Affichez les détails d’un registre nommé qui se trouve dans le groupe de ressources et l’abonnement spécifiés.

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

Paramètres obligatoires

--name -n

Nom du registre Azure ML. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults registry=<name>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az ml registry update

Mettez à jour un registre.

Mettez à jour un registre. Cette commande se comporte principalement comme la commande create, sauf qu’elle garantit que le registre cible existe et qu’elle peut être exécutée sans entrée --file si une entrée --name valide est fournie. Les champs peuvent être modifiés en définissant de nouvelles valeurs dans YAML, l’argument --set ou les arguments d’entrée normaux des champs. Tous les champs ne sont actuellement pas sécurisés à modifier. Les modifications valides sont les suivantes : modifications arbitraires apportées aux balises de Registre et ajout de nouvelles valeurs au champ region_details. AVERTISSEMENT : L’argument --file n’est pas compatible avec la modification des valeurs par le biais de --set. Si vous souhaitez définir le Registre à l’aide d’une combinaison d’un fichier et d’args CLI, utilisez les arguments CLI directs pour les valeurs que vous souhaitez modifier, comme illustré ci-dessous.

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

Exemples

Mettez à jour un registre à partir d’un fichier de spécification YAML.

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

Mettre à jour des champs spécifiques d’un registre

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

Paramètres obligatoires

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string or JSON string>.

valeur par défaut: []
--display-name

Nom complet du Registre.

--file -f

Chemin local du fichier YAML contenant la spécification du Registre Azure ML. Vous trouverez les documents de référence YAML pour le Registre à l’adresse suivante : https://aka.ms/ml-cli-v2-registry-yaml-reference.

--force-string

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

valeur par défaut: False
--name -n

Nom du registre Azure ML.

--no-wait

N’attendez pas la fin de la mise à jour du Registre.

valeur par défaut: False
--public-network-access

Autoriser la connectivité de point de terminaison public pour un registre.

--remove

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list <indexToRemove> OR --remove propertyToRemove.

valeur par défaut: []
--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=<value>.

valeur par défaut: []
--tags

Paires clé-valeur séparées par espace pour les balises de l’objet.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.