az ml workspace

  • 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 workspace . En savoir plus sur les extensions.

Gérer les espaces de travail Azure ML.

Un espace de travail Azure ML est la ressource de niveau supérieur pour Azure Machine Learning. Il fournit un emplacement centralisé pour suivre les ressources et les ressources utilisées dans vos flux de travail ML, ainsi que les journaux et les artefacts générés à partir de vos travaux d’apprentissage.

Si vous effectuez une mise à niveau de l’interface CLI v1 vers v2, vous avez besoin des deux modifications suivantes dans l’étendue de la gestion de l’espace de travail :

  • Mettre à niveau az ml workspace private-endpoint les commandes vers des commandes équivalentes az network private-endpoint .
  • En outre, mettez à niveau az ml workspace share les commandes vers des commandes équivalentes az role assignment create .

Commandes

Nom Description Type Statut
az ml workspace create

Créez un espace de travail.

 Extension GA
az ml workspace delete

Supprimez un espace de travail.

 Extension GA
az ml workspace diagnose

Diagnostiquer les problèmes de configuration de l’espace de travail.

 Extension GA
az ml workspace list

Répertorie tous les espaces de travail d’un abonnement.

 Extension GA
az ml workspace list-keys

Répertoriez les clés d’espace de travail pour les ressources dépendantes telles que Stockage Azure, Azure Container Registry et Azure Application Insights.

 Extension GA
az ml workspace outbound-rule

Gérer les règles de trafic sortant pour le réseau managé d’un espace de travail Azure ML.

 Extension GA
az ml workspace outbound-rule list

Répertorier toutes les règles de trafic sortant du réseau managé pour un espace de travail.

 Extension GA
az ml workspace outbound-rule remove

Supprimez une règle de trafic sortant du réseau managé pour un espace de travail.

 Extension GA
az ml workspace outbound-rule set

Ajoutez ou mettez à jour une règle sortante dans le réseau managé pour un espace de travail.

 Extension GA
az ml workspace outbound-rule show

Afficher les détails d’une règle de trafic sortant de réseau managé pour un espace de travail.

 Extension GA
az ml workspace provision-network

Provisionner un réseau managé d’espace de travail.

 Extension GA
az ml workspace show

Afficher les détails d’un espace de travail.

 Extension GA
az ml workspace sync-keys

Synchronisez les clés d’espace de travail pour les ressources dépendantes telles que Stockage Azure, Azure Container Registry et Azure Application Insights.

 Extension GA
az ml workspace update

Mettez à jour un espace de travail.

 Extension GA

az ml workspace create

Créez un espace de travail.

Lorsqu’un espace de travail est créé, plusieurs ressources Azure qui seront utilisées par Azure ML sont également créées par défaut : Stockage Azure, Azure Container Registry, Azure Key Vault et Azure Application Insights. Vous pouvez utiliser plutôt des instances de ressources Azure existantes pour celles qui créent l’espace de travail en spécifiant les ID de ressource dans le fichier YAML de configuration de l’espace de travail.

az ml workspace create --resource-group
                       [--allow-roleassignment-on-rg]
                       [--application-insights]
                       [--container-registry]
                       [--default-resource-group]
                       [--description]
                       [--display-name]
                       [--enable-data-isolation]
                       [--file]
                       [--hub-id]
                       [--image-build-compute]
                       [--key-vault]
                       [--kind]
                       [--location]
                       [--managed-network]
                       [--name]
                       [--no-wait]
                       [--primary-user-assigned-identity]
                       [--public-network-access]
                       [--set]
                       [--storage-account]
                       [--system-datastores-auth-mode]
                       [--tags]
                       [--update-dependent-resources]

Exemples

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

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

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

--allow-roleassignment-on-rg -r
Préversion

Indicateur permettant de déterminer si un espace de travail peut avoir des attributions de rôles au niveau du groupe de ressources.

valeur par défaut: True
--application-insights -a

ID ARM des insights d’application associés à cet espace de travail.

--container-registry -c

ID ARM du registre de conteneurs associé à cet espace de travail.

--default-resource-group
Préversion

Type hub uniquement. Si cette option est définie, les projets enfants de ce hub ont leur groupe de ressources défini par défaut.

--description

Description de l’espace de travail Azure ML.

--display-name

Nom complet de l’espace de travail.

--enable-data-isolation -e

Indicateur permettant de déterminer si l’isolation des données d’un espace de travail est activée. L’indicateur ne peut être défini qu’à l’étape de création, il ne peut pas être mis à jour.

valeur par défaut: False
--file -f

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

--hub-id
Préversion

Type de projet uniquement : ID ARM qui définit le hub parent de ce projet.

--image-build-compute -i

Nom de la cible de calcul à utiliser pour créer des images Docker d’environnement lorsque le registre de conteneurs se trouve derrière un réseau virtuel.

--key-vault -k

ID ARM du coffre de clés associé à cet espace de travail.

--kind
Préversion

Spécifie les espaces de travail en tant que type spécifique, en remplaçant la valeur affectée dans YAML, le cas échéant. La valeur par défaut est la valeur par défaut. Les types valides sont les suivants : par défaut, hub et projet.

--location -l

Emplacement à utiliser pour le nouvel espace de travail.

--managed-network -m
Préversion

Mode d’isolation réseau managé pour l’espace de travail.

--name -n

Nom de l’espace de travail Azure ML.

--no-wait

N’attendez pas la fin de la création de l’espace de travail.

valeur par défaut: False
--primary-user-assigned-identity -p

Identificateur ARM de l’identité managée affectée par l’utilisateur principal, dans le cas où plusieurs sont spécifiés. En outre, l’identité managée par défaut pour le calcul sans cluster.

--public-network-access

Autoriser la connectivité de point de terminaison public lorsqu’un espace de travail est activé pour une liaison privée.

--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=.

--storage-account -s

ID ARM du compte de stockage associé à cet espace de travail.

--system-datastores-auth-mode -d
Préversion

Spécifie le mode d’authentification pour les magasins de données système. Les modes valides sont : accesskey et identity.

--tags

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

--update-dependent-resources -u

En spécifiant --update_dependent_resources, donne votre consentement pour mettre à jour les ressources dépendantes de l’espace de travail. La mise à jour de la ressource Azure Container Registry ou Application Insights attachée à l’espace de travail peut interrompre la traçabilité des travaux précédents, des points de terminaison d’inférence déployés ou votre capacité à réexécuter des travaux antérieurs dans cet espace de travail.

valeur par défaut: False
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 workspace delete

Supprimez un espace de travail.

Par défaut, les ressources dépendantes associées à l’espace de travail (Stockage Azure, Azure Container Registry, Azure Key Vault, Azure Application Insights) ne sont pas supprimées. Pour les supprimer également, incluez --all-resources. Pour supprimer définitivement l’espace de travail, incluez --définitivement-delete.

az ml workspace delete --name
                       --resource-group
                       [--all-resources]
                       [--no-wait]
                       [--permanently-delete]
                       [--yes]

Paramètres obligatoires

--name -n

Nom de l’espace de travail Azure ML. Vous pouvez configurer l’espace de travail par défaut à l’aide az configure --defaults workspace=<name>de .

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

--all-resources

Supprimez toutes les ressources dépendantes associées à l’espace de travail (Stockage Azure compte, Azure Container Registry, Azure Application Insights, Azure Key Vault).

valeur par défaut: False
--no-wait

N’attendez pas la fin de l’opération de longue durée. La valeur par défaut est FALSE.

valeur par défaut: False
--permanently-delete -p

Les espaces de travail sont supprimés de manière réversible par défaut pour autoriser la récupération des données d’espace de travail. Définissez cet indicateur pour remplacer le comportement de suppression réversible et supprimer définitivement votre espace de travail.

valeur par défaut: False
--yes -y

Ne pas demander de confirmation.

valeur par défaut: False
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 workspace diagnose

Diagnostiquer les problèmes de configuration de l’espace de travail.

Si votre espace de travail ne fonctionne pas comme prévu, vous pouvez exécuter ce diagnostic pour vérifier si l’espace de travail a été rompu. Pour l’espace de travail de point de terminaison privé, il permet également de vérifier si la configuration du réseau sur cet espace de travail et sa ressource dépendante présente un problème ou non.

az ml workspace diagnose --name
                         --resource-group
                         [--no-wait]

Exemples

diagnostiquer un espace de travail.

az ml workspace diagnose --name my-workspace-name --no-wait -g my-resource-group

Paramètres obligatoires

--name -n

Nom de l’espace de travail Azure ML. Vous pouvez configurer l’espace de travail par défaut à l’aide az configure --defaults workspace=<name>de .

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

--no-wait

N’attendez pas la fin de l’opération de longue durée. La valeur par défaut est FALSE.

valeur par défaut: False
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 workspace list

Répertorie tous les espaces de travail d’un abonnement.

La liste des espaces de travail peut être filtrée par groupe de ressources.

az ml workspace list [--filtered-kinds]
                     [--max-results]
                     [--resource-group]

Exemples

Répertorier tous les espaces de travail d’un groupe de ressources

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

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

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

Paramètres facultatifs

--filtered-kinds
Préversion

Répertorier uniquement les types d’espaces de travail spécifiés, sous forme de liste séparée par des virgules. Les types valides sont les suivants : par défaut, hub et projet.

--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 workspace list-keys

Répertoriez les clés d’espace de travail pour les ressources dépendantes telles que Stockage Azure, Azure Container Registry et Azure Application Insights.

az ml workspace list-keys --name
                          --resource-group

Paramètres obligatoires

--name -n

Nom de l’espace de travail Azure ML. Vous pouvez configurer l’espace de travail par défaut à l’aide az configure --defaults workspace=<name>de .

--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 workspace provision-network

Provisionner un réseau managé d’espace de travail.

Déclenche l’espace de travail pour approvisionner le réseau managé. La spécification de l’indicateur spark activé prépare le réseau managé de l’espace de travail pour la prise en charge de Spark. La valeur par défaut est false si elle n’est pas spécifiée, mais peut être activée ultérieurement en exécutant à nouveau cette commande avec cet indicateur. Une fois activé, il ne peut pas être désactivé.

az ml workspace provision-network --name
                                  --resource-group
                                  [--include-spark]
                                  [--no-wait]

Exemples

provisionner un réseau managé.

az ml workspace provision-network --include-spark --name my-workspace-name --no-wait -g my-resource-group

Paramètres obligatoires

--name -n

Nom de l’espace de travail Azure ML. Vous pouvez configurer l’espace de travail par défaut à l’aide az configure --defaults workspace=<name>de .

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

--include-spark

Boolean [true/false] pour si le réseau managé doit être provisionné pour tenir compte des travaux Spark. La valeur par défaut est false si l’indicateur n’est pas défini. Elle peut être activée ultérieurement en exécutant à nouveau cette commande avec cet indicateur.

valeur par défaut: False
--no-wait

N’attendez pas la fin de l’opération de longue durée. La valeur par défaut est FALSE.

valeur par défaut: False
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 workspace show

Afficher les détails d’un espace de travail.

az ml workspace show --name
                     --resource-group

Paramètres obligatoires

--name -n

Nom de l’espace de travail Azure ML. Vous pouvez configurer l’espace de travail par défaut à l’aide az configure --defaults workspace=<name>de .

--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 workspace sync-keys

Synchronisez les clés d’espace de travail pour les ressources dépendantes telles que Stockage Azure, Azure Container Registry et Azure Application Insights.

Si les clés d’une ressource de l’espace de travail sont modifiées, la mise à jour automatique des clés peut prendre environ une heure. Cette commande déclenche la synchronisation immédiate des clés de l’espace de travail. Un scénario possible nécessite un accès immédiat au stockage après avoir régénéré les clés de stockage.

az ml workspace sync-keys --name
                          --resource-group
                          [--no-wait]

Paramètres obligatoires

--name -n

Nom de l’espace de travail Azure ML. Vous pouvez configurer l’espace de travail par défaut à l’aide az configure --defaults workspace=<name>de .

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

--no-wait

N’attendez pas la fin de l’opération de longue durée. La valeur par défaut est FALSE.

valeur par défaut: False
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 workspace update

Mettez à jour un espace de travail.

Les propriétés « description », « tags » et « friendly_name » peuvent être mises à jour.

az ml workspace update --name
                       --resource-group
                       [--add]
                       [--allow-roleassignment-on-rg]
                       [--application-insights]
                       [--container-registry]
                       [--description]
                       [--display-name]
                       [--file]
                       [--force-string]
                       [--image-build-compute]
                       [--managed-network]
                       [--no-wait]
                       [--primary-user-assigned-identity]
                       [--public-network-access]
                       [--remove]
                       [--set]
                       [--system-datastores-auth-mode]
                       [--update-dependent-resources]

Exemples

mettez à jour un espace de travail à partir d’un fichier de spécification YAML.

az ml workspace update --resource-group my-resource-group --name my-workspace-name --file workspace.yml

Paramètres obligatoires

--name -n

Nom de l’espace de travail Azure ML. Vous pouvez configurer l’espace de travail par défaut à l’aide az configure --defaults workspace=<name>de .

--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: []
--allow-roleassignment-on-rg -r
Préversion

Indicateur permettant de déterminer si un espace de travail peut avoir des attributions de rôles au niveau du groupe de ressources.

--application-insights -a

ID ARM des insights d’application associés à cet espace de travail.

--container-registry -c

ID ARM du registre de conteneurs associé à cet espace de travail.

--description

Description de l’espace de travail Azure ML.

--display-name

Nom complet de l’espace de travail.

--file -f

Chemin local du fichier YAML contenant la spécification de l’espace de travail Azure ML. Vous trouverez les documents de référence YAML pour l’espace de travail à l’adresse suivante : https://aka.ms/ml-cli-v2-workspace-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
--image-build-compute -i

Nom de la cible de calcul à utiliser pour créer des images Docker d’environnement lorsque le registre de conteneurs se trouve derrière un réseau virtuel.

--managed-network -m
Préversion

Mode d’isolation réseau managé pour l’espace de travail.

--no-wait

N’attendez pas la fin de l’opération de longue durée. La valeur par défaut est FALSE.

valeur par défaut: False
--primary-user-assigned-identity -p

ID ARM de l’identité affectée par l’utilisateur principal associée à cet espace de travail.

--public-network-access

Autoriser la connectivité de point de terminaison public lorsqu’un espace de travail est activé pour une liaison privée.

--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: []
--system-datastores-auth-mode -d
Préversion

Spécifie le mode d’authentification pour les magasins de données système. Les modes valides sont : accesskey et identity.

--update-dependent-resources -u

En spécifiant --update_dependent_resources, donne votre consentement pour mettre à jour les ressources dépendantes de l’espace de travail. La mise à jour de la ressource Azure Container Registry ou Application Insights attachée à l’espace de travail peut interrompre la traçabilité des travaux précédents, des points de terminaison d’inférence déployés ou votre capacité à réexécuter des travaux antérieurs dans cet espace de travail.

valeur par défaut: False
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.