Partager via

az ml connection

  • Préversion
  • 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 de connexion az ml. En savoir plus sur les extensions.

Ce groupe de commandes est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Gérez la connexion de l’espace de travail Azure ML et ses dérivés plus spécifiques.

La connexion Azure ML offre un moyen sécurisé de stocker les informations d’authentification et de configuration nécessaires à la connexion et à l’interaction avec les ressources externes.

Commandes

Nom Description Type Statut
az ml connection create

Créer une connexion.

 Extension Aperçu
az ml connection delete

Supprimez une connexion.

 Extension Aperçu
az ml connection list

Répertorier toutes les connexions.

 Extension Aperçu
az ml connection show

Afficher les détails d’une connexion.

 Extension Aperçu
az ml connection update

Mettez à jour une connexion.

 Extension Aperçu

az ml connection create

Préversion

Le groupe de commandes « ml connection » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Créer une connexion.

La connexion permet de stocker les informations d’authentification et de configuration nécessaires pour se connecter et interagir avec les ressources externes.

az ml connection create --file
                        --resource-group
                        --workspace-name
                        [--name]
                        [--populate-secrets]
                        [--set]

Exemples

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

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

Créez une connexion à partir d’un fichier de spécification YAML et affichez la clé API dans la connexion retournée pour vérification.

az ml connection create --file connection.yml --resource-group my-resource-group --workspace-name my-workspace --populate-secrets

Paramètres obligatoires

--file -f

Chemin local du fichier YAML contenant la spécification de connexion Azure ML.

--resource-group -g

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

--workspace-name -w

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 .

Paramètres facultatifs

--name -n

Nom de l’environnement.

--populate-secrets -p

Pour les connexions basées sur une clé API, essayez de remplir les informations d’identification retournées avec la valeur secrète réelle. Ne fait rien pour les connexions non basées sur des clés API.

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

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

Préversion

Le groupe de commandes « ml connection » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Supprimez une connexion.

az ml connection delete --name
                        --resource-group
                        --workspace-name
                        [--yes]

Paramètres obligatoires

--name -n

Nom de l’environnement.

--resource-group -g

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

--workspace-name -w

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 .

Paramètres facultatifs

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

Préversion

Le groupe de commandes « ml connection » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Répertorier toutes les connexions.

Liste des connexions dans un espace de travail.

az ml connection list --resource-group
                      --workspace-name
                      [--max-results]
                      [--populate-secrets]
                      [--type]

Exemples

Répertorier toutes les connexions dans un espace de travail

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

Répertorier toutes les connexions dans un espace de travail et afficher la clé API pour les connexions applicables

az ml connection list --resource-group my-resource-group --workspace-name my-workspace --populate-secrets

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

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

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

--workspace-name -w

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 .

Paramètres facultatifs

--max-results -r

Nombre maximal de résultats à retourner.

--populate-secrets -p

Pour les connexions basées sur une clé API, essayez de remplir les informations d’identification retournées avec la valeur secrète réelle. Ne fait rien pour les connexions non basées sur des clés API.

valeur par défaut: False
--type -t

Type de connexion Azure ML à répertorier.

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

Préversion

Le groupe de commandes « ml connection » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Afficher les détails d’une connexion.

az ml connection show --name
                      --resource-group
                      --workspace-name
                      [--populate-secrets]

Exemples

Affichez les détails d’une connexion, y compris sa clé API.

az ml connection show --resource-group my-resource-group --name my-connection-name --workspace-name my-workspace --populate-secrets

Paramètres obligatoires

--name -n

Nom de l’environnement.

--resource-group -g

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

--workspace-name -w

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 .

Paramètres facultatifs

--populate-secrets -p

Pour les connexions basées sur une clé API, essayez de remplir les informations d’identification retournées avec la valeur secrète réelle. Ne fait rien pour les connexions non basées sur des clés API.

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

Préversion

Le groupe de commandes « ml connection » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Mettez à jour une connexion.

az ml connection update --name
                        --resource-group
                        --workspace-name
                        [--add]
                        [--force-string]
                        [--populate-secrets]
                        [--remove]
                        [--set]

Exemples

mettez à jour une connexion à partir d’un fichier de spécification YAML.

az ml connection update --resource-group my-resource-group --name my-connection-name --workspace-name my-workspace

Paramètres obligatoires

--name -n

Nom de l’environnement.

--resource-group -g

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

--workspace-name -w

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 .

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: []
--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
--populate-secrets -p

Pour les connexions basées sur une clé API, essayez de remplir les informations d’identification retournées avec la valeur secrète réelle. Ne fait rien pour les connexions non basées sur des clés API.

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