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 será instalada automaticamente na primeira vez que você executar um comando de registro az ml. Saiba mais sobre extensões.

Gerenciar registros do Azure ML.

Um registo 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 espaços de trabalho em diferentes regiões.

Comandos

Name Description Tipo Estado
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

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

 Extensão GA
az ml registry show

Mostrar detalhes de um registo.

 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 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 Obrigatórios

--resource-group -g

o 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 registo 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 aguarde a criação do registro terminar.

valor predefinido: 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=.

--tags

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

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

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

--resource-group -g

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az ml registry show

Mostrar detalhes de um registo.

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

Exemplos

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

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

Parâmetros Obrigatórios

--name -n

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

--resource-group -g

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az ml registry update

Atualize um registro.

Atualize um registro. Este comando se comporta principalmente como o comando create, exceto que isso garante que o registro de destino existe, e pode ser executado sem uma entrada --file se uma entrada --name válida for fornecida. Os campos podem ser modificados definindo novos valores em YAML, o argumento --set ou os argumentos de entrada normais dos campos. Nem todos os campos são atualmente seguros para modificar. 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 através de --set. Se você deseja definir o registro usando uma combinação de um arquivo e args CLI, use os args CLI diretos 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 registo

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

Parâmetros Obrigatórios

--resource-group -g

o 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 predefinido: []
--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 registo podem ser encontrados em: https://aka.ms/ml-cli-v2-registry-yaml-reference.

--force-string

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

valor predefinido: False
--name -n

Nome do registro do Azure ML.

--no-wait

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

valor predefinido: 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 predefinido: []
--set

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

valor predefinido: []
--tags

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.