Compartir a través de

az ml run

  • Referencia

Nota:

Esta referencia forma parte de la extensión azure-cli-ml para la CLI de Azure (versión 2.0.28 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az ml run . Obtenga más información sobre las extensiones.

Comandos para enviar, actualizar y supervisar ejecuciones.

Comandos

Nombre Description Tipo Estado
az ml run cancel

Cancelar ejecución.

 Extensión GA
az ml run download-logs

Descargar los archivos de registro.

 Extensión GA
az ml run list

Enumera las ejecuciones.

 Extensión GA
az ml run monitor-logs

Supervise los registros de una ejecución existente.

 Extensión GA
az ml run monitor-tensorboard

Supervise una ejecución existente mediante tensorboard.

 Extensión GA
az ml run show

Mostrar ejecución.

 Extensión GA
az ml run submit-hyperdrive

Envíe un barrido de hiperparámetr mediante la configuración de ejecución.

 Extensión GA
az ml run submit-pipeline

Envíe una canalización para su ejecución, desde un identificador de canalización publicado o un archivo YAML de canalización.

 Extensión GA
az ml run submit-script

Envíe un script para su ejecución.

 Extensión GA
az ml run update

Actualice la ejecución agregando etiquetas.

 Extensión GA

az ml run cancel

Cancelar ejecución.

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

Parámetros requeridos

--run -r

RunId de una ejecución de experimento.

Parámetros opcionales

--experiment-name -e

Nombre del experimento.

--output-metadata-file -t

Proporcione una ubicación de archivo de salida opcional para la salida del objeto estructurado.

--path

Ruta de acceso a un directorio raíz para ejecutar archivos de configuración.

Valor predeterminado: .
--resource-group -g

Nombre del grupo de recursos.

--subscription-id

Especifica el identificador de suscripción.

--workspace-name -w

Nombre del área de trabajo.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az ml run download-logs

Descargar los archivos de registro.

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

Parámetros requeridos

--output-dir -d

Directorio de salida al que descargar los archivos de registro.

--run -r

RunId de una ejecución de experimento.

Parámetros opcionales

--experiment-name -e

Nombre del experimento.

--output-metadata-file -t

Proporcione una ubicación de archivo de salida opcional para la salida del objeto estructurado.

--path

Ruta de acceso a un directorio raíz para ejecutar archivos de configuración.

Valor predeterminado: .
--resource-group -g

Nombre del grupo de recursos.

--subscription-id

Especifica el identificador de suscripción.

--workspace-name -w

Nombre del área de trabajo.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az ml run list

Enumera las ejecuciones.

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 opcionales

--compute-target-name

Nombre del destino de proceso.

--experiment-name -e

Nombre del experimento.

--last

Captura los elementos N más recientes.

Valor predeterminado: 10
--minimal

Marca para proporcionar propiedades mínimas para la salida de ejecución.

Valor predeterminado: False
--output-metadata-file -t

Proporcione una ubicación de archivo de salida opcional para la salida del objeto estructurado.

--parent-run-id

Identificador de ejecución primario.

--path

Ruta de acceso a un directorio raíz para ejecutar archivos de configuración.

Valor predeterminado: .
--pipeline-run-id

Identificador de ejecución de canalización.

--resource-group -g

Nombre del grupo de recursos.

--status

El estado de la ejecución.

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

Especifica el identificador de suscripción.

--tags

Etiquetas para una ejecución con sintaxis 'key[=value]'.

--workspace-name -w

Nombre del área de trabajo.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az ml run monitor-logs

Supervise los registros de una ejecución existente.

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

Parámetros requeridos

--run -r

RunId de una ejecución de experimento.

Parámetros opcionales

--experiment-name -e

Nombre del experimento.

--output-metadata-file -t

Proporcione una ubicación de archivo de salida opcional para la salida del objeto estructurado.

--path

Ruta de acceso a un directorio raíz para ejecutar archivos de configuración.

Valor predeterminado: .
--resource-group -g

Nombre del grupo de recursos.

--subscription-id

Especifica el identificador de suscripción.

--workspace-name -w

Nombre del área de trabajo.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az ml run monitor-tensorboard

Supervise una ejecución existente mediante tensorboard.

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

Parámetros requeridos

--run -r

RunId de una ejecución de experimento.

Parámetros opcionales

--experiment-name -e

Nombre del experimento.

--local-directory

Directorio local para almacenar provisionalmente los archivos tensorboard que se supervisan.

--output-metadata-file -t

Proporcione una ubicación de archivo de salida opcional para la salida del objeto estructurado.

--path

Ruta de acceso a un directorio raíz para ejecutar archivos de configuración.

Valor predeterminado: .
--resource-group -g

Nombre del grupo de recursos.

--subscription-id

Especifica el identificador de suscripción.

--workspace-name -w

Nombre del área de trabajo.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az ml run show

Mostrar ejecución.

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

Parámetros requeridos

--run -r

RunId de una ejecución de experimento.

Parámetros opcionales

--experiment-name -e

Nombre del experimento.

--output-metadata-file -t

Proporcione una ubicación de archivo de salida opcional para la salida del objeto estructurado.

--path

Ruta de acceso a un directorio raíz para ejecutar archivos de configuración.

Valor predeterminado: .
--resource-group -g

Nombre del grupo de recursos.

--subscription-id

Especifica el identificador de suscripción.

--workspace-name -w

Nombre del área de trabajo.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az ml run submit-hyperdrive

Envíe un barrido de hiperparámetr mediante la configuración de ejecución.

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 requeridos

--hyperdrive-configuration-name

Nombre completo del archivo de configuración de hyperdrive. El archivo debe estar en una subcarpeta del directorio especificado por el parámetro path.

Parámetros opcionales

--async

Deshabilite el streaming de salida.

Valor predeterminado: False
--conda-dependencies -d

Invalide el archivo de dependencias de Conda predeterminado.

--ct --target

Nombre del destino de proceso que se va a usar para la ejecución.

--experiment-name -e

Nombre del experimento.

--output-metadata-file -t

Proporcione una ubicación de archivo de salida opcional para la salida del objeto estructurado.

--path

Ruta de acceso a un directorio raíz para ejecutar archivos de configuración.

Valor predeterminado: .
--resource-group -g

Nombre del grupo de recursos.

--run-configuration-name -c

Nombre (sin extensión) de un archivo de configuración de ejecución. El archivo debe estar en una subcarpeta del directorio especificado por el parámetro path.

--source-directory

Directorio local que contiene archivos de código fuente. El valor predeterminado es la ruta de acceso si no se proporciona el directorio de origen.

--subscription-id

Especifica el identificador de suscripción.

--workspace-name -w

Nombre del área de trabajo.

<USER_SCRIPT_AND_ARGUMENTS>

Los argumentos de envío de ejecución, como el nombre del script y los argumentos de script.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az ml run submit-pipeline

Envíe una canalización para su ejecución, desde un identificador de canalización publicado o un archivo YAML de canalización.

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 opcionales

--datapaths -d

Lista separada por comas de pares name=datastore/path para las asignaciones de parámetros datapath.

--experiment-name -n

Nombre del experimento para el envío de ejecución. Si no se especifica, use el nombre de la canalización.

--output-metadata-file -t

Proporcione una ubicación de archivo de salida opcional para la salida del objeto estructurado.

--output_file -f

Archivo para escribir la salida en formato JSON.

--parameters -p

Lista separada por comas de pares nombre=valor para las asignaciones de parámetros de canalización.

--path

Ruta de acceso a un directorio raíz para ejecutar archivos de configuración.

Valor predeterminado: .
--pipeline-id -i

Identificador de una canalización que se va a enviar (guid).

--pipeline-yaml -y

Archivo YAML que define una canalización.

--resource-group -g

Nombre del grupo de recursos.

--subscription-id

Especifica el identificador de suscripción.

--workspace-name -w

Nombre del área de trabajo.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az ml run submit-script

Envíe un script para su ejecución.

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 opcionales

--async

Deshabilite el streaming de salida.

Valor predeterminado: False
--conda-dependencies -d

Invalide el archivo de dependencias de Conda predeterminado.

--ct --target

Nombre del destino de proceso que se va a usar para la ejecución.

--experiment-name -e

Nombre del experimento.

--output-metadata-file -t

Proporcione una ubicación de archivo de salida opcional para la salida del objeto estructurado.

--path

Ruta de acceso a un directorio raíz para ejecutar archivos de configuración.

Valor predeterminado: .
--resource-group -g

Nombre del grupo de recursos.

--run-configuration-name -c

Nombre (sin extensión) de un archivo de configuración de ejecución. El archivo debe estar en una subcarpeta del directorio especificado por el parámetro path.

--source-directory

Directorio local que contiene archivos de código fuente. El valor predeterminado es la ruta de acceso si no se proporciona el directorio de origen.

--subscription-id

Especifica el identificador de suscripción.

--workspace-name -w

Nombre del área de trabajo.

<USER_SCRIPT_AND_ARGUMENTS>

Los argumentos de envío de ejecución, como el nombre del script y los argumentos de script.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az ml run update

Actualice la ejecución agregando etiquetas.

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

Parámetros requeridos

--run -r

RunId de una ejecución de experimento.

Parámetros opcionales

--add-tag

Etiquete la entitiy con la sintaxis 'key[=value]'.

--experiment-name -e

Nombre del experimento.

--output-metadata-file -t

Proporcione una ubicación de archivo de salida opcional para la salida del objeto estructurado.

--path

Ruta de acceso a un directorio raíz para ejecutar archivos de configuración.

Valor predeterminado: .
--resource-group -g

Nombre del grupo de recursos.

--subscription-id

Especifica el identificador de suscripción.

--workspace-name -w

Nombre del área de trabajo.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.