Compartir a través de

az ml registry

  • Referencia

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

 Extensión GA
az ml registry delete

Elimine un registro determinado.

 Extensión GA
az ml registry list

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

 Extensión GA
az ml registry show

Mostrar los detalles de un registro.

 Extensión GA
az ml registry update

Actualizar un registro.

 Extensión 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

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

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

--tags

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

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

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

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

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

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.

valor predeterminado: False
--name -n

Nombre del registro de Azure ML.

--no-wait

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

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.

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

valor predeterminado: []
--tags

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

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.