az ml batch-endpoint

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 batch-endpoint. Apprenez-en davantage 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	État
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 à l’aide de 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

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 point de terminaison batch Azure ML. Vous trouverez les documents de référence YAML pour le point de terminaison batch à l’adresse : 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.

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.

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 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 à l’aide de 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

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

--yes -y

N’invitez pas à confirmer.

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 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 à l’aide de 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

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.

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

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 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 à l’aide de 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 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 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 à l’aide de 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 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 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 à l’aide de 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 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 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 à l’aide de 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

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

--defaults

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

--file -f

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

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

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

Commentaires

Cette page a-t-elle été utile ?

Partager via

az ml batch-endpoint

Commandes

az ml batch-endpoint create

Exemples

Paramètres obligatoires

Paramètres facultatifs

az ml batch-endpoint delete

Exemples

Paramètres obligatoires

Paramètres facultatifs

az ml batch-endpoint invoke

Exemples

Paramètres obligatoires

Paramètres facultatifs

az ml batch-endpoint list

Exemples

Paramètres obligatoires

az ml batch-endpoint list-jobs

Exemples

Paramètres obligatoires

az ml batch-endpoint show

Exemples

Paramètres obligatoires

az ml batch-endpoint update

Exemples

Paramètres obligatoires

Paramètres facultatifs

Commentaires