Compartilhar via

az ml run

  • Referência

Observação

Essa referência faz parte da extensão azure-cli-ml para a CLI do Azure (versão 2.0.28 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az ml run . Saiba mais sobre extensões.

Comandos para envio, atualização e monitoramento de execuções.

Comandos

Nome Description Tipo Status
az ml run cancel

Cancelar execução.

 Extensão GA
az ml run download-logs

Faça o download de arquivos de log.

 Extensão GA
az ml run list

A lista é executada.

 Extensão GA
az ml run monitor-logs

Monitore os logs de uma execução existente.

 Extensão GA
az ml run monitor-tensorboard

Monitore uma execução existente usando tensorboard.

 Extensão GA
az ml run show

Mostrar correr.

 Extensão GA
az ml run submit-hyperdrive

Envie uma varredura de hiperparâmetro usando run config.

 Extensão GA
az ml run submit-pipeline

Envie um pipeline para execução, a partir de um ID de pipeline publicado ou arquivo YAML de pipeline.

 Extensão GA
az ml run submit-script

Envie um script para execução.

 Extensão GA
az ml run update

Atualize a execução adicionando tags.

 Extensão GA

az ml run cancel

Cancelar execução.

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

Parâmetros Exigidos

--run -r

O runId de uma execução de experimento.

Parâmetros Opcionais

--experiment-name -e

Nome do experimento.

--output-metadata-file -t

Forneça um local de arquivo de saída opcional para a saída de objetos estruturados.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Valor padrão: .
--resource-group -g

Nome do grupo de recursos.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az ml run download-logs

Faça o download de arquivos de log.

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

Parâmetros Exigidos

--output-dir -d

Diretório de saída para o qual baixar arquivos de log.

--run -r

O runId de uma execução de experimento.

Parâmetros Opcionais

--experiment-name -e

Nome do experimento.

--output-metadata-file -t

Forneça um local de arquivo de saída opcional para a saída de objetos estruturados.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Valor padrão: .
--resource-group -g

Nome do grupo de recursos.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az ml run list

A lista é executada.

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]

Parâmetros Opcionais

--compute-target-name

O nome do destino da computação.

--experiment-name -e

Nome do experimento.

--last

Busque os elementos N mais recentes.

Valor padrão: 10
--minimal

Sinalizador para fornecer propriedades mínimas para a saída de execução.

Valor padrão: False
--output-metadata-file -t

Forneça um local de arquivo de saída opcional para a saída de objetos estruturados.

--parent-run-id

ID de execução pai.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Valor padrão: .
--pipeline-run-id

ID de execução do pipeline.

--resource-group -g

Nome do grupo de recursos.

--status

Status da execução.

Valores aceitos: Completed, Failed, Finalizing, Preparing, Provisioning, Queued, Running, Starting
--subscription-id

Especifica a ID da assinatura.

--tags

Tags para uma execução com sintaxe 'key[=value]'.

--workspace-name -w

Nome do espaço de trabalho.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az ml run monitor-logs

Monitore os logs de uma execução existente.

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

Parâmetros Exigidos

--run -r

O runId de uma execução de experimento.

Parâmetros Opcionais

--experiment-name -e

Nome do experimento.

--output-metadata-file -t

Forneça um local de arquivo de saída opcional para a saída de objetos estruturados.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Valor padrão: .
--resource-group -g

Nome do grupo de recursos.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az ml run monitor-tensorboard

Monitore uma execução existente usando tensorboard.

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

Parâmetros Exigidos

--run -r

O runId de uma execução de experimento.

Parâmetros Opcionais

--experiment-name -e

Nome do experimento.

--local-directory

Diretório local para preparar arquivos tensorboard que estão sendo monitorados.

--output-metadata-file -t

Forneça um local de arquivo de saída opcional para a saída de objetos estruturados.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Valor padrão: .
--resource-group -g

Nome do grupo de recursos.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az ml run show

Mostrar correr.

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

Parâmetros Exigidos

--run -r

O runId de uma execução de experimento.

Parâmetros Opcionais

--experiment-name -e

Nome do experimento.

--output-metadata-file -t

Forneça um local de arquivo de saída opcional para a saída de objetos estruturados.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Valor padrão: .
--resource-group -g

Nome do grupo de recursos.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az ml run submit-hyperdrive

Envie uma varredura de hiperparâmetro usando run config.

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

Parâmetros Exigidos

--hyperdrive-configuration-name

O nome completo do arquivo de configuração do hyperdrive. O arquivo deve estar em uma subpasta do diretório especificado pelo parâmetro path.

Parâmetros Opcionais

--async

Desative o streaming de saída.

Valor padrão: False
--conda-dependencies -d

Substitua o arquivo de dependências padrão do Conda.

--ct --target

O nome do destino de computação a ser usado para a execução.

--experiment-name -e

Nome do experimento.

--output-metadata-file -t

Forneça um local de arquivo de saída opcional para a saída de objetos estruturados.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Valor padrão: .
--resource-group -g

Nome do grupo de recursos.

--run-configuration-name -c

Nome (sem extensão) de um arquivo de configuração de execução. O arquivo deve estar em uma subpasta do diretório especificado pelo parâmetro path.

--source-directory

Um diretório local que contém arquivos de código-fonte. O padrão é o caminho se o diretório de origem não for fornecido.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho.

<USER_SCRIPT_AND_ARGUMENTS>

A execução envia argumentos, como nome do script e argumentos de script.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az ml run submit-pipeline

Envie um pipeline para execução, a partir de um ID de pipeline publicado ou arquivo 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]

Parâmetros Opcionais

--datapaths -d

Lista separada por vírgulas de pares name=datastore/path para atribuições de parâmetro datapath.

--experiment-name -n

Nome do experimento para envio de execução. Se não for especificado, use o nome do pipeline.

--output-metadata-file -t

Forneça um local de arquivo de saída opcional para a saída de objetos estruturados.

--output_file -f

Arquivo para gravar saída no formato JSON.

--parameters -p

Lista separada por vírgulas de pares nome=valor para atribuições de parâmetros de pipeline.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Valor padrão: .
--pipeline-id -i

ID de um pipeline a ser enviado (guid).

--pipeline-yaml -y

YAML que define um pipeline.

--resource-group -g

Nome do grupo de recursos.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az ml run submit-script

Envie um script para execução.

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

Parâmetros Opcionais

--async

Desative o streaming de saída.

Valor padrão: False
--conda-dependencies -d

Substitua o arquivo de dependências padrão do Conda.

--ct --target

O nome do destino de computação a ser usado para a execução.

--experiment-name -e

Nome do experimento.

--output-metadata-file -t

Forneça um local de arquivo de saída opcional para a saída de objetos estruturados.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Valor padrão: .
--resource-group -g

Nome do grupo de recursos.

--run-configuration-name -c

Nome (sem extensão) de um arquivo de configuração de execução. O arquivo deve estar em uma subpasta do diretório especificado pelo parâmetro path.

--source-directory

Um diretório local que contém arquivos de código-fonte. O padrão é o caminho se o diretório de origem não for fornecido.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho.

<USER_SCRIPT_AND_ARGUMENTS>

A execução envia argumentos, como nome do script e argumentos de script.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az ml run update

Atualize a execução adicionando tags.

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

Parâmetros Exigidos

--run -r

O runId de uma execução de experimento.

Parâmetros Opcionais

--add-tag

Marque a entitiy com a sintaxe 'key[=value]'.

--experiment-name -e

Nome do experimento.

--output-metadata-file -t

Forneça um local de arquivo de saída opcional para a saída de objetos estruturados.

--path

Caminho para um diretório raiz para executar arquivos de configuração.

Valor padrão: .
--resource-group -g

Nome do grupo de recursos.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.