Partager via

az ml service

  • Référence

Remarque

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

Gérer les services opérationnels.

Commandes

Nom Description Type État
az ml service delete

Supprimez un service de l’espace de travail.

 Extension GA
az ml service get-access-token

Obtenez un jeton pour émettre des demandes de service.

 Extension GA
az ml service get-keys

Obtenez des clés pour émettre des demandes sur un service.

 Extension GA
az ml service get-logs

Obtenir les journaux d’activité d’un service.

 Extension GA
az ml service list

Répertorier les services dans l’espace de travail.

 Extension GA
az ml service regen-key

Régénérer des clés pour un service.

 Extension GA
az ml service run

Exécutez un service dans l’espace de travail.

 Extension GA
az ml service show

Afficher les détails d’un service dans l’espace de travail.

 Extension GA
az ml service update

Mettez à jour un service dans l’espace de travail.

 Extension GA

az ml service delete

Supprimez un service de l’espace de travail.

az ml service delete --name
                     [--path]
                     [--resource-group]
                     [--subscription-id]
                     [--workspace-name]
                     [-v]

Paramètres obligatoires

--name -n

Nom du service à supprimer.

Paramètres facultatifs

--path

Chemin d’accès à un dossier de projet. Valeur par défaut : répertoire actif.

--resource-group -g

Groupe de ressources correspondant à l’espace de travail fourni.

--subscription-id

Spécifie l’ID d’abonnement.

--workspace-name -w

Nom de l’espace de travail contenant le service à supprimer.

-v

Indicateur de détail.

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 service get-access-token

Obtenez un jeton pour émettre des demandes de service.

az ml service get-access-token --name
                               [--path]
                               [--resource-group]
                               [--subscription-id]
                               [--workspace-name]
                               [-v]

Paramètres obligatoires

--name -n

Nom du service.

Paramètres facultatifs

--path

Chemin d’accès à un dossier de projet. Valeur par défaut : répertoire actif.

--resource-group -g

Groupe de ressources correspondant à l’espace de travail fourni.

--subscription-id

Spécifie l’ID d’abonnement.

--workspace-name -w

Nom de l’espace de travail contenant le service à afficher.

-v

Indicateur de détail.

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 service get-keys

Obtenez des clés pour émettre des demandes sur un service.

az ml service get-keys --name
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]
                       [-v]

Paramètres obligatoires

--name -n

Nom du service.

Paramètres facultatifs

--path

Chemin d’accès à un dossier de projet. Valeur par défaut : répertoire actif.

--resource-group -g

Groupe de ressources correspondant à l’espace de travail fourni.

--subscription-id

Spécifie l’ID d’abonnement.

--workspace-name -w

Nom de l’espace de travail contenant le service à afficher.

-v

Indicateur de détail.

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 service get-logs

Obtenir les journaux d’activité d’un service.

az ml service get-logs --name
                       [--init]
                       [--num_lines]
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]
                       [-v]

Paramètres obligatoires

--name -n

Nom du service.

Paramètres facultatifs

--init -i

Obtenez les journaux d’activité du conteneur init au lieu du conteneur de scoring.

Valeur par défaut: False
--num_lines -l

Nombre de lignes de journal à retourner à partir de la queue (la valeur par défaut est 5 000).

Valeur par défaut: 5000
--path

Chemin d’accès à un dossier de projet. Valeur par défaut : répertoire actif.

--resource-group -g

Groupe de ressources correspondant à l’espace de travail fourni.

--subscription-id

Spécifie l’ID d’abonnement.

--workspace-name -w

Nom de l’espace de travail contenant le service à afficher.

-v

Indicateur de détail.

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

Répertorier les services dans l’espace de travail.

az ml service list [--compute-type]
                   [--image-digest]
                   [--model-id]
                   [--model-name]
                   [--path]
                   [--property]
                   [--resource-group]
                   [--subscription-id]
                   [--tag]
                   [--workspace-name]
                   [-v]

Paramètres facultatifs

--compute-type -c

S’il est fourni, affiche uniquement les services qui ont le type de calcul spécifié. (Les options sont « ACI », « AKS »).

--image-digest

S’il est fourni, affiche uniquement les services qui ont le digest d’image spécifié.

--model-id

S’il est fourni, affiche uniquement les services qui ont l’ID de modèle spécifié.

--model-name

S’il est fourni, affiche uniquement les services qui ont le nom de modèle spécifié.

--path

Chemin d’accès à un dossier de projet. Valeur par défaut : répertoire actif.

--property

Si elle est fournie, filtre en fonction de la clé/valeur fournie (e.g. key ou key=value). Plusieurs propriétés peuvent être spécifiées avec plusieurs options --property.

Valeur par défaut: []
--resource-group -g

Groupe de ressources correspondant à l’espace de travail fourni.

--subscription-id

Spécifie l’ID d’abonnement.

--tag

Si elle est fournie, filtre en fonction de la clé/valeur fournie (e.g. key ou key=value). Plusieurs balises peuvent être spécifiées avec plusieurs options --tag.

Valeur par défaut: []
--workspace-name -w

Nom de l’espace de travail contenant les services à répertorier.

-v

Indicateur de détail.

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 service regen-key

Régénérer des clés pour un service.

az ml service regen-key --key
                        --name
                        [--path]
                        [--resource-group]
                        [--set-key]
                        [--subscription-id]
                        [--workspace-name]
                        [-v]

Paramètres obligatoires

--key -k

Quelle clé régénérer, si la regénération est spécifiée. Options : principal, secondaire.

--name -n

Nom du service.

Paramètres facultatifs

--path

Chemin d’accès à un dossier de projet. Valeur par défaut : répertoire actif.

--resource-group -g

Groupe de ressources correspondant à l’espace de travail fourni.

--set-key -s

Fournissez la valeur d’authentification pour la clé spécifiée.

--subscription-id

Spécifie l’ID d’abonnement.

--workspace-name -w

Nom de l’espace de travail contenant le service à afficher.

-v

Indicateur de détail.

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

Exécutez un service dans l’espace de travail.

az ml service run --name
                  [--input-data]
                  [--path]
                  [--resource-group]
                  [--subscription-id]
                  [--workspace-name]
                  [-v]

Paramètres obligatoires

--name -n

Nom du service à noter.

Paramètres facultatifs

--input-data -d

Données à utiliser pour appeler le service web.

--path

Chemin d’accès à un dossier de projet. Valeur par défaut : répertoire actif.

--resource-group -g

Groupe de ressources correspondant à l’espace de travail fourni.

--subscription-id

Spécifie l’ID d’abonnement.

--workspace-name -w

Nom de l’espace de travail contenant le service à exécuter.

-v

Indicateur de détail.

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

Afficher les détails d’un service dans l’espace de travail.

az ml service show --name
                   [--path]
                   [--resource-group]
                   [--subscription-id]
                   [--workspace-name]
                   [-v]

Paramètres obligatoires

--name -n

Nom du service web à afficher.

Paramètres facultatifs

--path

Chemin d’accès à un dossier de projet. Valeur par défaut : répertoire actif.

--resource-group -g

Groupe de ressources correspondant à l’espace de travail fourni.

--subscription-id

Spécifie l’ID d’abonnement.

--workspace-name -w

Nom de l’espace de travail contenant le service à afficher.

-v

Indicateur de détail.

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

Mettez à jour un service dans l’espace de travail.

az ml service update --name
                     [--add-property]
                     [--add-tag]
                     [--ae]
                     [--ai]
                     [--ar]
                     [--as]
                     [--at]
                     [--autoscale-max-replicas]
                     [--autoscale-min-replicas]
                     [--base-image]
                     [--base-image-registry]
                     [--cc]
                     [--ccl]
                     [--cf]
                     [--collect-model-data]
                     [--compute-target]
                     [--cuda-version]
                     [--dc]
                     [--description]
                     [--dn]
                     [--ds]
                     [--ed]
                     [--eg]
                     [--entry-script]
                     [--environment-name]
                     [--environment-version]
                     [--failure-threshold]
                     [--gb]
                     [--gbl]
                     [--gc]
                     [--ic]
                     [--id]
                     [--is-migration]
                     [--kp]
                     [--ks]
                     [--lo]
                     [--max-request-wait-time]
                     [--model]
                     [--model-metadata-file]
                     [--no-wait]
                     [--nr]
                     [--path]
                     [--period-seconds]
                     [--po]
                     [--remove-tag]
                     [--replica-max-concurrent-requests]
                     [--resource-group]
                     [--rt]
                     [--sc]
                     [--scoring-timeout-ms]
                     [--sd]
                     [--se]
                     [--sk]
                     [--sp]
                     [--st]
                     [--subscription-id]
                     [--timeout-seconds]
                     [--token-auth-enabled]
                     [--workspace-name]
                     [-v]

Paramètres obligatoires

--name -n

Nom du service à mettre à jour.

Paramètres facultatifs

--add-property

Propriété clé/valeur à ajouter (e.g. key=value). Plusieurs propriétés peuvent être spécifiées avec plusieurs options --add-property.

Valeur par défaut: []
--add-tag

Balise clé/valeur à ajouter (e.g. key=value). Plusieurs balises peuvent être spécifiées avec plusieurs options --add-tag.

Valeur par défaut: []
--ae --auth-enabled

Indique s’il est nécessaire ou non d’activer l’authentification par clé pour cet objet Webservice. Valeur par défaut False.

--ai --enable-app-insights

Indique s’il faut activer ou pas AppInsights pour ce service web. Valeur par défaut False.

--ar --autoscale-refresh-seconds

Fréquence à laquelle l’autoscaler doit tenter de mettre à l’échelle ce service web. La valeur par défaut est de 1.

--as --autoscale-enabled

Indique s’il est nécessaire ou non d’activer la mise à l’échelle automatique pour ce service web. La valeur par défaut est True si num_replicas a la valeur None.

--at --autoscale-target-utilization

Utilisation cible en pourcentage que l’autoscaler doit tenter de conserver pour ce service web. La valeur par défaut est 70.

--autoscale-max-replicas --ma

Nombre maximal de conteneurs à utiliser durant la mise à l’échelle automatique de ce service web. La valeur par défaut est 10.

--autoscale-min-replicas --mi

Nombre minimal de conteneurs à utiliser durant la mise à l’échelle automatique de ce service web. La valeur par défaut est de 1.

--base-image --bi

Image personnalisée à utiliser comme image de base. Si aucune image de base n’est proposée, l’image de base sera utilisée en fonction d’un paramètre d’exécution donné.

--base-image-registry --ir

Registre d’images contenant l’image de base.

--cc --cpu-cores

Nombre de cœurs de processeur à allouer pour ce service web. Il peut s’agir d’un nombre décimal. La valeur par défaut est 0.1.

--ccl --cpu-cores-limit

Nombre maximal de cœurs de processeur que ce service web est autorisé à utiliser. Il peut s’agir d’un nombre décimal.

--cf --conda-file

Chemin d’accès au fichier local contenant une définition de l’environnement conda à utiliser pour l’image.

--collect-model-data --md

Indique s’il faut activer la collecte des données de modèle ou pas pour ce service Web. Valeur par défaut False.

--compute-target

(Préversion) Spécifie la cible de calcul avec l’extension AzureML installée pour héberger le point de terminaison et le déploiement kubernetes en ligne migrés.

--cuda-version --cv

Version de CUDA à installer pour les images nécessitant une prise en charge GPU. L’image GPU doit être utilisée sur les services Microsoft Azure tels que Azure Container Instances, Capacité de calcul Azure Machine Learning, Machines virtuelles Azure et Azure Kubernetes Service. Les versions prises en charge sont les versions 9.0, 9.1 et 10.0. Si « enable_gpu » est défini, la valeur par défaut est « 9.1 ».

--dc --deploy-config-file

Chemin d’accès à un fichier JSON contenant des métadonnées de déploiement.

--description -d

Description du service.

--dn --dns-name-label

Nom dns de ce service Web.

--ds --extra-docker-file-steps

Chemin d’accès au fichier local contenant des étapes Docker supplémentaires à exécuter lors de la configuration de l’image.

--ed --environment-directory

Répertoire pour l’environnement Azure Machine Learning pour le déploiement. Il s’agit du même chemin d’accès de répertoire que celui fourni dans la commande « az ml environment scaffold ».

--eg --enable-gpu

Activer ou non la prise en charge GPU dans l’image. L’image GPU doit être utilisée sur les services Microsoft Azure tels que Azure Container Instances, Capacité de calcul Azure Machine Learning, Machines virtuelles Azure et Azure Kubernetes Service. Valeur par défaut False.

--entry-script --es

Chemin d’accès au fichier local qui contient le code à exécuter pour le service (chemin relatif de source_directory si un fichier est fourni).

--environment-name -e

Nom de l’environnement Azure Machine Learning pour le déploiement.

--environment-version --ev

Version d’un environnement Azure Machine Learning existant pour le déploiement.

--failure-threshold --ft

Lorsqu’un pod démarre et que la sonde liveness échoue, Kubernetes essaie des temps --failure-threshold avant de renoncer. La valeur par défaut est 3. La valeur minimale est 1.

--gb --memory-gb

Quantité de mémoire (en Go) à allouer pour ce Webservice. Il peut s’agir d’un nombre décimal.

--gbl --memory-gb-limit

Quantité maximale de mémoire (en Go) que ce service web est autorisé à utiliser. Il peut s’agir d’un nombre décimal.

--gc --gpu-cores

Nombre de cœurs gpu à allouer pour ce service Web. 1 constitue la valeur par défaut.

--ic --inference-config-file

Chemin d’accès à un fichier JSON ou YAML contenant une configuration d’inférence.

--id --initial-delay-seconds

Nombre de secondes après le démarrage du conteneur avant le lancement des probes liveness. La valeur par défaut est 310.

--is-migration

(Préversion) Indique s’il faut migrer ou non le service web AKS vers le point de terminaison et le déploiement en ligne Kubernetes. Valeur par défaut False.

--kp --primary-key

Clé d’authentification primaire à utiliser pour ce Webservice.

--ks --secondary-key

Clé d’authentification secondaire à utiliser pour ce service web.

--lo --location

Région Azure dans laquelle déployer ce service web. Si elle n’est pas spécifiée, l’emplacement de l’espace de travail sera utilisé. Vous trouverez plus d’informations sur les régions disponibles ici : ; https://azure.microsoft.com/en-us/global-infrastructure/services/?regions=all& products=container-instances.

--max-request-wait-time --mr

Durée maximale pendant laquelle une demande reste en file d’attente (en millisecondes) avant de retourner une erreur 503. La valeur par défaut est 500.

--model -m

ID du modèle à déployer. Plusieurs modèles peuvent être spécifiés avec des arguments -m supplémentaires. Les modèles doivent d’abord être inscrits.

Valeur par défaut: []
--model-metadata-file -f

Chemin d’accès à un fichier JSON contenant des métadonnées d’inscription de modèle. Plusieurs modèles peuvent être fournis à l’aide de plusieurs paramètres -f.

Valeur par défaut: []
--no-wait

Indicateur pour ne pas attendre les appels asynchrones.

--nr --num-replicas

Nombre de conteneurs à allouer pour ce service web. Aucune valeur par défaut. Si ce paramètre n’est pas défini, la mise à l’échelle automatique est activée par défaut.

--path

Chemin d’accès à un dossier de projet. Valeur par défaut : répertoire actif.

--period-seconds --ps

Fréquence (en secondes) d’exécution de probe liveness. La valeur par défaut est 10 secondes. La valeur minimale est 1.

--po --port

Port local sur lequel exposer le point de terminaison HTTP du service.

--remove-tag

Clé de balise à supprimer. Plusieurs balises peuvent être spécifiées avec plusieurs options --remove-tag.

Valeur par défaut: []
--replica-max-concurrent-requests --rm

Nombre maximal de requêtes simultanées par nœud à autoriser pour ce service Web. La valeur par défaut est de 1.

--resource-group -g

Groupe de ressources correspondant à l’espace de travail fourni.

--rt --runtime

Runtime à utiliser pour l’image. Les runtimes pris en charge actuels sont « spark-py » et « python » spark-py|python|python-slim.

--sc --ssl-cname

cname si SSL est activé. Applicable uniquement lors de la mise à jour d’un service ACI.

--scoring-timeout-ms --tm

Délai d’expiration à appliquer pour le scoring des appels à ce service web. La valeur par défaut est 60 000.

--sd --source-directory

Chemin vers des dossiers contenant tous les fichiers pour créer l’image.

--se --ssl-enabled

Indique s’il faut activer ou pas SSL pour ce service web. Valeur par défaut False.

--sk --ssl-key-pem-file

Fichier de clé nécessaire si SSL est activé.

--sp --ssl-cert-pem-file

Fichier cert nécessaire si SSL est activé.

--st --success-threshold

Nombre minimal de réussites consécutives pour que la probe liveness soit considérée comme réussie après avoir échoué. La valeur par défaut est de 1. La valeur minimale est 1.

--subscription-id

Spécifie l’ID d’abonnement.

--timeout-seconds --ts

Délai d’expiration en secondes de la probe liveness. La valeur par défaut est de 2 secondes. La valeur minimale est 1.

--token-auth-enabled

Indique s’il faut activer ou non l’authentification de jeton pour ce service Web. Disponible uniquement pour les services web AKS. Valeur par défaut False.

--workspace-name -w

Nom de l’espace de travail contenant le service à mettre à jour.

-v

Indicateur de détail.

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.