Compartilhar via

az ml deployment-template

  • Versão Prévia

Observação

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

Esse grupo de comandos está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gerenciar modelos de implantação do Azure ML.

Os modelos de implantação são modelos reutilizáveis que definem configurações de implantação para o Azure ML. Eles dão suporte apenas a operações baseadas em registro (não baseadas em workspace) e fornecem uma maneira de padronizar e compartilhar configurações de implantação entre equipes e projetos.

Comandos

Nome Description Tipo Status
az ml deployment-template archive

Arquive um modelo de implantação.

 Extension Preview
az ml deployment-template create

Crie um novo modelo de implantação a partir de um arquivo YAML.

 Extension Preview
az ml deployment-template list

Listar modelos de implantação em um registro.

 Extension Preview
az ml deployment-template restore

Restaurar um modelo de implantação arquivado.

 Extension Preview
az ml deployment-template show

Obtenha um modelo de implantação específico por nome e versão.

 Extension Preview
az ml deployment-template update

Atualize campos específicos de um modelo de implantação existente.

 Extension Preview

az ml deployment-template archive

Versão Prévia

O grupo de comandos 'ml deployment-template' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Arquive um modelo de implantação.

Arquive um modelo de implantação para marcá-lo como inativo. Os modelos arquivados não são retornados em operações de lista por padrão. Você pode arquivar uma versão específica ou todas as versões de um modelo.

az ml deployment-template archive --name
                                  --registry-name
                                  --version
                                  [--no-wait]

Exemplos

Arquivar uma versão específica

az ml deployment-template archive --name my-template --version 1 --registry-name myregistry

Arquivar sem aguardar a conclusão

az ml deployment-template archive --name my-template --version 1 --registry-name myregistry --no-wait

Parâmetros Exigidos

--name -n

Nome do modelo de implantação.

--registry-name -r

Nome do registro. Isso é necessário, pois os modelos de implantação dão suporte apenas ao nome do registro e não ao workspace.

--version -v

Versão do modelo de implantação.

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.

--no-wait

Não aguarde a conclusão da operação de execução prolongada. O padrão é False.

Propriedade Valor
Valor padrão: False
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 deployment-template create

Versão Prévia

O grupo de comandos 'ml deployment-template' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Crie um novo modelo de implantação a partir de um arquivo YAML.

Crie um novo modelo de implantação usando um arquivo de configuração YAML. O arquivo YAML deve conter a definição completa do modelo de implantação, incluindo pontos de extremidade, parâmetros e metadados. Você pode substituir valores específicos usando parâmetros de linha de comando.

az ml deployment-template create --registry-name
                                 [--file]
                                 [--name]
                                 [--no-wait]
                                 [--set]
                                 [--version]

Exemplos

Criar um modelo de implantação a partir de um arquivo YAML

az ml deployment-template create --file template.yml --registry-name myregistry

Criar com substituições de nome e versão

az ml deployment-template create --file template.yml --name custom-template --version 2 --registry-name myregistry

Criar sem aguardar a conclusão

az ml deployment-template create --file template.yml --registry-name myregistry --no-wait

Parâmetros Exigidos

--registry-name -r

Nome do registro. Isso é necessário, pois os modelos de implantação dão suporte apenas ao nome do registro e não ao workspace.

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.

--file -f

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

--name -n

Nome do modelo de implantação.

--no-wait

Não aguarde a conclusão da operação de execução prolongada. O padrão é False.

Propriedade Valor
Valor padrão: False
--set

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

--version -v

Versão do modelo de implantação.

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 deployment-template list

Versão Prévia

O grupo de comandos 'ml deployment-template' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Listar modelos de implantação em um registro.

Liste todos os modelos de implantação disponíveis no registro especificado. Esse comando retorna todos os modelos junto com seus metadados, incluindo nome, versão, descrição e marcas.

az ml deployment-template list --registry-name

Exemplos

Listar todos os modelos de implantação em um registro

az ml deployment-template list --registry-name myregistry

Listar modelos de implantação com formato de saída específico

az ml deployment-template list --registry-name myregistry --output table

Parâmetros Exigidos

--registry-name -r

Nome do registro. Isso é necessário, pois os modelos de implantação dão suporte apenas ao nome do registro e não ao workspace.

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 deployment-template restore

Versão Prévia

O grupo de comandos 'ml deployment-template' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Restaurar um modelo de implantação arquivado.

Restaure um modelo de implantação arquivado anteriormente para torná-lo ativo novamente. Os modelos restaurados serão exibidos em operações de lista. Você pode restaurar uma versão específica ou todas as versões de um modelo.

az ml deployment-template restore --name
                                  --registry-name
                                  --version
                                  [--no-wait]

Exemplos

Restaurar uma versão específica

az ml deployment-template restore --name my-template --version 1 --registry-name myregistry

Restaurar sem aguardar a conclusão

az ml deployment-template restore --name my-template --version 1 --registry-name myregistry --no-wait

Parâmetros Exigidos

--name -n

Nome do modelo de implantação.

--registry-name -r

Nome do registro. Isso é necessário, pois os modelos de implantação dão suporte apenas ao nome do registro e não ao workspace.

--version -v

Versão do modelo de implantação.

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.

--no-wait

Não aguarde a conclusão da operação de execução prolongada. O padrão é False.

Propriedade Valor
Valor padrão: False
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 deployment-template show

Versão Prévia

O grupo de comandos 'ml deployment-template' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Obtenha um modelo de implantação específico por nome e versão.

Recupere informações detalhadas sobre um modelo de implantação específico. Se a versão não for especificada, a versão mais recente será retornada.

az ml deployment-template show --name
                               --registry-name
                               --version

Exemplos

Obter uma versão específica de um modelo de implantação

az ml deployment-template show --name my-template --version 1 --registry-name myregistry

Parâmetros Exigidos

--name -n

Nome do modelo de implantação.

--registry-name -r

Nome do registro. Isso é necessário, pois os modelos de implantação dão suporte apenas ao nome do registro e não ao workspace.

--version -v

Versão do modelo de implantação.

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 deployment-template update

Versão Prévia

O grupo de comandos 'ml deployment-template' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Atualize campos específicos de um modelo de implantação existente.

Atualize os campos de metadados (descrição e marcas) de um modelo de implantação existente sem a necessidade de um arquivo YAML. Esse comando segue as convenções da CLI do Azure e aceita apenas atualizações de campo específicas. As marcas são mescladas com marcas existentes em vez de substituídas.

Para alterações estruturais no modelo de implantação (pontos de extremidade, configuração de implantação etc.), use o comando 'create' com um arquivo YAML.

az ml deployment-template update --name
                                 --registry-name
                                 --version
                                 [--add]
                                 [--force-string]
                                 [--remove]
                                 [--set]

Exemplos

Atualizar descrição do modelo de implantação

az ml deployment-template update --name my-template --version 1 --registry-name myregistry --set "description=Updated description"

Atualizar marcas de modelo de implantação

az ml deployment-template update --name my-template --version 1 --registry-name myregistry --set "tags=environment=production owner=ml-team"

Atualizar a descrição e as marcas

az ml deployment-template update --name my-template --version 1 --registry-name myregistry --set "description=Production template" --set "tags=status=active"

Parâmetros Exigidos

--name -n

Nome do modelo de implantação.

--registry-name -r

Nome do registro. Isso é necessário, pois os modelos de implantação dão suporte apenas ao nome do registro e não ao workspace.

--version -v

Versão do modelo de implantação.

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