Resolver erros com o Azure Blueprints

  • Artigo

Importante

A 11 de julho de 2026, o Blueprints (Pré-visualização) será preterido. Migre as definições e atribuições de esquemas existentes para As Especificações de Modelo e As Pilhas de Implementação. Os artefactos de esquema devem ser convertidos em modelos JSON do ARM ou ficheiros Bicep utilizados para definir pilhas de implementação. Para saber como criar um artefacto como um recurso do ARM, consulte:

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

Localizar 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. Também pode ordenar a tabela de atribuições pela coluna Estado de Aprovisionamento para ver todas as atribuições falhadas agrupadas em conjunto.

  3. Selecione o esquema com o estado Falha ou clique com o botão direito do rato e selecione Ver 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.

Causa

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

  • O recurso que está a ser criado é restringido pela política (normalmente, restrições de SKU ou de localização)
  • A implementação está a definir campos que são configurados pela política (comum com etiquetas)

Resolução

Altere o esquema para que não entre em conflito com as políticas nos detalhes do erro. Se esta alteração não for possível, uma opção alternativa é alterar o âmbito da atribuição de política para que o esquema deixe de estar em conflito com a política.

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

Problema

Os parâmetros de esquema que são funções são processados antes de serem transmitidos para artefactos.

Causa

Transmitir um parâmetro de esquema que utiliza uma função, como [resourceGroup().tags.myTag], para um artefacto resulta no resultado processado da função que está a ser definida no artefacto em vez da função dinâmica.

Resolução

Para transmitir uma função como um parâmetro, escape toda a cadeia com [ o aspeto do parâmetro [[resourceGroup().tags.myTag]de esquema . O caráter de escape faz com que o Blueprints trate o valor como uma cadeia ao processar o esquema. Em seguida, o serviço Blueprints coloca a função no artefacto, permitindo que seja dinâmica conforme esperado. Para obter mais informações, veja Sintaxe e expressões nos modelos de Resource Manager do Azure.

Eliminar erros

Cenário: Tempo limite de eliminação da atribuição

Problema

A eliminação de uma atribuição de esquema não é concluída.

Causa

Uma atribuição de esquema pode ficar bloqueada num estado não terminal quando eliminada. Este estado é causado quando os recursos criados pela atribuição do esquema ainda estão pendentes ou não devolvem um código de estado ao Azure Blueprints.

Resolução

As atribuições de esquemas num estado não terminal são marcadas automaticamente como Falha após um tempo limite de seis horas . Assim que o tempo limite tiver ajustado o estado da atribuição do esquema, a eliminação pode ser repetida.

Passos seguintes

Se não vir o problema ou não conseguir resolver o problema, visite um dos seguintes canais para obter mais suporte:

  • Obtenha respostas de especialistas do Azure através dos Fóruns do Azure.
  • Ligue-se ao @AzureSupport – a conta oficial do Microsoft Azure para melhorar a experiência do cliente ao ligar a comunidade do Azure aos recursos certos: respostas, suporte e especialistas.
  • Se precisar de mais ajuda, pode arquivar um incidente de suporte do Azure. Aceda ao site suporte do Azure e selecione Obter Suporte.