Partilhar via

az ml deployment-template

  • Pré-visualizar

Observação

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

Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Gerencie 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 suportam apenas operações baseadas no Registro (não baseadas em espaço de trabalho) e fornecem uma maneira de padronizar e compartilhar configurações de implantação entre equipes e projetos.

Comandos

Name Description Tipo Status
az ml deployment-template archive

Arquivar 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

Restaure 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

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

 Extension Preview

az ml deployment-template archive

Pré-visualizar

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

Arquivar 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 esperar pela conclusão

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

Parâmetros Obrigatórios

--name -n

Nome do modelo de implantação.

--registry-name -r

Nome do registo. Isso é necessário, pois os modelos de implantação suportam apenas o nome do Registro e não o espaço de trabalho.

--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 tornar-se necessários para que o comando seja executado com êxito.

--no-wait

Não espere que a operação de longa duração termine. O padrão é False.

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az ml deployment-template create

Pré-visualizar

O grupo de comandos 'ml deployment-template' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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 esperar pela conclusão

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

Parâmetros Obrigatórios

--registry-name -r

Nome do registo. Isso é necessário, pois os modelos de implantação suportam apenas o nome do Registro e não o espaço de trabalho.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--file -f

Caminho local para o arquivo YAML que contém a especificação do modelo de implantação do Azure ML. Os documentos de referência do YAML para o modelo de implantação 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 espere que a operação de longa duração termine. O padrão é False.

Propriedade Valor
Default value: 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az ml deployment-template list

Pré-visualizar

O grupo de comandos 'ml deployment-template' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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. Este comando retorna todos os modelos junto com seus metadados, incluindo nome, versão, descrição e tags.

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

--registry-name -r

Nome do registo. Isso é necessário, pois os modelos de implantação suportam apenas o nome do Registro e não o espaço de trabalho.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az ml deployment-template restore

Pré-visualizar

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

Restaure um modelo de implantação arquivado.

Restaure um modelo de implantação arquivado anteriormente para torná-lo ativo novamente. Os modelos restaurados aparecerão nas 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 esperar pela conclusão

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

Parâmetros Obrigatórios

--name -n

Nome do modelo de implantação.

--registry-name -r

Nome do registo. Isso é necessário, pois os modelos de implantação suportam apenas o nome do Registro e não o espaço de trabalho.

--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 tornar-se necessários para que o comando seja executado com êxito.

--no-wait

Não espere que a operação de longa duração termine. O padrão é False.

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az ml deployment-template show

Pré-visualizar

O grupo de comandos 'ml deployment-template' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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 Obrigatórios

--name -n

Nome do modelo de implantação.

--registry-name -r

Nome do registo. Isso é necessário, pois os modelos de implantação suportam apenas o nome do Registro e não o espaço de trabalho.

--version -v

Versão do modelo de implantação.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az ml deployment-template update

Pré-visualizar

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

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

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

Para alterações estruturais no modelo de implantação (endpoints, 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 tags 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 tags

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

Parâmetros Obrigatórios

--name -n

Nome do modelo de implantação.

--registry-name -r

Nome do registo. Isso é necessário, pois os modelos de implantação suportam apenas o nome do Registro e não o espaço de trabalho.

--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 tornar-se necessários para que o comando seja executado com êxito.

--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
Default value: []
--force-string

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

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Default value: False
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OU --remove propertyToRemove.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Default value: []
--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
Default value: []
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False