Partager via

az ml batch-endpoint

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

Gérer les points de terminaison de lot Azure ML.

Les points de terminaison Azure ML fournissent une interface simple pour créer et gérer des déploiements de modèles. Chaque point de terminaison peut avoir un ou plusieurs déploiements. Les points de terminaison batch sont utilisés pour le scoring par lots hors connexion.

Commandes

Nom Description Type Statut
az ml batch-endpoint create

Créez un point de terminaison.

 Extension GA
az ml batch-endpoint delete

Supprimez un point de terminaison.

 Extension GA
az ml batch-endpoint invoke

Appelez un point de terminaison.

 Extension GA
az ml batch-endpoint list

Répertorier les points de terminaison dans un espace de travail.

 Extension GA
az ml batch-endpoint list-jobs

Répertoriez les travaux de scoring par lots pour un point de terminaison de traitement par lots.

 Extension GA
az ml batch-endpoint show

Afficher les détails d’un point de terminaison.

 Extension GA
az ml batch-endpoint update

Mettez à jour un point de terminaison.

 Extension GA

az ml batch-endpoint create

Créez un point de terminaison.

Pour créer un point de terminaison, fournissez un fichier YAML avec une configuration de point de terminaison de lot. Si le point de terminaison existe déjà, il est surécrit avec les nouveaux paramètres.

az ml batch-endpoint create --resource-group
                            --workspace-name
                            [--file]
                            [--name]
                            [--no-wait]
                            [--set]

Exemples

Créer un point de terminaison à partir d’un fichier de spécification YAML

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

Créer un point de terminaison avec un nom

az ml batch-endpoint create --name endpointname --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

--file -f

Chemin local du fichier YAML contenant la spécification du point de terminaison batch Azure ML. Vous trouverez la documentation de référence YAML pour le point de terminaison batch à l’adresse suivante : https://aka.ms/ml-cli-v2-endpoint-batch-yaml-reference.

--name -n

Nom du point de terminaison de lot.

--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
--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 batch-endpoint delete

Supprimez un point de terminaison.

az ml batch-endpoint delete --name
                            --resource-group
                            --workspace-name
                            [--no-wait]
                            [--yes]

Exemples

Supprimer un point de terminaison de lot, y compris tous ses déploiements

az ml batch-endpoint delete --name my-batch-endpoint --resource-group my-resource-group --workspace-name my-workspace

Paramètres obligatoires

--name -n

Nom du point de terminaison de lot.

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

--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
--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 batch-endpoint invoke

Appelez un point de terminaison.

Vous pouvez démarrer l’inférence par lots en appelant le point de terminaison avec certaines données. Pour les points de terminaison de traitement par lots, l’appel déclenche un travail de scoring de lots asynchrone.

az ml batch-endpoint invoke --name
                            --resource-group
                            --workspace-name
                            [--deployment-name]
                            [--experiment-name]
                            [--file]
                            [--input]
                            [--input-type]
                            [--inputs]
                            [--instance-count]
                            [--job-name]
                            [--mini-batch-size]
                            [--output-path]
                            [--outputs]
                            [--set]

Exemples

Appeler un point de terminaison de lot avec des données d’entrée à partir d’une ressource de données Azure ML inscrite et remplacer le paramètre de déploiement par défaut pour mini_batch_size

az ml batch-endpoint invoke --name my-batch-endpoint --input azureml:my-dataset:1 --mini-batch-size 64 --resource-group my-resource-group --workspace-name my-workspace

Appeler un point de terminaison de lot avec un fichier d’entrée à partir d’un URI public

az ml batch-endpoint invoke --name my-batch-endpoint --input-type uri_file --input https://pipelinedata.blob.core.windows.net/sampledata/mnist/0.png --resource-group my-resource-group --workspace-name my-workspace

Appeler un point de terminaison de lot avec un fichier d’entrée à partir d’un magasin de données inscrit

az ml batch-endpoint invoke --name my-batch-endpoint --input-type uri_file --input azureml://datastores/workspaceblobstore/paths/{path_to_data}/mnist/0.png --resource-group my-resource-group --workspace-name my-workspace

Appeler un point de terminaison de lot avec un dossier d’entrée à partir d’un URI public

az ml batch-endpoint invoke --name my-batch-endpoint --input-type uri_folder --input https://pipelinedata.blob.core.windows.net/sampledata/mnist --resource-group my-resource-group --workspace-name my-workspace

Appeler un point de terminaison batch avec un dossier d’entrée à partir d’un magasin de données inscrit

az ml batch-endpoint invoke --name my-batch-endpoint --input-type uri_folder --input azureml://datastores/workspaceblobstore/paths/{path_to_data}/mnist --resource-group my-resource-group --workspace-name my-workspace

Appeler un point de terminaison de lot avec des fichiers dans un dossier local

az ml batch-endpoint invoke --name my-batch-endpoint --input ./mnist_folder --resource-group my-resource-group --workspace-name my-workspace

Appeler un point de terminaison de lot avec un dossier local en tant que chemin d’accès d’entrée et de sortie et remplacer certains paramètres de déploiement par lots lors de l’appel du point de terminaison

az ml batch-endpoint invoke --name my-batch-endpoint --input ./mnist_folder --instance-count 2 --mini-batch-size 5 --output-path azureml://datastores/workspaceblobstore/paths/tests/output --resource-group my-resource-group --workspace-name my-workspace

Paramètres obligatoires

--name -n

Nom du point de terminaison de lot.

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

--deployment-name -d

Nom du déploiement à cibler.

--experiment-name

Nom de l’expérience pour le déploiement de composants de pipeline.

--file -f

Nom du fichier utilisé pour l’appel par lots.

--input

Référence aux données d’entrée à utiliser pour l’inférence par lots. Il peut s’agir d’un chemin sur le magasin de données, l’URI public, une ressource de données inscrite ou un chemin d’accès de dossier local.

--input-type

Type de l’entrée, en spécifiant s’il s’agit d’un fichier ou d’un dossier. Utilisez-le lorsque vous utilisez un chemin d’accès sur le magasin de données ou l’URI public. Valeurs prises en charge : uri_folder, uri_file.

--inputs

Dictionnaire des entrées des travaux d’appel.

--instance-count -c

Nombre d’instances sur laquelle la prédiction s’exécute.

--job-name

Nom du travail pour l’appel par lots.

--mini-batch-size -m

Taille de chaque mini-lot dans lequel les données d’entrée seront fractionnées pour la prédiction.

--output-path

Chemin d’accès sur le magasin de données dans lequel les fichiers de sortie seront chargés.

--outputs

Dictionnaire pour spécifier où stocker les résultats.

--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 batch-endpoint list

Répertorier les points de terminaison dans un espace de travail.

az ml batch-endpoint list --resource-group
                          --workspace-name

Exemples

Répertorier tous les points de terminaison de lot dans un espace de travail

az ml batch-endpoint list --resource-group my-resource-group --workspace-name my-workspace

Répertorier tous les points de terminaison de lot dans un espace de travail

az ml batch-endpoint list  --resource-group my-resource-group --workspace-name my-workspace

Répertoriez tous les points de terminaison de lot 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 batch-endpoint 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 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 batch-endpoint list-jobs

Répertoriez les travaux de scoring par lots pour un point de terminaison de traitement par lots.

az ml batch-endpoint list-jobs --name
                               --resource-group
                               --workspace-name

Exemples

Répertorier tous les travaux de scoring par lots pour un point de terminaison

az ml batch-endpoint list-jobs --name my-batch-endpoint --resource-group my-resource-group --workspace-name my-workspace

Paramètres obligatoires

--name -n

Nom du point de terminaison de lot.

--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 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 batch-endpoint show

Afficher les détails d’un point de terminaison.

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

Exemples

Afficher les détails d’un point de terminaison batch

az ml batch-endpoint show --name my-batch-endpoint  --resource-group my-resource-group --workspace-name my-workspace

Affichez l’état d’approvisionnement d’un point de terminaison à l’aide de l’argument --query pour exécuter une requête JMESPath sur les résultats des commandes.

az ml batch-endpoint show -n my-endpoint --query "{Name:name,State:provisioning_state}"  --output table --resource-group my-resource-group --workspace-name my-workspace

Paramètres obligatoires

--name -n

Nom du point de terminaison de lot.

--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 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 batch-endpoint update

Mettez à jour un point de terminaison.

Les propriétés « description », « tags » et « defaults » d’un point de terminaison peuvent être mises à jour. De plus, de nouveaux déploiements peuvent être ajoutés à un point de terminaison, et les déploiements existants peuvent être mis à jour.

az ml batch-endpoint update --resource-group
                            --workspace-name
                            [--add]
                            [--defaults]
                            [--file]
                            [--force-string]
                            [--name]
                            [--no-wait]
                            [--remove]
                            [--set]

Exemples

Mettre à jour un point de terminaison à partir d’un fichier de spécification YAML

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

Ajouter un nouveau déploiement à un point de terminaison existant

az ml batch-endpoint update --name my-batch-endpoint  --set defaults.deployment_name=depname  --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

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

Mettez à jour deployment_name à l’intérieur des paramètres par défaut pour l’appel de point de terminaison.

--file -f

Chemin local du fichier YAML contenant la spécification du point de terminaison batch Azure ML. Vous trouverez la documentation de référence YAML pour le point de terminaison batch à l’adresse suivante : https://aka.ms/ml-cli-v2-endpoint-batch-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
--name -n

Nom du point de terminaison de lot.

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