Compartilhar via

az ml registry

Note

Essa referência faz parte da extensão ml da 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 espaços de trabalho em diferentes regiões.

Comandos

Nome Description Tipo Status
az ml registry create

Criar um registro.

 Extension GA
az ml registry delete

Exclua um determinado registro.

 Extension GA
az ml registry list

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

 Extension GA
az ml registry show

Mostrar detalhes de um registro.

 Extension GA
az ml registry update

Atualize um registro.

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

Propriedade Valor
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 de valores-chave separados por espaço para as tags do objeto.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propriedade Valor
Valor padrão: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propriedade Valor
Valor padrão: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propriedade Valor
Valor padrão: False

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.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propriedade Valor
Valor padrão: False

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, no argumento --set ou nos argumentos de entrada normais dos campos. No momento, nem todos os campos podem ser modificados com segurança. 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 argumentos da CLI, use os argumentos 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 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
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.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
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.

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

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valor padrão: []
--set

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

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valor padrão: []
--tags

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

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propriedade Valor
Valor padrão: False