az ml run

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

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

Commandes

Nom Description Type Statut
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

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

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

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

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

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

valeur par défaut: 10
--minimal

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

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.

valeur par défaut: .
--pipeline-run-id

ID d’exécution du pipeline.

--resource-group -g

Nom du groupe de ressources.

--status

Statut de l’exécution

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

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

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

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

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

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

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 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 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]
                            [--experiment-name]
                            [--output-metadata-file]
                            [--path]
                            [--resource-group]
                            [--run-configuration-name]
                            [--source-directory]
                            [--subscription-id]
                            [--workspace-name]
                            [<USER_SCRIPT_AND_ARGUMENTS>]

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

--async

Désactivez la diffusion en continu de sortie.

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.

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.

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

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

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

Envoyez un script pour l’exécution.

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

Paramètres facultatifs

--async

Désactivez la diffusion en continu de sortie.

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.

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.

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

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

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