Partilhar via


Solucionar erros usando o Azure Blueprints

Importante

Em 11 de julho de 2026, os Blueprints (Preview) serão preteridos. Migre suas definições e atribuições de blueprint existentes para Especificações de modelo e Pilhas de implantação. Os artefatos do Blueprint devem ser convertidos em modelos JSON ARM ou arquivos Bicep usados para definir pilhas de implantação. Para saber como criar um artefato como um recurso ARM, consulte:

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

Localizando detalhes do erro

Muitos erros serão o resultado da atribuição de um esquema a um âmbito. Quando uma atribuição falha, o esquema apresenta os detalhes sobre a implementação com falha. Esta informação indica o problema para o poder corrigir e para que a próxima implementação seja bem sucedida.

  1. Selecione Todos os serviços no painel esquerdo. Procure e selecione Esquemas.

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

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

  4. Uma faixa vermelha a avisar que a atribuição falhou será apresentada na parte superior da página de atribuição de esquemas. Selecione qualquer ponto na faixa para obter mais detalhes.

É comum que o erro seja causado por um artefacto e não pelo esquema como um todo. Se um artefacto criar um Key Vault e o Azure Policy impedir a criação do Key Vault, toda a atribuição falhará.

Erros gerais

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

Problema

A implementação do modelo falhou devido à violação da política.

Motivo

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

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

Resolução

Altere o esquema para que ele não entre em conflito com as políticas nos detalhes do erro. Se essa alteração não for possível, uma opção alternativa é ter o escopo da atribuição de política alterado para que o plano não entre mais em conflito com a política.

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

Problema

Os parâmetros do Blueprint que são funções são processados antes de serem passados para artefatos.

Motivo

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

Resolução

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

Excluir erros

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

Problema

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

Motivo

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

Resolução

As atribuições do Blueprint em um estado não terminal são automaticamente marcadas como Reprovadas após um tempo limite de seis horas . Uma vez que o tempo limite tenha ajustado o estado da atribuição de blueprint, a exclusão pode ser repetida.

Próximos passos

Se não viu o problema ou não conseguiu resolvê-lo, visite um dos seguintes canais para obter mais suporte:

  • Obtenha respostas de especialistas do Azure através dos Fóruns do Azure.
  • Conecte-se com o @AzureSupport - a conta oficial do Microsoft Azure para melhorar 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.