Partager via

az ml run

Note

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 un az ml exécuter commande. Apprenez-en davantage sur les extensions.

Commandes pour l’envoi, la mise à jour et l’analyse des exécutions.

Commandes

Nom Description Type État
az ml run cancel

Annuler l’exécution.

 Extension GA
az ml run download-logs

Téléchargez les fichiers journaux.

 Extension GA
az ml run list

Lister les exécutions.

 Extension GA
az ml run monitor-logs

Surveillez les journaux d’activité d’une exécution existante.

 Extension GA
az ml run monitor-tensorboard

Surveillez une exécution existante à l’aide de tensorboard.

 Extension GA
az ml run show

Afficher l’exécution.

 Extension GA
az ml run submit-hyperdrive

Envoyez un balayage de paramètre Hyper à l’aide de la configuration d’exécution.

 Extension GA
az ml run submit-pipeline

Envoyez un pipeline pour l’exécution, à partir d’un ID de pipeline publié ou d’un fichier YAML de pipeline.

 Extension GA
az ml run submit-script

Envoyez un script pour l’exécution.

 Extension GA
az ml run update

Mettez à jour l’exécution en ajoutant des balises.

 Extension GA

az ml run cancel

Annuler l’exécution.

az ml run cancel --run
                 [--experiment-name]
                 [--output-metadata-file]
                 [--path]
                 [--resource-group]
                 [--subscription-id]
                 [--workspace-name]

Paramètres obligatoires

--run -r

RunId d’une exécution d’expérience.

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.

--experiment-name -e

Nom de l’expérience.

--output-metadata-file -t

Fournissez un emplacement de fichier de sortie facultatif pour la sortie d’objet structuré.

--path

Chemin d’accès à un répertoire racine pour exécuter des fichiers de configuration.

Propriété Valeur
Valeur par défaut: .
--resource-group -g

Nom du groupe de ressources.

--subscription-id

Spécifie l’ID d’abonnement.

--workspace-name -w

Nom de 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 run download-logs

Téléchargez les fichiers journaux.

az ml run download-logs --output-dir
                        --run
                        [--experiment-name]
                        [--output-metadata-file]
                        [--path]
                        [--resource-group]
                        [--subscription-id]
                        [--workspace-name]

Paramètres obligatoires

--output-dir -d

Répertoire de sortie dans lequel télécharger les fichiers journaux.

--run -r

RunId d’une exécution d’expérience.

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.

--experiment-name -e

Nom de l’expérience.

--output-metadata-file -t

Fournissez un emplacement de fichier de sortie facultatif pour la sortie d’objet structuré.

--path

Chemin d’accès à un répertoire racine pour exécuter des fichiers de configuration.

Propriété Valeur
Valeur par défaut: .
--resource-group -g

Nom du groupe de ressources.

--subscription-id

Spécifie l’ID d’abonnement.

--workspace-name -w

Nom de 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 run list

Lister les exécutions.

az ml run list [--compute-target-name]
               [--experiment-name]
               [--last]
               [--minimal]
               [--output-metadata-file]
               [--parent-run-id]
               [--path]
               [--pipeline-run-id]
               [--resource-group]
               [--status {Completed, Failed, Finalizing, Preparing, Provisioning, Queued, Running, Starting}]
               [--subscription-id]
               [--tags]
               [--workspace-name]

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.

--compute-target-name

Nom de la cible de calcul.

--experiment-name -e

Nom de l’expérience.

--last

Récupérez les derniers éléments N.

Propriété Valeur
Valeur par défaut: 10
--minimal

Indicateur pour fournir des propriétés minimales pour la sortie d’exécution.

Propriété Valeur
Valeur par défaut: False
--output-metadata-file -t

Fournissez un emplacement de fichier de sortie facultatif pour la sortie d’objet structuré.

--parent-run-id

ID d’exécution parent.

--path

Chemin d’accès à un répertoire racine pour exécuter des fichiers de configuration.

Propriété Valeur
Valeur par défaut: .
--pipeline-run-id

ID d’exécution du pipeline.

--resource-group -g

Nom du groupe de ressources.

--status

État de l’exécution.

Propriété Valeur
Valeurs acceptées: Completed, Failed, Finalizing, Preparing, Provisioning, Queued, Running, Starting
--subscription-id

Spécifie l’ID d’abonnement.

--tags

Balises pour une exécution avec la syntaxe « key[=value] ».

--workspace-name -w

Nom de 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 run monitor-logs

Surveillez les journaux d’activité d’une exécution existante.

az ml run monitor-logs --run
                       [--experiment-name]
                       [--output-metadata-file]
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]

Paramètres obligatoires

--run -r

RunId d’une exécution d’expérience.

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.

--experiment-name -e

Nom de l’expérience.

--output-metadata-file -t

Fournissez un emplacement de fichier de sortie facultatif pour la sortie d’objet structuré.

--path

Chemin d’accès à un répertoire racine pour exécuter des fichiers de configuration.

Propriété Valeur
Valeur par défaut: .
--resource-group -g

Nom du groupe de ressources.

--subscription-id

Spécifie l’ID d’abonnement.

--workspace-name -w

Nom de 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 run monitor-tensorboard

Surveillez une exécution existante à l’aide de tensorboard.

az ml run monitor-tensorboard --run
                              [--experiment-name]
                              [--local-directory]
                              [--output-metadata-file]
                              [--path]
                              [--resource-group]
                              [--subscription-id]
                              [--workspace-name]

Paramètres obligatoires

--run -r

RunId d’une exécution d’expérience.

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.

--experiment-name -e

Nom de l’expérience.

--local-directory

Répertoire local pour mettre en scène les fichiers tensorboard surveillés.

--output-metadata-file -t

Fournissez un emplacement de fichier de sortie facultatif pour la sortie d’objet structuré.

--path

Chemin d’accès à un répertoire racine pour exécuter des fichiers de configuration.

Propriété Valeur
Valeur par défaut: .
--resource-group -g

Nom du groupe de ressources.

--subscription-id

Spécifie l’ID d’abonnement.

--workspace-name -w

Nom de 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 run show

Afficher l’exécution.

az ml run show --run
               [--experiment-name]
               [--output-metadata-file]
               [--path]
               [--resource-group]
               [--subscription-id]
               [--workspace-name]

Paramètres obligatoires

--run -r

RunId d’une exécution d’expérience.

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.

--experiment-name -e

Nom de l’expérience.

--output-metadata-file -t

Fournissez un emplacement de fichier de sortie facultatif pour la sortie d’objet structuré.

--path

Chemin d’accès à un répertoire racine pour exécuter des fichiers de configuration.

Propriété Valeur
Valeur par défaut: .
--resource-group -g

Nom du groupe de ressources.

--subscription-id

Spécifie l’ID d’abonnement.

--workspace-name -w

Nom de 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 run submit-hyperdrive

Envoyez un balayage de paramètre Hyper à l’aide de la configuration d’exécution.

az ml run submit-hyperdrive --hyperdrive-configuration-name
                            [--async]
                            [--conda-dependencies]
                            [--ct --target]
                            [--experiment-name]
                            [--output-metadata-file]
                            [--path]
                            [--resource-group]
                            [--run-configuration-name]
                            [--source-directory]
                            [--subscription-id]
                            [--workspace-name]
                            []

Paramètres obligatoires

--hyperdrive-configuration-name

Nom complet du fichier de configuration hyperdrive. Le fichier doit se trouver dans un sous-dossier du répertoire spécifié par le paramètre de chemin d’accès.

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.

--async

Désactivez la diffusion en continu de sortie.

Propriété Valeur
Valeur par défaut: False
--conda-dependencies -d

Remplacez le fichier de dépendances Conda par défaut.

--ct --target

Nom de la cible de calcul à utiliser pour l’exécution.

--experiment-name -e

Nom de l’expérience.

--output-metadata-file -t

Fournissez un emplacement de fichier de sortie facultatif pour la sortie d’objet structuré.

--path

Chemin d’accès à un répertoire racine pour exécuter des fichiers de configuration.

Propriété Valeur
Valeur par défaut: .
--resource-group -g

Nom du groupe de ressources.

--run-configuration-name -c

Nom (sans extension) d’un fichier de configuration d’exécution. Le fichier doit se trouver dans un sous-dossier du répertoire spécifié par le paramètre de chemin d’accès.

--source-directory

Répertoire local contenant des fichiers de code source. Indique par défaut le chemin d’accès si le répertoire source n’est pas fourni.

--subscription-id

Spécifie l’ID d’abonnement.

--workspace-name -w

Nom de l’espace de travail.

<USER_SCRIPT_AND_ARGUMENTS>

Les arguments d’envoi d’exécution, tels que le nom du script et les arguments de script.

Propriété Valeur
Groupe de paramètres: Positional
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 run submit-pipeline

Envoyez un pipeline pour l’exécution, à partir d’un ID de pipeline publié ou d’un fichier YAML de pipeline.

az ml run submit-pipeline [--datapaths]
                          [--experiment-name]
                          [--output-metadata-file]
                          [--output_file]
                          [--parameters]
                          [--path]
                          [--pipeline-id]
                          [--pipeline-yaml]
                          [--resource-group]
                          [--subscription-id]
                          [--workspace-name]

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.

--datapaths -d

Liste séparée par des virgules des paires name=datastore/path pour les affectations de paramètres datapath.

--experiment-name -n

Nom de l’expérience pour la soumission d’exécution. Si ce n’est pas spécifié, utilisez le nom du pipeline.

--output-metadata-file -t

Fournissez un emplacement de fichier de sortie facultatif pour la sortie d’objet structuré.

--output_file -f

Fichier à écrire en sortie au format JSON.

--parameters -p

Liste séparée par des virgules de paires name=value pour les affectations de paramètres de pipeline.

--path

Chemin d’accès à un répertoire racine pour exécuter des fichiers de configuration.

Propriété Valeur
Valeur par défaut: .
--pipeline-id -i

ID d’un pipeline à envoyer (guid).

--pipeline-yaml -y

Fichier YAML qui définit un pipeline.

--resource-group -g

Nom du groupe de ressources.

--subscription-id

Spécifie l’ID d’abonnement.

--workspace-name -w

Nom de 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 run submit-script

Envoyez un script pour l’exécution.

az ml run submit-script [--async]
                        [--conda-dependencies]
                        [--ct --target]
                        [--experiment-name]
                        [--output-metadata-file]
                        [--path]
                        [--resource-group]
                        [--run-configuration-name]
                        [--source-directory]
                        [--subscription-id]
                        [--workspace-name]
                        []

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.

--async

Désactivez la diffusion en continu de sortie.

Propriété Valeur
Valeur par défaut: False
--conda-dependencies -d

Remplacez le fichier de dépendances Conda par défaut.

--ct --target

Nom de la cible de calcul à utiliser pour l’exécution.

--experiment-name -e

Nom de l’expérience.

--output-metadata-file -t

Fournissez un emplacement de fichier de sortie facultatif pour la sortie d’objet structuré.

--path

Chemin d’accès à un répertoire racine pour exécuter des fichiers de configuration.

Propriété Valeur
Valeur par défaut: .
--resource-group -g

Nom du groupe de ressources.

--run-configuration-name -c

Nom (sans extension) d’un fichier de configuration d’exécution. Le fichier doit se trouver dans un sous-dossier du répertoire spécifié par le paramètre de chemin d’accès.

--source-directory

Répertoire local contenant des fichiers de code source. Indique par défaut le chemin d’accès si le répertoire source n’est pas fourni.

--subscription-id

Spécifie l’ID d’abonnement.

--workspace-name -w

Nom de l’espace de travail.

<USER_SCRIPT_AND_ARGUMENTS>

Les arguments d’envoi d’exécution, tels que le nom du script et les arguments de script.

Propriété Valeur
Groupe de paramètres: Positional
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 run update

Mettez à jour l’exécution en ajoutant des balises.

az ml run update --run
                 [--add-tag]
                 [--experiment-name]
                 [--output-metadata-file]
                 [--path]
                 [--resource-group]
                 [--subscription-id]
                 [--workspace-name]

Paramètres obligatoires

--run -r

RunId d’une exécution d’expérience.

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

Étiquetez l’entitiy avec la syntaxe 'key[=value]'.

--experiment-name -e

Nom de l’expérience.

--output-metadata-file -t

Fournissez un emplacement de fichier de sortie facultatif pour la sortie d’objet structuré.

--path

Chemin d’accès à un répertoire racine pour exécuter des fichiers de configuration.

Propriété Valeur
Valeur par défaut: .
--resource-group -g

Nom du groupe de ressources.

--subscription-id

Spécifie l’ID d’abonnement.

--workspace-name -w

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