Partager via

az ml deployment-template

  • Préversion

Note

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 deployment-template . Apprenez-en davantage sur les extensions.

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

Gérer les modèles de déploiement Azure ML.

Les modèles de déploiement sont des modèles réutilisables qui définissent des configurations de déploiement pour Azure ML. Ils prennent uniquement en charge les opérations basées sur le Registre (et non basées sur l’espace de travail) et offrent un moyen de normaliser et de partager des configurations de déploiement entre les équipes et les projets.

Commandes

Nom Description Type État
az ml deployment-template archive

Archivez un modèle de déploiement.

 Extension Preview
az ml deployment-template create

Créez un modèle de déploiement à partir d’un fichier YAML.

 Extension Preview
az ml deployment-template list

Répertorier les modèles de déploiement dans un registre.

 Extension Preview
az ml deployment-template restore

Restaurez un modèle de déploiement archivé.

 Extension Preview
az ml deployment-template show

Obtenez un modèle de déploiement spécifique par nom et version.

 Extension Preview
az ml deployment-template update

Mettez à jour des champs spécifiques d’un modèle de déploiement existant.

 Extension Preview

az ml deployment-template archive

Préversion

Le groupe de commandes « ml deployment-template » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Archivez un modèle de déploiement.

Archivez un modèle de déploiement pour le marquer comme inactif. Les modèles archivés ne sont pas retournés dans les opérations de liste par défaut. Vous pouvez archiver une version spécifique ou toutes les versions d’un modèle.

az ml deployment-template archive --name
                                  --registry-name
                                  --version
                                  [--no-wait]

Exemples

Archiver une version spécifique

az ml deployment-template archive --name my-template --version 1 --registry-name myregistry

Archiver sans attendre la fin

az ml deployment-template archive --name my-template --version 1 --registry-name myregistry --no-wait

Paramètres obligatoires

--name -n

Nom du modèle de déploiement.

--registry-name -r

Nom du registre. Cela est nécessaire, car les modèles de déploiement prennent uniquement en charge le nom du registre et non l’espace de travail.

--version -v

Version du modèle de déploiement.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--no-wait

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

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az ml deployment-template create

Préversion

Le groupe de commandes « ml deployment-template » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Créez un modèle de déploiement à partir d’un fichier YAML.

Créez un modèle de déploiement à l’aide d’un fichier de configuration YAML. Le fichier YAML doit contenir la définition complète du modèle de déploiement, y compris les points de terminaison, les paramètres et les métadonnées. Vous pouvez remplacer des valeurs spécifiques à l’aide de paramètres de ligne de commande.

az ml deployment-template create --registry-name
                                 [--file]
                                 [--name]
                                 [--no-wait]
                                 [--set]
                                 [--version]

Exemples

Créer un modèle de déploiement à partir d’un fichier YAML

az ml deployment-template create --file template.yml --registry-name myregistry

Créer avec des remplacements de nom et de version

az ml deployment-template create --file template.yml --name custom-template --version 2 --registry-name myregistry

Créer sans attendre la fin

az ml deployment-template create --file template.yml --registry-name myregistry --no-wait

Paramètres obligatoires

--registry-name -r

Nom du registre. Cela est nécessaire, car les modèles de déploiement prennent uniquement en charge le nom du registre et non l’espace de travail.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--file -f

Chemin local du fichier YAML contenant la spécification du modèle de déploiement Azure ML. Vous trouverez la documentation de référence YAML pour le modèle de déploiement à l’adresse suivante : https://aka.ms/ml-cli-v2-deployment-template-yaml.

--name -n

Nom du modèle de déploiement.

--no-wait

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

Propriété Valeur
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=value.

--version -v

Version du modèle de déploiement.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az ml deployment-template list

Préversion

Le groupe de commandes « ml deployment-template » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Répertorier les modèles de déploiement dans un registre.

Répertoriez tous les modèles de déploiement disponibles dans le Registre spécifié. Cette commande retourne tous les modèles ainsi que leurs métadonnées, y compris le nom, la version, la description et les balises.

az ml deployment-template list --registry-name

Exemples

Répertorier tous les modèles de déploiement dans un Registre

az ml deployment-template list --registry-name myregistry

Répertorier les modèles de déploiement avec un format de sortie spécifique

az ml deployment-template list --registry-name myregistry --output table

Paramètres obligatoires

--registry-name -r

Nom du registre. Cela est nécessaire, car les modèles de déploiement prennent uniquement en charge le nom du registre et non l’espace de travail.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az ml deployment-template restore

Préversion

Le groupe de commandes « ml deployment-template » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Restaurez un modèle de déploiement archivé.

Restaurez un modèle de déploiement précédemment archivé pour le rendre actif à nouveau. Les modèles restaurés apparaissent dans les opérations de liste. Vous pouvez restaurer une version spécifique ou toutes les versions d’un modèle.

az ml deployment-template restore --name
                                  --registry-name
                                  --version
                                  [--no-wait]

Exemples

Restaurer une version spécifique

az ml deployment-template restore --name my-template --version 1 --registry-name myregistry

Restaurer sans attendre l’achèvement

az ml deployment-template restore --name my-template --version 1 --registry-name myregistry --no-wait

Paramètres obligatoires

--name -n

Nom du modèle de déploiement.

--registry-name -r

Nom du registre. Cela est nécessaire, car les modèles de déploiement prennent uniquement en charge le nom du registre et non l’espace de travail.

--version -v

Version du modèle de déploiement.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--no-wait

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

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az ml deployment-template show

Préversion

Le groupe de commandes « ml deployment-template » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Obtenez un modèle de déploiement spécifique par nom et version.

Récupérez des informations détaillées sur un modèle de déploiement spécifique. Si la version n’est pas spécifiée, la dernière version est retournée.

az ml deployment-template show --name
                               --registry-name
                               --version

Exemples

Obtenir une version spécifique d’un modèle de déploiement

az ml deployment-template show --name my-template --version 1 --registry-name myregistry

Paramètres obligatoires

--name -n

Nom du modèle de déploiement.

--registry-name -r

Nom du registre. Cela est nécessaire, car les modèles de déploiement prennent uniquement en charge le nom du registre et non l’espace de travail.

--version -v

Version du modèle de déploiement.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az ml deployment-template update

Préversion

Le groupe de commandes « ml deployment-template » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Mettez à jour des champs spécifiques d’un modèle de déploiement existant.

Mettez à jour les champs de métadonnées (description et balises) d’un modèle de déploiement existant sans nécessiter de fichier YAML. Cette commande suit les conventions Azure CLI et accepte uniquement des mises à jour de champs spécifiques. Les balises sont fusionnées avec des balises existantes plutôt que remplacées.

Pour les modifications structurelles apportées au modèle de déploiement (points de terminaison, configuration du déploiement, etc.), utilisez la commande « create » avec un fichier YAML.

az ml deployment-template update --name
                                 --registry-name
                                 --version
                                 [--add]
                                 [--force-string]
                                 [--remove]
                                 [--set]

Exemples

Description du modèle de déploiement de mise à jour

az ml deployment-template update --name my-template --version 1 --registry-name myregistry --set "description=Updated description"

Mettre à jour des balises de modèle de déploiement

az ml deployment-template update --name my-template --version 1 --registry-name myregistry --set "tags=environment=production owner=ml-team"

Mettre à jour à la fois la description et les balises

az ml deployment-template update --name my-template --version 1 --registry-name myregistry --set "description=Production template" --set "tags=status=active"

Paramètres obligatoires

--name -n

Nom du modèle de déploiement.

--registry-name -r

Nom du registre. Cela est nécessaire, car les modèles de déploiement prennent uniquement en charge le nom du registre et non l’espace de travail.

--version -v

Version du modèle de déploiement.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

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

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
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.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
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.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
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>.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
Valeur par défaut: []
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False