Encontrar códigos de erro
Quando uma implantação de recursos do Azure falha usando modelos do ARM ou arquivos Bicep e é recebido um código de erro. Este artigo descreve como encontrar códigos de erro para que você possa solucionar o problema. Para obter mais informações sobre códigos de erro, consulte Erros comuns de implantação.
Tipos de erro
Há três tipos de erros relacionados a uma implantação:
- Os erros de validação ocorrem antes do início de uma implantação e são causados por erros de sintaxe em seu arquivo. Um editor de código como Visual Studio Code pode identificar esses erros.
- Erros de validação de simulação ocorrem quando um comando de implantação é executado, mas os recursos não são implantados. Esses erros são encontrados sem que seja necessário iniciar a implantação. Por exemplo, se um valor de parâmetro estiver incorreto, o erro será encontrado na validação de simulação.
- Os erros de implantação ocorrem durante o processo de implantação e só podem ser encontrados por meio da avaliação do progresso da implantação no seu ambiente do Azure.
Todos os tipos de erros retornam um código de erro que você usa para solucionar problemas de implantação. Os erros de validação de simulação são mostrados no log de atividades, mas não aparecem no histórico de implantação. Um arquivo Bicep com erros de sintaxe não é compilado em JSON nem mostrado no log de atividades.
Para identificar erros de sintaxe, use o Visual Studio Code com a versão mais recente da extensão do Bicep ou daextensão das ferramentas do Azure Resource Manager.
Erros de validação
Os modelos são validados durante o processo de implantação e os códigos de erro são exibidos. Antes de executar uma implantação, você pode identificar erros de validação e simulação executando testes de validação com o Azure PowerShell ou a CLI do Azure.
Um modelo do ARM pode ser implantado a partir do portal. Se o modelo tiver erros de sintaxe, você verá um erro de validação quando tentar executar a implantação. Para saber mais informações sobre implantações do portal, consulte implantar recursos de modelo personalizado.
O exemplo a seguir tenta implantar uma conta de armazenamento e ocorre um erro de validação.
Selecione a mensagem para obter mais detalhes. O modelo tem um erro de sintaxe com o código de erro InvalidTemplate. O Resumo mostra que uma expressão não tem um parêntese de fechamento.
Erros de implantação
Diversas operações são processadas para implantar um recurso do Azure. Erros de implantação ocorrem quando uma operação passa pela validação, mas falha durante a implantação. Você pode exibir mensagens sobre cada operação de implantação e cada implantação para um grupo de recursos.
Para ver mensagens sobre as operações de uma implantação, use o log de atividades do grupo de recursos:
Entre no Portal do Azure.
Vá até Grupo de recursos e selecione o nome do grupo de recursos da implantação.
Selecione Log de atividades.
Use os filtros para encontrar o log de erros de uma operação.
Selecione o log de erros para ver os detalhes da operação.
Para exibir o resultado de uma implantação:
Acesse o grupo de recursos.
Selecione Configurações>Implantações.
Selecione Detalhes do erro para implantação.
A mensagem de erro e o código de erro
NoRegisteredProviderFoundsão mostrados.