az ml component

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 component. Saiba mais sobre extensões.

Gerenciar componentes do Azure ML.

O componente do Azure ML define a configuração do componente para trabalhos de pipeline. Você pode configurar as portas de entrada/saída, o ambiente de execução e o comando do componente. Depois que o componente for criado, você poderá referenciar os componentes no trabalho de pipeline para executá-los em contêineres do Docker.

Comandos

Nome	Description	Tipo	Status
az ml component archive	Arquive um componente.	Extension	GA
az ml component create	Crie um componente.	Extension	GA
az ml component list	Listar componentes em um workspace.	Extension	GA
az ml component prepare-for-sign	Prepare um componente para assinatura.	Extension	GA
az ml component restore	Restaurar um componente arquivado.	Extension	GA
az ml component show	Mostrar detalhes de um componente.	Extension	GA
az ml component update	Atualize um componente. Atualmente, apenas alguns campos (descrição, display_name) dão suporte à atualização.	Extension	GA

az ml component archive

Arquive um componente.

O arquivamento de um componente o ocultará por padrão de consultas de lista (az ml component list). Você ainda pode continuar a referenciar e usar um componente arquivado em seus pipelines. Você pode arquivar um contêiner de componentes ou uma versão de componente específica. O arquivamento de um contêiner de componente arquivará todas as versões do componente com esse nome especificado. Você pode restaurar um componente arquivado usando az ml component restore. Se todo o contêiner de componentes for arquivado, você não poderá restaurar versões individuais do componente. Você precisará restaurar o contêiner do componente.

az ml component archive --name
                        [--label]
                        [--registry-name]
                        [--resource-group]
                        [--version]
                        [--workspace-name]

Exemplos

Arquivar um contêiner de componente (arquiva todas as versões desse componente)

az ml component archive --name my-component --resource-group my-resource-group --workspace-name my-workspace

Arquivar uma versão específica do componente

az ml component archive --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Parâmetros Exigidos

--name -n

Nome do componente.

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.

--label -l

Rótulo do componente.

--registry-name

Se fornecido, o comando terá como destino o registro em vez de um workspace. Portanto, o grupo de recursos e o workspace não serão necessários.

--resource-group -g

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

--version -v

Versão do componente.

--workspace-name -w

Nome do workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<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 component create

Crie um componente.

az ml component create --file
                       [--name]
                       [--registry-name]
                       [--resource-group]
                       [--set]
                       [--skip-validation]
                       [--version]
                       [--workspace-name]

Exemplos

Criar um componente com base em um arquivo de especificação YAML

az ml component create --file my_component.yml --resource-group my-resource-group --workspace-name my-workspace

Criar um componente de um arquivo de especificação YAML com a versão especificada

az ml component create --file my_component.yml --version 1 --resource-group my-resource-group --workspace-name my-workspace

Criar um componente no registro a partir de um arquivo de especificação YAML

az ml component create --file my_component.yml --registry-name my-registry-name --resource-group my-resource-group

Criar um componente no registro a partir de um arquivo de especificação YAML com a versão especificada

az ml component create --file my_component.yml --version 1 --registry-name my-registry-name --resource-group my-resource-group

Parâmetros Exigidos

--file -f

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

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

--registry-name

Se fornecido, o comando terá como destino o registro em vez de um workspace. Portanto, o grupo de recursos e o workspace não serão necessários.

--resource-group -g

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

--set

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

--skip-validation

Ignore a validação na criação do recurso. Observe que os recursos dependentes não ignorarão a validação na criação.

Propriedade	Valor
Valor padrão:	False

--version -v

Versão do componente.

--workspace-name -w

Nome do workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<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 component list

Listar componentes em um workspace.

az ml component list [--archived-only]
                     [--include-archived]
                     [--max-results]
                     [--name]
                     [--registry-name]
                     [--resource-group]
                     [--workspace-name]

Exemplos

Listar todos os componentes em um workspace

az ml component list --resource-group my-resource-group --workspace-name my-workspace

Listar todas as versões do componente para o nome especificado em um workspace

az ml component list --name my-component --resource-group my-resource-group --workspace-name my-workspace

Liste todos os componentes em um workspace usando o argumento --query para executar uma consulta JMESPath nos resultados dos comandos.

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

Listar todos os componentes em um registro

az ml component list --registry-name my-registry-name --resource-group my-resource-group

Listar todas as versões do componente para o nome especificado em um registro

az ml component list --name my-component --registry-name my-registry-name --resource-group my-resource-group

Liste todos os componentes em um registro usando o argumento --query para executar uma consulta JMESPath nos resultados dos comandos.

az ml component list --query "[].{Name:name}"  --output table --registry-name my-registry-name --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.

--archived-only

Listar somente componentes arquivados.

Propriedade	Valor
Valor padrão:	False

--include-archived

Listar componentes arquivados e componentes ativos.

Propriedade	Valor
Valor padrão:	False

--max-results -r

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

--name -n

Nome do componente.

--registry-name

Se fornecido, o comando terá como destino o registro em vez de um workspace. Portanto, o grupo de recursos e o workspace não serão necessários.

--resource-group -g

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

--workspace-name -w

Nome do workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<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 component prepare-for-sign

Prepare um componente para assinatura.

Preparar um componente para o sinal gera dois arquivos: catalog.json e catalog.json.sig, esses arquivos contêm o SHA256 gerado para cada arquivo que está presente na pasta de destino. Se os arquivos já estiverem presentes, eles serão excluídos e novos arquivos serão criados com a assinatura atualizada.

az ml component prepare-for-sign --file
                                 [--registry-name]
                                 [--resource-group]
                                 [--workspace-name]

Exemplos

Preparar um componente de um arquivo de especificação YAML para assinatura

az ml component prepare-for-sign --file my_component.yml --resource-group my-resource-group --workspace-name my-workspace

Preparar um componente no registro de um arquivo de especificação YAML para assinatura

az ml component prepare-for-sign --file my_component.yml --registry-name my-registry-name --resource-group my-resource-group

Parâmetros Exigidos

--file -f

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.

--registry-name

Se fornecido, o comando terá como destino o registro em vez de um workspace. Portanto, o grupo de recursos e o workspace não serão necessários.

--resource-group -g

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

--workspace-name -w

Nome do workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<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 component restore

Restaurar um componente arquivado.

Quando um componente arquivado for restaurado, ele não ficará mais oculto das consultas de lista (az ml component list). Se um contêiner de componente inteiro for arquivado, você poderá restaurar esse contêiner arquivado. Isso restaurará todas as versões do componente com esse nome especificado. Não é possível restaurar apenas uma versão de componente específica se todo o contêiner de componentes for arquivado. Você precisará restaurar todo o contêiner. Se apenas uma versão de componente individual tiver sido arquivada, você poderá restaurar essa versão específica.

az ml component restore --name
                        [--label]
                        [--registry-name]
                        [--resource-group]
                        [--version]
                        [--workspace-name]

Exemplos

Restaurar um contêiner de componente arquivado (restaura todas as versões desse componente)

az ml component restore --name my-component --resource-group my-resource-group --workspace-name my-workspace

Restaurar uma versão específica do componente arquivado

az ml component restore --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Parâmetros Exigidos

--name -n

Nome do componente.

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.

--label -l

Rótulo do componente.

--registry-name

Se fornecido, o comando terá como destino o registro em vez de um workspace. Portanto, o grupo de recursos e o workspace não serão necessários.

--resource-group -g

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

--version -v

Versão do componente.

--workspace-name -w

Nome do workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<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 component show

Mostrar detalhes de um componente.

az ml component show --name
                     [--label]
                     [--registry-name]
                     [--resource-group]
                     [--version]
                     [--workspace-name]

Exemplos

Mostrar detalhes para um componente com o nome e a versão especificados

az ml component show --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Mostrar detalhes de um componente no Registro com o nome e a versão especificados

az ml component show --name my-component --version 1 --registry-name my-registry-name --resource-group my-resource-group

Parâmetros Exigidos

--name -n

Nome do componente.

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.

--label -l

Rótulo do componente.

--registry-name

Se fornecido, o comando terá como destino o registro em vez de um workspace. Portanto, o grupo de recursos e o workspace não serão necessários.

--resource-group -g

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

--version -v

Versão do componente.

--workspace-name -w

Nome do workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<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 component update

Atualize um componente. Atualmente, apenas alguns campos (descrição, display_name) dão suporte à atualização.

az ml component update --name
                       --resource-group
                       --workspace-name
                       [--add]
                       [--force-string]
                       [--label]
                       [--registry-name]
                       [--remove]
                       [--set]
                       [--version]

Exemplos

Atualizar a descrição de um componente

az ml component update -n my_component -v 1 --set description="new description" -g my-resource-group -w my-workspace

Parâmetros Exigidos

--name -n

Nome do componente.

--resource-group -g

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

--workspace-name -w

Nome do workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<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:	[]

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

--label -l

Rótulo do componente.

--registry-name

Se fornecido, o comando terá como destino o registro em vez de um workspace. Portanto, o grupo de recursos e o workspace não serão necessários.

--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:	[]

--version -v

Versão do componente.

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

Comentários

Esta página foi útil?

Compartilhar via

az ml component

Comandos

az ml component archive

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az ml component create

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az ml component list

Exemplos

Parâmetros Opcionais

az ml component prepare-for-sign

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az ml component restore

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az ml component show

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az ml component update

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

Comentários