Compartir a través de

az ml registry

Note

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 registry . Obtenga más información sobre las extensiones.

Administración de registros de Azure ML.

Un registro de Azure ML es un recurso de nivel superior para Azure Machine Learning. Proporciona un espacio de nivel superior para almacenar otros recursos, a los que pueden acceder varias áreas de trabajo en distintas regiones.

Comandos

Nombre Description Tipo Estado
az ml registry create

Cree un registro.

 Extension GA
az ml registry delete

Elimine un registro determinado.

 Extension GA
az ml registry list

Enumere todos los registros de una suscripción o un grupo de recursos.

 Extension GA
az ml registry show

Mostrar los detalles de un registro.

 Extension GA
az ml registry update

Actualizar un registro.

 Extension GA

az ml registry create

Cree un registro.

Cuando se crea un registro, se crean de forma predeterminada varios recursos de Azure que usará el registro, específicamente azure Storage y Azure Container Registry. No se admite el uso de instancias de recursos de Azure existentes para aquellos al crear el registro.

az ml registry create --resource-group
                      [--display-name]
                      [--file]
                      [--name]
                      [--no-wait]
                      [--public-network-access]
                      [--set]
                      [--tags]

Ejemplos

Cree un registro a partir de un archivo de especificación DE YAML.

az ml registry create --resource-group my-resource-group --file registry.yml

Parámetros requeridos

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

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.

--display-name

Nombre para mostrar del registro.

--file -f

Ruta de acceso local al archivo YAML que contiene la especificación del registro de Azure ML. Los documentos de referencia de YAML para el Registro se pueden encontrar en: https://aka.ms/ml-cli-v2-registry-yaml-reference.

--name -n

Nombre del registro de Azure ML.

--no-wait

No espere a que finalice la creación del registro.

Propiedad Valor
Valor predeterminado: False
--public-network-access

Permitir la conectividad del punto de conexión público para un registro.

--set

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

--tags

Pares clave-valor separados por espacios para las etiquetas del objeto.

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

Elimine un registro determinado.

az ml registry delete [--name]
                      [--resource-group]

Ejemplos

Elimine un registro de un grupo de recursos específico.

az ml registry delete --resource-group my-resource-group --name my-registry-name

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.

--name -n

Nombre del registro de Azure ML. Puede configurar el grupo predeterminado mediante az configure --defaults registry=<name>.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

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

Enumere todos los registros de una suscripción o un grupo de recursos.

az ml registry list [--max-results]
                    [--resource-group]

Ejemplos

Enumere todos los registros en el grupo de recursos predeterminado y el identificador de suscripción.

az ml registry list

Enumere todos los registros del grupo de recursos predeterminado de la suscripción especificada. Si no se establece ningún grupo de recursos predeterminado, enumere todos los registros de la suscripción.

az ml registry list --subscription my-subscription-id

Enumere todos los registros de un grupo de recursos y una suscripción específicos.

az ml registry list --resource-group my-resource-group --subscription my-subscription-id

Enumere todos los registros mediante el argumento --query para ejecutar una consulta JMESPath en los resultados de los comandos.

az ml registry list --query "[].{Name:name}"  --output table --resource-group my-resource-group

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.

--max-results -r

Número máximo de resultados que se van a devolver.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

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

Mostrar los detalles de un registro.

az ml registry show --name
                    --resource-group

Ejemplos

Muestra los detalles de un registro con nombre que se encuentra en el grupo de recursos y la suscripción especificados.

az ml registry show --resource-group my-resource-group --subscription my-subscription-id --name my-registry-name

Parámetros requeridos

--name -n

Nombre del registro de Azure ML. Puede configurar el grupo predeterminado mediante az configure --defaults registry=<name>.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

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

Actualizar un registro.

Actualizar un registro. Este comando se comporta principalmente como el comando create, salvo que esto garantiza que existe el registro de destino, y se puede ejecutar sin una entrada --file si se proporciona una entrada --name válida. Los campos se pueden modificar definiendo nuevos valores en YAML, el argumento --set o los argumentos de entrada normales de los campos. Actualmente, no todos los campos son seguros para modificar. Las modificaciones válidas incluyen: cambios arbitrarios en las etiquetas del Registro y agregar nuevos valores al campo region_details. ADVERTENCIA: El argumento --file no es compatible con la modificación de valores a través de --set. Si desea establecer el registro mediante una combinación de archivos y argumentos de la CLI, use los argumentos directos de la CLI para los valores que desea modificar, como se muestra a continuación.

az ml registry update --resource-group
                      [--add]
                      [--display-name]
                      [--file]
                      [--force-string]
                      [--name]
                      [--no-wait]
                      [--public-network-access]
                      [--remove]
                      [--set]
                      [--tags]

Ejemplos

Actualice un registro desde un archivo de especificación YAML.

az ml registry update --resource-group my-resource-group --file registry.yml --tags tag=value

Actualizar campos específicos de un registro

az ml registry update --resource-group my-resource-group --name myRegistry --set tags.tag=value

Parámetros requeridos

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

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: []
--display-name

Nombre para mostrar del registro.

--file -f

Ruta de acceso local al archivo YAML que contiene la especificación del registro de Azure ML. Los documentos de referencia de YAML para el Registro se pueden encontrar en: https://aka.ms/ml-cli-v2-registry-yaml-reference.

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

Nombre del registro de Azure ML.

--no-wait

No espere a que finalice la actualización del Registro.

Propiedad Valor
Valor predeterminado: False
--public-network-access

Permitir la conectividad del punto de conexión público para un registro.

--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: []
--tags

Pares clave-valor separados por espacios para las etiquetas del objeto.

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