Compartilhar via

az ml registry

  • Referência

Observação

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

Gerenciar registros de ML do Azure.

Um registro do Azure ML é um recurso de nível superior para o Aprendizado de Máquina do Azure. Ele fornece um espaço de nível superior para armazenar outros recursos, que podem ser acessados por vários espaços de trabalho em diferentes regiões.

Comandos

Nome Description Tipo Status
az ml registry create

Criar um registro.

 Extensão GA
az ml registry delete

Exclua um determinado registro.

 Extensão GA
az ml registry list

Listar todos os registros em uma assinatura ou grupo de recursos.

 Extensão GA
az ml registry show

Mostrar detalhes de um registro.

 Extensão GA
az ml registry update

Atualize um registro.

 Extensão GA

az ml registry create

Criar um registro.

Quando um registro é criado, vários recursos do Azure que serão usados pelo Registro são criados por padrão, especificamente um Armazenamento do Azure e um Registro de Contêiner do Azure. Não há suporte para o uso de instâncias de recursos existentes do Azure para aqueles ao criar o Registro.

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

Exemplos

Crie um registro a partir de um arquivo de especificação YAML.

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

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--display-name

Nome para exibição do Registro.

--file -f

Caminho local para o arquivo YAML que contém a especificação do Registro do Azure ML. Os documentos de referência do YAML para registro podem ser encontrados em: https://aka.ms/ml-cli-v2-registry-yaml-reference.

--name -n

Nome do registro do Azure ML.

--no-wait

Não espere a conclusão da criação do registro.

Valor padrão: False
--public-network-access

Permitir conectividade de ponto de extremidade público para um registro.

--set

Atualize um objeto especificando um caminho de propriedade e um valor a serem definidos. Exemplo: --set property1.property2=.

--tags

Pares chave-valor separados por espaço para as marcas do objeto.

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

Exclua um determinado registro.

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

Exemplos

Exclua um registro de um grupo de recursos específico.

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

Parâmetros Opcionais

--name -n

Nome do registro do Azure ML. Você pode configurar o grupo padrão usando az configure --defaults registry=<name>.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

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

Listar todos os registros em uma assinatura ou grupo de recursos.

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

Exemplos

Liste todos os registros no grupo de recursos padrão e na ID da assinatura.

az ml registry list

Listar todos os registros no grupo de recursos padrão na assinatura especificada. Se nenhum grupo de recursos padrão estiver definido, liste todos os registros na assinatura.

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

Listar todos os registros em um grupo de recursos e assinatura específicos.

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

Liste todos os registros usando o argumento --query para executar uma consulta JMESPath nos resultados dos comandos.

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

Parâmetros Opcionais

--max-results -r

Número máximo de resultados a serem retornados.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

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

Mostrar detalhes de um registro.

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

Exemplos

Mostrar detalhes de um registro nomeado que está no grupo de recursos e assinatura especificados.

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

Parâmetros Exigidos

--name -n

Nome do registro do Azure ML. Você pode configurar o grupo padrão usando az configure --defaults registry=<name>.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

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

Atualize um registro.

Atualize um registro. Esse comando se comporta principalmente como o comando create, exceto que isso garante que o registro de destino exista e possa ser executado sem uma entrada --file se uma entrada --name válida for fornecida. Os campos podem ser modificados definindo novos valores no YAML, o argumento --set ou os argumentos de entrada normais dos campos. Nem todos os campos são seguros para modificação no momento. As modificações válidas incluem: alterações arbitrárias nas marcas do Registro e adição de novos valores ao campo region_details. AVISO: O argumento --file é incompatível com a modificação de valores por meio de --set. Se você deseja definir o registro usando uma combinação de um arquivo e args da CLI, use os args diretos da CLI para os valores que deseja modificar, conforme exemplificado abaixo.

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

Exemplos

Atualize um registro a partir de um arquivo de especificação YAML.

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

Atualizar campos específicos de um registro

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

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valores de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Valor padrão: []
--display-name

Nome para exibição do Registro.

--file -f

Caminho local para o arquivo YAML que contém a especificação do Registro do Azure ML. Os documentos de referência do YAML para registro podem ser encontrados em: https://aka.ms/ml-cli-v2-registry-yaml-reference.

--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter para JSON.

Valor padrão: False
--name -n

Nome do registro do Azure ML.

--no-wait

Não aguarde a conclusão da atualização do Registro.

Valor padrão: False
--public-network-access

Permitir conectividade de ponto de extremidade público para um registro.

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OU --remove propertyToRemove.

Valor padrão: []
--set

Atualize um objeto especificando um caminho de propriedade e um valor a serem definidos. Exemplo: --set property1.property2=<value>.

Valor padrão: []
--tags

Pares chave-valor separados por espaço para as marcas do objeto.

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.