Como atualizar uma atribuição de blueprint existente
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:
Quando um blueprint é atribuído, a atribuição pode ser atualizada. Há vários motivos para atualizar uma atribuição existente, como:
- Adicionar ou remover um bloqueio de recurso
- Alterar o valor de parâmetros dinâmicos
- Atualizar a atribuição para uma versão Publicada mais recente do blueprint
Atualizando atribuições
Selecione Todos os serviços no painel esquerdo. Pesquise e selecione Blueprints.
Selecione Blueprints atribuídos na página à esquerda.
Na lista de blueprints, clique em atribuição de blueprint. Em seguida use o botão Atualizar atribuição OU selecione e mantenha selecionada (ou clique com o botão direito do mouse) a atribuição de blueprint e escolha Atualizar atribuição.
A página Atribuir blueprint será carregada já preenchida com todos os valores da atribuição original. Você pode alterar a versão de definição do blueprint, o estado Bloquear Atribuição e qualquer um dos parâmetros dinâmicos que existem na definição do blueprint. Selecione Atribuir quando terminar de fazer alterações.
Na página de detalhes de atribuição atualizada, veja o novo status. Neste exemplo, adicionamos Bloqueio à atribuição.
Explore detalhes sobre outras Operações de atribuição usando a lista suspensa. A tabela de Recursos gerenciados é atualizada com a operação de atribuição selecionada.
Regras para atualizar atribuições
A implantação das atribuições atualizadas segue algumas regras importantes. Essas regras determinam o que acontece com os recursos já implantados. A alteração solicitada e o tipo de artefato de recurso que está sendo implantado ou atualizado determinam quais ações são executadas.
- Atribuições de função
- Se a função ou o destinatário da função (usuário, grupo ou aplicativo) for alterado, uma nova atribuição de função será criada. A atribuição de função já implantada permanece em vigor.
- Atribuições de Políticas
- Se os parâmetros da atribuição de política forem alterados, a atribuição existente será atualizada.
- Se a definição da atribuição de política for alterada, uma nova atribuição de política será criada. Atribuições de política implantadas anteriormente são deixadas no lugar.
- Se o artefato de atribuição de política for removido do plano gráfico, implantado atribuições são deixadas no lugar de política.
- Modelos do ARM (modelos do Azure Resource Manager)
- O modelo é processado por meio do Resource Manager como PUT. Como cada tipo de recurso manipula isso de uma forma diferente, examine a documentação de cada recurso incluído para determinar o impacto dessa ação quando executada por blueprints.
Possíveis erros na atualização de atribuições
Ao atualizar atribuições, é possível fazer alterações que falham ao serem executadas. Um exemplo disso é alterar o local de um grupo de recursos depois que ele já foi implantado. É possível fazer qualquer alteração que seja compatível com o Resource Manager, mas qualquer alteração que resulte em erro por meio do Resource Manager também resultará na falha da atribuição.
Não há nenhum limite para o número de vezes que uma atribuição pode ser atualizada. Se ocorrer um erro, determine o erro e faça outra atualização da atribuição. Cenários de erro de exemplo:
- Parâmetro inválido
- Um objeto já existente
- Uma alteração sem suporte do Resource Manager
Próximas etapas
- Saiba mais sobre o ciclo de vida do blueprint.
- Saiba como usar parâmetros estáticos e dinâmicos.
- Saiba como personalizar a ordem de sequenciamento de blueprint.
- Saiba como usar o bloqueio de recurso de blueprint.
- Resolver problemas durante a atribuição de blueprint com solução de problemas gerais.