Solucionar problemas usando o Azure Blueprint

  • Artigo

Importante

Em 11 de julho de 2026, o Blueprints (versão prévia) será preterido. Migre suas definições e atribuições de blueprint existentes para Especificações de Modelo e Pilhas de Implantação. Os artefatos de blueprint devem ser convertidos em modelos JSON do ARM ou arquivos Bicep usados para definir pilhas de implantação. Para saber como criar um artefato como um recurso do ARM, confira:

Você pode encontrar erros ao criar, atribuir ou remover blueprints. Este artigo descreve os vários erros que podem ocorrer e como resolvê-los.

Encontrar detalhes do erro

Muitos erros serão o resultado da atribuição de um blueprint para um escopo. Quando uma atribuição falha, o blueprint fornece detalhes sobre a implantação com falha. Essa informação indica o problema para que ele possa ser corrigido e a próxima implantação for bem-sucedida.

  1. Selecione Todos os serviços no painel esquerdo. Pesquise e selecione Blueprints.

  2. Selecione Blueprints atribuídos na página à esquerda e use a caixa de pesquisa para filtrar as atribuições de blueprint para encontrar as atribuições com falha. Você também pode classificar a tabela de atribuições de acordo com a coluna Estado de Provisionamento para ver todas as atribuições com falha agrupadas.

  3. Selecione o blueprint com o status Com falha ou clique com o botão direito do mouse e selecione Exibir detalhes da atribuição.

  4. Uma faixa vermelha que falhou a atribuição de aviso está na parte superior da página de atribuição de plano gráfico. Selecione qualquer lugar na faixa para obter mais detalhes.

É comum o erro a ser causado por um artefato e não o plano gráfico como um todo. Se um artefato cria um cofre de chaves e a Azure Policy impede a criação de Cofre de chaves, a atribuição inteira falhará.

Erros gerais

Cenário: violação de política

Problema

A implantação de modelo falhou por causa da violação de política.

Causa

Uma política pode entrar em conflito com a implantação pelos seguintes motivos:

  • O recurso que está sendo criado é restrito pela política (normalmente restrições SKU ou local)
  • A implantação está definindo campos que são configurados pela política (comum com marcas)

Resolução

Altere o plano gráfico para que ele não entre em conflito com as políticas nos detalhes do erro. Se isso não for possível, uma opção alternativa será alterar o escopo da atribuição de política para que o blueprint não esteja mais em conflito com a política.

Cenário: O parâmetro de blueprint é uma função

Problema

Parâmetros de blueprint que são funções são processados antes de serem passados para artefatos.

Causa

Passar um parâmetro de blueprint que usa uma função, como [resourceGroup().tags.myTag], para um artefato faz com que o resultado processado da função seja definido no artefato em vez da função dinâmica.

Resolução

Para passar uma função como um parâmetro, faça o escape de toda a cadeia de caracteres com [, de modo que o parâmetro de blueprint se pareça com [[resourceGroup().tags.myTag]. O caractere de escape faz com que o Blueprints trate o valor como uma cadeia de caracteres ao processar o blueprint. O serviço Blueprints, em seguida, coloca a função no artefato, permitindo que ela seja dinâmica conforme o esperado. Para obter mais informações, consulte Sintaxe e expressões em modelos do Azure Resource Manager.

Erros de exclusão

Cenário: Tempo limite de exclusão de atribuição

Problema

A exclusão de uma atribuição de blueprint não foi concluída.

Causa

Uma atribuição de blueprint pode ficar paralisada em um estado não terminal quando excluída. Esse estado é causado quando os recursos criados pela atribuição de blueprint ainda estão com exclusão pendente ou não retornam um código de status para o Azure Blueprints.

Resolução

As atribuições de blueprint em um estado não terminal são marcadas automaticamente como Com falha após um tempo limite de seis horas. Depois que o tempo limite tiver ajustado o estado da atribuição de blueprint, a exclusão poderá ser repetida.

Próximas etapas

Se você não encontrou seu problema ou não conseguiu resolver seu problema, visite um dos seguintes canais para obter mais suporte:

  • Obtenha respostas de especialistas do Azure nos Fóruns do Azure.
  • Conecte-se ao @AzureSupport – a conta oficial do Microsoft Azure para aprimorar a experiência do cliente conectando a comunidade do Azure aos recursos certos: respostas, suporte e especialistas.
  • Se precisar de mais ajuda, você pode registrar um incidente de suporte do Azure. Vá para o site de suporte do Azure e selecione Obter Suporte.