Compartir a través de

az ml deployment-template

  • Vista previa

Nota:

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

Este grupo de comandos está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Administración de plantillas de implementación de Azure ML.

Las plantillas de implementación son plantillas reutilizables que definen configuraciones de implementación para Azure ML. Solo admiten operaciones basadas en el registro (no basadas en áreas de trabajo) y proporcionan una manera de estandarizar y compartir configuraciones de implementación en equipos y proyectos.

Comandos

Nombre Description Tipo Estado
az ml deployment-template archive

Archivar una plantilla de implementación.

 Extension Preview
az ml deployment-template create

Cree una nueva plantilla de implementación a partir de un archivo YAML.

 Extension Preview
az ml deployment-template list

Enumerar plantillas de implementación en un registro.

 Extension Preview
az ml deployment-template restore

Restaure una plantilla de implementación archivada.

 Extension Preview
az ml deployment-template show

Obtenga una plantilla de implementación específica por nombre y versión.

 Extension Preview
az ml deployment-template update

Actualice campos específicos de una plantilla de implementación existente.

 Extension Preview

az ml deployment-template archive

Vista previa

El grupo de comandos "ml deployment-template" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Archivar una plantilla de implementación.

Archivar una plantilla de implementación para marcarla como inactiva. Las plantillas archivadas no se devuelven en las operaciones de lista de forma predeterminada. Puede archivar una versión específica o todas las versiones de una plantilla.

az ml deployment-template archive --name
                                  --registry-name
                                  --version
                                  [--no-wait]

Ejemplos

Archivar una versión específica

az ml deployment-template archive --name my-template --version 1 --registry-name myregistry

Archivo sin esperar a la finalización

az ml deployment-template archive --name my-template --version 1 --registry-name myregistry --no-wait

Parámetros requeridos

--name -n

Nombre de la plantilla de implementación.

--registry-name -r

Nombre del registro. Esto es necesario, ya que las plantillas de implementación solo admiten el nombre del Registro y no el área de trabajo.

--version -v

Versión de la plantilla de implementación.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--no-wait

No espere a que finalice la operación de ejecución prolongada. El valor predeterminado es False.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az ml deployment-template create

Vista previa

El grupo de comandos "ml deployment-template" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Cree una nueva plantilla de implementación a partir de un archivo YAML.

Cree una nueva plantilla de implementación mediante un archivo de configuración de YAML. El archivo YAML debe contener la definición de plantilla de implementación completa, incluidos los puntos de conexión, los parámetros y los metadatos. Puede invalidar valores específicos mediante parámetros de línea de comandos.

az ml deployment-template create --registry-name
                                 [--file]
                                 [--name]
                                 [--no-wait]
                                 [--set]
                                 [--version]

Ejemplos

Creación de una plantilla de implementación a partir de un archivo YAML

az ml deployment-template create --file template.yml --registry-name myregistry

Creación con invalidaciones de nombre y versión

az ml deployment-template create --file template.yml --name custom-template --version 2 --registry-name myregistry

Crear sin esperar a la finalización

az ml deployment-template create --file template.yml --registry-name myregistry --no-wait

Parámetros requeridos

--registry-name -r

Nombre del registro. Esto es necesario, ya que las plantillas de implementación solo admiten el nombre del Registro y no el área de trabajo.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--file -f

Ruta de acceso local al archivo YAML que contiene la especificación de plantilla de implementación de Azure ML. Los documentos de referencia de YAML para deployment-template se pueden encontrar en: https://aka.ms/ml-cli-v2-deployment-template-yaml.

--name -n

Nombre de la plantilla de implementación.

--no-wait

No espere a que finalice la operación de ejecución prolongada. El valor predeterminado es False.

Propiedad Valor
Valor predeterminado: False
--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=value.

--version -v

Versión de la plantilla de implementación.

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az ml deployment-template list

Vista previa

El grupo de comandos "ml deployment-template" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumerar plantillas de implementación en un registro.

Enumere todas las plantillas de implementación disponibles en el registro especificado. Este comando devuelve todas las plantillas junto con sus metadatos, incluidos el nombre, la versión, la descripción y las etiquetas.

az ml deployment-template list --registry-name

Ejemplos

Enumerar todas las plantillas de implementación de un registro

az ml deployment-template list --registry-name myregistry

Enumeración de plantillas de implementación con formato de salida específico

az ml deployment-template list --registry-name myregistry --output table

Parámetros requeridos

--registry-name -r

Nombre del registro. Esto es necesario, ya que las plantillas de implementación solo admiten el nombre del Registro y no el área de trabajo.

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az ml deployment-template restore

Vista previa

El grupo de comandos "ml deployment-template" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Restaure una plantilla de implementación archivada.

Restaure una plantilla de implementación archivada anteriormente para volver a activarla. Las plantillas restauradas aparecerán en las operaciones de lista. Puede restaurar una versión específica o todas las versiones de una plantilla.

az ml deployment-template restore --name
                                  --registry-name
                                  --version
                                  [--no-wait]

Ejemplos

Restaurar una versión específica

az ml deployment-template restore --name my-template --version 1 --registry-name myregistry

Restaurar sin esperar a la finalización

az ml deployment-template restore --name my-template --version 1 --registry-name myregistry --no-wait

Parámetros requeridos

--name -n

Nombre de la plantilla de implementación.

--registry-name -r

Nombre del registro. Esto es necesario, ya que las plantillas de implementación solo admiten el nombre del Registro y no el área de trabajo.

--version -v

Versión de la plantilla de implementación.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--no-wait

No espere a que finalice la operación de ejecución prolongada. El valor predeterminado es False.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az ml deployment-template show

Vista previa

El grupo de comandos "ml deployment-template" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Obtenga una plantilla de implementación específica por nombre y versión.

Recupere información detallada sobre una plantilla de implementación específica. Si no se especifica la versión, se devolverá la versión más reciente.

az ml deployment-template show --name
                               --registry-name
                               --version

Ejemplos

Obtención de una versión específica de una plantilla de implementación

az ml deployment-template show --name my-template --version 1 --registry-name myregistry

Parámetros requeridos

--name -n

Nombre de la plantilla de implementación.

--registry-name -r

Nombre del registro. Esto es necesario, ya que las plantillas de implementación solo admiten el nombre del Registro y no el área de trabajo.

--version -v

Versión de la plantilla de implementación.

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az ml deployment-template update

Vista previa

El grupo de comandos "ml deployment-template" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Actualice campos específicos de una plantilla de implementación existente.

Actualice los campos de metadatos (descripción y etiquetas) de una plantilla de implementación existente sin necesidad de un archivo YAML. Este comando sigue las convenciones de la CLI de Azure y solo acepta actualizaciones de campo específicas. Las etiquetas se combinan con etiquetas existentes en lugar de reemplazarlas.

Para los cambios estructurales en la plantilla de implementación (puntos de conexión, configuración de implementación, etc.), use el comando "create" con un archivo YAML.

az ml deployment-template update --name
                                 --registry-name
                                 --version
                                 [--add]
                                 [--force-string]
                                 [--remove]
                                 [--set]

Ejemplos

Actualización de la descripción de la plantilla de implementación

az ml deployment-template update --name my-template --version 1 --registry-name myregistry --set "description=Updated description"

Actualizar etiquetas de plantilla de implementación

az ml deployment-template update --name my-template --version 1 --registry-name myregistry --set "tags=environment=production owner=ml-team"

Actualizar tanto la descripción como las etiquetas

az ml deployment-template update --name my-template --version 1 --registry-name myregistry --set "description=Production template" --set "tags=status=active"

Parámetros requeridos

--name -n

Nombre de la plantilla de implementación.

--registry-name -r

Nombre del registro. Esto es necesario, ya que las plantillas de implementación solo admiten el nombre del Registro y no el área de trabajo.

--version -v

Versión de la plantilla de implementación.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
Valor predeterminado: []
--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
Valor predeterminado: False
--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
Valor predeterminado: []
--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
Valor predeterminado: []
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False