az ml workspace

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 Apprentissage. 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 Recommandations.	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 Recommandations.	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 Recommandations. 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
                       [--application-insights]
                       [--container-registry]
                       [--description]
                       [--display-name]
                       [--enable-data-isolation]
                       [--file]
                       [--image-build-compute]
                       [--key-vault]
                       [--location]
                       [--managed-network]
                       [--name]
                       [--no-wait]
                       [--primary-user-assigned-identity]
                       [--public-network-access]
                       [--set]
                       [--storage-account]
                       [--tags]
                       [--update-dependent-resources]
                       [--workspace-hub]

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

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

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

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

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

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

--workspace-hub

Préversion

ID ARM fourni pour créer un espace de travail, l’espace de travail devient un espace de travail de projet et toutes les ressources dépendantes sont utilisées à partir de WorkspaceHub.

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 Recommandations) 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 (compte Stockage Azure, Azure Container Registry, Azure Application Recommandations, 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 case activée si l’espace de travail a été rompu. Pour l’espace de travail de point de terminaison privé, il vous aidera également à case activée 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 [--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

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

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

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

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

--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 Recommandations Application 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.