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.

Captura de tela de um erro de validação no portal do Azure para uma tentativa de implantação da conta de armazenamento.

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.

Captura de tela de uma mensagem de erro de validação no portal do Azure, mostrando um erro de sintaxe com o código de erro InvalidTemplate.

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:

  1. Entre no Portal do Azure.

  2. Vá até Grupo de recursos e selecione o nome do grupo de recursos da implantação.

  3. Selecione Log de atividades.

  4. Use os filtros para encontrar o log de erros de uma operação.

    Captura de tela do log de atividades do grupo de recursos do portal do Azure enfatizando uma implantação que falhou com um log de erros.

  5. Selecione o log de erros para ver os detalhes da operação.

    Captura de tela do log de atividades no portal do Azure mostrando uma mensagem de erro de uma implantação com falha e os detalhes da operação.

Para exibir o resultado de uma implantação:

  1. Acesse o grupo de recursos.

  2. Selecione Configurações>Implantações.

  3. Selecione Detalhes do erro para implantação.

    Captura de tela da seção de implantação de um grupo de recursos no portal do Azure, mostrando um link para os detalhes de erro de uma implantação com falha.

  4. A mensagem de erro e o código de erro NoRegisteredProviderFound são mostrados.

    Captura de tela de um resumo de erros de implantação no portal do Azure, mostrando a mensagem de erro e o código de erro NoRegisteredProviderFound.

Próximas etapas