Compartilhar via

az ml registry

  • Referência

Nota

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

Gerenciar registros do Azure ML.

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

Comandos

Nome Description Tipo Status
az ml registry create

Crie um registro.

 Extensão GA
az ml registry delete

Exclua um determinado registro.

 Extensão GA
az ml registry list

Liste 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

Crie 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 o 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 com base em 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 de exibição para o 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 yaml para registro podem ser encontrados em: https://aka.ms/ml-cli-v2-registry-yaml-reference.

--name -n

Nome do Registro de ML do Azure.

--no-wait

Não aguarde 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 ser definido. Exemplo: --set property1.property2=value.

--tags

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

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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 de ML do Azure. 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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az ml registry list

Liste 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

Liste 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

Liste todos os registros em um grupo de recursos e uma 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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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 de ML do Azure. 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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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 pode ser executado sem uma entrada --file se uma entrada --name válida for fornecida. Os campos podem ser modificados definindo novos valores no YAML, no argumento --set ou nos argumentos de entrada normais dos campos. No momento, nem todos os campos são seguros para modificação. 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ê quiser definir o Registro usando uma combinação de um arquivo e CLI args, use os args da CLI direta 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 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 valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

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

Nome de exibição para o 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 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 em JSON.

Valor padrão: False
--name -n

Nome do Registro de ML do Azure.

--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> OR --remove propertyToRemove.

Valor padrão: []
--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. 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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.