Quickstart: Defina e atribua um plano no portal

Importante

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

• Policy
• RBAC
• Implantações

Neste tutorial, aprende a usar o Azure Blueprints para realizar algumas das tarefas comuns relacionadas com criar, publicar e atribuir um blueprint dentro da sua organização. Esta competência ajuda-o a definir padrões comuns para desenvolver configurações reutilizáveis e rapidamente implantáveis, baseadas em modelos, políticas e segurança do Azure Resource Manager (ARM).

Pré-requisitos

• Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.
• Para criar blueprints, a sua conta precisa das seguintes permissões:
  • Microsoft.Blueprint/blueprints/write - Criar uma definição de blueprint
  • Microsoft.Blueprint/blueprints/artefacts/write - Criar artefactos numa definição de blueprint
  • Microsoft.Blueprint/blueprints/versions/write - Publicar um blueprint

Criar um plano

O primeiro passo para definir um padrão padrão de conformidade é compor um plano a partir dos recursos disponíveis. Vamos criar um blueprint chamado MyBlueprint para configurar as atribuições de funções e políticas para a subscrição. Depois adiciona-se um grupo de recursos, um modelo ARM e uma atribuição de funções ao grupo de recursos.

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

2. Selecione definições de Blueprint e depois selecione + Criar blueprint.

   

   Ou, selecione Começar>Criar para ir diretamente criar um projeto.

3. Selecione Começar com modelo em branco a partir do cartão no topo da lista de modelos integrados.

4. Forneça um nome de planta, como MyBlueprint. (Pode usar até 48 letras e números, mas sem espaços ou caracteres especiais.) Deixa a descrição do Plano em branco por agora.

5. Na caixa de localização de Definição , selecione a elipse à direita. Depois seleciona o grupo de gestão ou subscrição onde queres guardar o blueprint e escolhe Selecionar.

6. Verifique se a informação está correta. Os campos de nome do Esquema e da localização da Definição não podem ser alterados posteriormente. Depois seleciona Próximo: Artefactos no final da página, ou o separador Artefactos no topo da página.

7. Adicione uma atribuição de função ao nível da subscrição:

   1. Em Subscrição, selecione + Adicionar artefacto. A janela de adicionar artefactos abre-se do lado direito do navegador.

   2. Para o tipo de Artefacto, selecione Atribuição de Funções.

   3. Para Papel, selecione Contribuidor. Deixe a caixa Adicionar utilizador, aplicação ou grupo com a caixa de seleção que indica um parâmetro dinâmico.

   4. Selecione Adicionar para adicionar este artefacto ao blueprint.

   

   Observação

   A maioria dos artefactos suporta parâmetros. Um parâmetro atribuído a um valor durante a criação do blueprint é um parâmetro estático. Se o parâmetro for atribuído durante a atribuição do blueprint, é um parâmetro dinâmico. Para mais informações, consulte parâmetros Blueprint.

8. Adicione uma atribuição de política ao nível da subscrição:

   1. No artefacto de atribuição de funções, selecione + Adicionar artefacto.

   2. Para o tipo de artefacto, selecione atribuição de política.

   3. Muda o tipo para incorporado. Na Pesquisa, introduza a tag.

   4. Mude o foco da Pesquisa para que o filtro ocorra. Selecione Adicionar uma etiqueta e o seu valor a grupos de recursos.

   5. Selecione Adicionar para adicionar este artefacto ao blueprint.

9. Selecione a linha da atribuição de políticas Anexe uma etiqueta e o seu valor a grupos de recursos.

10. Abre-se a janela para fornecer parâmetros ao artefacto como parte da definição do blueprint. Pode definir os parâmetros para todas as atribuições (parâmetros estáticos) com base neste blueprint, em vez de durante a atribuição (parâmetros dinâmicos). Este exemplo usa parâmetros dinâmicos durante a atribuição do blueprint, por isso deixa os valores definidos e seleciona Cancelar.

11. Adicione um grupo de recursos ao nível da subscrição:

    1. Em Subscrição, selecione + Adicionar artefacto.

    2. Para o tipo de Artefacto, selecione Grupo de Recursos.

    3. Deixe as caixas de Nome de Apresentação do Artefacto, Nome do Grupo de Recursos e Localização em branco. Certifica-te de que a caixa de verificação para cada propriedade de parâmetro está assinalada para os tornar parâmetros dinâmicos.

    4. Selecione Adicionar para adicionar este artefacto ao blueprint.

12. Adicione um modelo no grupo de recursos:

    1. Em ResourceGroup, selecione + Adicionar artefato.

    2. Para o tipo de artefacto, selecione modelo do Gestor de Recursos do Azure. Defina o nome de exibição do Artefacto para StorageAccount e deixe a Descrição em branco.

    3. No separador Template da caixa de editor, cole o seguinte template ARM. Depois de colar o modelo, selecione o separador Parâmetros e note que os parâmetros storageAccountType do modelo e location foram detetados. Cada parâmetro era automaticamente detetado e preenchido, mas configurado como um parâmetro dinâmico.

       Importante

       Se estiveres a importar o modelo, certifica-te de que o ficheiro é apenas JSON e não inclui HTML. Quando estiver a apontar para um URL no GitHub, certifique-se de que selecionou RAW para obter o ficheiro JSON puro, e não o que está embrulhado com HTML para exibição no GitHub. Ocorre um erro se o template importado não for puramente JSON.

       {
           "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
           "contentVersion": "1.0.0.0",
           "parameters": {
               "storageAccountType": {
                   "type": "string",
                   "defaultValue": "Standard_LRS",
                   "allowedValues": [
                       "Standard_LRS",
                       "Standard_GRS",
                       "Standard_ZRS",
                       "Premium_LRS"
                   ],
                   "metadata": {
                       "description": "Storage Account type"
                   }
               },
               "location": {
                   "type": "string",
                   "defaultValue": "[resourceGroup().location]",
                   "metadata": {
                       "description": "Location for all resources."
                   }
               }
           },
           "variables": {
               "storageAccountName": "[concat('store', uniquestring(resourceGroup().id))]"
           },
           "resources": [{
               "type": "Microsoft.Storage/storageAccounts",
               "name": "[variables('storageAccountName')]",
               "location": "[parameters('location')]",
               "apiVersion": "2018-07-01",
               "sku": {
                   "name": "[parameters('storageAccountType')]"
               },
               "kind": "StorageV2",
               "properties": {}
           }],
           "outputs": {
               "storageAccountName": {
                   "type": "string",
                   "value": "[variables('storageAccountName')]"
               }
           }
       }
       

    4. Desmarque a caixa de seleção storageAccountType e note que a lista suspensa contém apenas os valores incluídos no modelo ARM em . Selecione a caixa para voltar a definir um parâmetro dinâmico.

    5. Selecione Adicionar para adicionar este artefacto ao blueprint.

    

13. O seu plano completo deve parecer semelhante ao seguinte. Na coluna Parâmetros, note que cada artefacto tem x de y parâmetros preenchidos. Os parâmetros dinâmicos são definidos em cada atribuição do projeto.

    

14. Agora que adicionou todos os artefactos planeados, selecione Guardar Rascunho no final da página.

Editar um plano

No Criar um blueprint, não forneceu uma descrição nem adicionou a atribuição de função ao novo grupo de recursos. Pode corrigir ambos seguindo estes passos:

1. Selecione definições de Blueprint na página à esquerda.

2. Na lista de blueprints, selecione e mantenha pressionado (ou clique com o botão direito) aquele que criou anteriormente. Depois, seleciona Editar o blueprint.

3. Na descrição do Blueprint, forneça alguma informação sobre o blueprint e os artefactos que o compõem. Neste caso, introduza algo como: Este blueprint define a política de etiquetas e a atribuição de funções na subscrição, cria um ResourceGroup e implementa um modelo de recursos e atribuição de funções a esse ResourceGroup.

4. Selecione Próximo: Artefactos no final da página, ou o separador Artefactos no topo da página.

5. Adicione uma atribuição de função no grupo de recursos:

   1. Em ResourceGroup, selecione + Adicionar artefato.

   2. Para o tipo de Artefacto, selecione Atribuição de Funções.

   3. Em Função, selecione Proprietário e despeje a caixa de seleção na caixa Adicionar utilizador, aplicação ou grupo.

   4. Procure e selecione um utilizador, aplicação ou grupo para adicionar. Este artefacto utiliza um conjunto de parâmetros estáticos, o mesmo em todas as atribuições deste blueprint.

   5. Selecione Adicionar para adicionar este artefacto ao blueprint.

   

6. O seu plano completo deve parecer semelhante ao seguinte. Note que a nova atribuição de função adicionada mostra que 1 em cada 1 parâmetros estão preenchidos. Isso significa que é um parâmetro estático.

   

7. Selecione Guardar Rascunho agora que foi atualizado.

Publique um plano

Agora que adicionou todos os artefactos planeados ao projeto, está na altura de o publicar. A publicação disponibiliza o blueprint para ser associado a uma subscrição.

1. Selecione definições de Blueprint na página à esquerda.

2. Na lista de projetos, selecione e mantenha pressionado (ou clique com o botão direito) o que criou anteriormente. Depois selecione Publicar plano.

3. No painel que se abre, fornece uma Versão (letras, números e hífenes com um comprimento máximo de 20 caracteres), como v1. Opcionalmente, introduza texto nas notas de Alteração, como Primeira publicação.

4. Selecione Publicar no final da página.

Atribuir um plano

Depois de publicar um blueprint, pode atribuí-lo a uma subscrição. Atribui o blueprint que criaste a uma das subscrições na hierarquia do teu grupo de gestão. Se o blueprint for guardado numa subscrição, só pode ser atribuído a essa subscrição.

1. Selecione definições de Blueprint na página à esquerda.

2. Na lista de blueprints, selecione e mantenha pressionado (ou clique com o botão direito) o que criou anteriormente (ou selecione a reticente). Depois selecionar Atribuir plano.

3. Na página Atribuir blueprint , na lista suspensa de Subscrição , selecione as subscrições para as quais pretende implementar este blueprint.

   Se existirem ofertas Enterprise suportadas disponíveis pelo Azure Billing, é ativado um link Criar novo na caixa de Subscrição . Siga estes passos:

   1. Selecione o Criar novo link para criar uma nova subscrição em vez de selecionar as já existentes.

   2. Para Nome de visualização, insira um nome para a nova subscrição.

   3. Para a Oferta, selecione a oferta disponível da lista suspensa.

   4. Para grupo de gestão, clique no ícone de reticências para escolher o grupo de gestão ao qual a subscrição será subordinada.

   5. Selecione Criar no final da página.

      

      Importante

      A nova subscrição é criada imediatamente após selecionar Criar.

   Observação

   É criada uma atribuição para cada subscrição que escolher. Pode fazer alterações a uma única atribuição de subscrição mais tarde, sem forçar alterações ao restante das subscrições selecionadas.

4. Para o nome da tarefa, forneça um nome único para esta tarefa.

5. Em Localização, selecione uma região para a identidade gerida e o objeto de implementação por subscrição a serem criados. O Azure Blueprints usa essa identidade gerenciada para implantar todos os artefatos no blueprint atribuído. Para saber mais, consulte Identidades gerenciadas para recursos do Azure.

6. Para a seleção da lista suspensa de versões da definição do Blueprint na opção de Publicadas, mantenha a entrada v1 como está. (O padrão é a versão mais recentemente publicada.)

7. Para a Atribuição de Bloqueio, deixe o padrão de Não Trancar. Para mais informações, consulte bloqueio de recursos de Blueprints.

   

8. Em Identidade Gerida, deixe o padrão de Sistema atribuído.

9. Para a atribuição de funções ao nível de subscrição [Grupo de utilizadores ou nome da aplicação]: Contribuidor, pesquise e selecione um utilizador, aplicação ou grupo.

10. Para a atribuição de política ao nível de subscrição, defina o Nome da Etiqueta para CostCenter e defina o Valor da Etiquetapara ContosoIT.

11. Para o ResourceGroup, forneça o nome StorageAccount e escolha a localização East US 2 da lista suspensa.

    Observação

    Para cada artefacto que adicionaste no grupo de recursos durante a definição do blueprint, esse artefacto é indentado para se alinhar com o grupo de recursos ou objeto onde o vais implementar. Artefactos que não aceitam parâmetros, ou que não têm parâmetros definidos na atribuição, são listados apenas para informação contextual.

12. No modelo ARM StorageAccount, selecione Standard_GRS para o parâmetro storageAccountType .

13. Leia a caixa de informação no final da página e depois selecione Atribuir.

Rastreio da implementação de um plano

Quando atribui um blueprint a uma ou mais subscrições, acontecem duas coisas:

• O plano é adicionado à página Blueprints Atribuídos para cada subscrição.
• Começa o processo de implantação de todos os artefactos definidos pelo projeto.

Agora que atribuiu o blueprint a uma subscrição, verifique o progresso da implementação:

1. Selecione Planos atribuídos na página do lado esquerdo.

2. Na lista de blueprints, selecione e mantenha pressionado (ou clique com o botão direito) aquele que atribuiu anteriormente. Depois seleciona Ver detalhes da atribuição.

   

3. Na página de atribuição do Blueprint , valide que todos os artefactos foram implementados com sucesso e que não houve erros durante a implementação. Se ocorreram erros, consulte Blueprints de Resolução de Problemas para os passos a determinar o que correu mal.

Limpeza de recursos

Desatribuir um projeto

Se já não precisar de atribuir um modelo, remova-o de uma subscrição. O plano pode ter sido substituído por um projeto mais recente com padrões, políticas e designs atualizados. Quando um modelo é removido, os artefatos atribuídos como parte desse modelo são deixados para trás. Para remover uma atribuição de modelo, siga estes passos:

1. Selecione Planos atribuídos na página do lado esquerdo.

2. Na lista de blueprints, seleciona o blueprint que queres desatribuir. Depois seleciona Desatribuir blueprint no topo da página.

3. Lê a mensagem de confirmação e depois seleciona OK.

Apagar um plano

1. Selecione definições de Blueprint na página à esquerda.

2. Clique com o botão direito no blueprint que pretende eliminar e selecione Delete blueprint. Depois seleciona Sim na caixa de diálogo de confirmação.

Observação

Eliminar um projeto desta forma também elimina todas as versões publicadas do projeto selecionado. Para eliminar uma única versão, abra o blueprint e selecione o separador Versões Publicadas . Depois seleciona a versão que queres eliminar e depois seleciona Eliminar Esta Versão. Além disso, não podes apagar um plano até teres eliminado todas as atribuições dessa definição de plano.

Próximos passos

Neste início rápido, criou, atribuiu e removeu um blueprint com o Azure portal. Para saber mais sobre os Blueprints do Azure, continue para o artigo sobre o ciclo de vida dos blueprints.

Saiba mais sobre o ciclo de vida do blueprint