Solucionar problemas usando o Azure Blueprint

Importante

Azure Blueprints (versão prévia) será desativada em 31 de janeiro de 2027, com uma aposentadoria em fases a partir de 31 de julho de 2026. Migre suas definições e atribuições de blueprints existentes para Deployment Stacks (recomendado) e Template Specs. Artefatos de blueprint são convertidos em modelos ARM JSON ou arquivos Bicep usados ​​para definir pilhas de implantação. Para obter o cronograma completo das fases, o impacto e as perguntas frequentes, consulte desativação do Azure Blueprints ou https://aka.ms/AzureBlueprintsRetirement. 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 resultarão da atribuição de um modelo a um escopo. Quando uma atribuição falha, o blueprint fornece detalhes sobre a implantação que falhou. 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. Um banner vermelho avisando que a atribuição falhou está na parte superior da página de atribuição do blueprint. 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 Key Vault e a Azure Policy impede a criação do Key Vault, toda a atribuição 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 modelo para que ele não entre em conflito com as políticas indicadas 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

Os parâmetros do blueprint que são funções são processados antes de serem transmitidos aos 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.

Excluir erros

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.
  • Last updated on