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. Seu editor 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.

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 executar testes de validação com o Azure PowerShell ou a CLI do Azure para identificar erros de validação e de simulação.

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.

Screenshot of an Azure portal validation error.

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.

Screenshot of a validation error message that shows a syntax error.

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.

    Screenshot of the resource group's activity log that highlights a failed deployment.

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

    Screenshot of the activity log details that shows a failed deployment's error message.

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.

    Screenshot of a resource group's link to error details for a failed deployment.

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

    Screenshot of a message that shows deployment error details.

Próximas etapas