Modelos de bíceps para recursos do Microsoft Graph

Os modelos de bíceps para recursos do Microsoft Graph permitem que você defina a infraestrutura de locatário que deseja implantar, como grupos ou aplicativos, em um arquivo e, em seguida, use o arquivo durante todo o ciclo de vida de desenvolvimento para implantar repetidamente sua infraestrutura. O arquivo usa a linguagem Bicep, uma linguagem específica de domínio (DSL) que usa sintaxe declarativa para implantar recursos, normalmente para sua infraestrutura como soluções de código.

Suponha que você queira chamar APIs personalizadas dos Aplicativos Lógicos do Azure onde o aplicativo Web está protegido usando a ID do Microsoft Entra. Para criar as duas identidades de aplicativo para o aplicativo lógico e o aplicativo Web, você pode definir o aplicativo Microsoft Graph e os recursos da entidade de serviço em um arquivo Bicep, em vez de criá-los manualmente previamente. No mesmo arquivo, você pode definir o aplicativo lógico e os recursos do aplicativo Web. Em seguida, você pode implantar repetidamente o arquivo durante todo o ciclo de vida de desenvolvimento e ter confiança de que todos os seus recursos do Azure e do Microsoft Graph são implantados de forma consistente.

Importante

O Microsoft Graph Bicep está atualmente em pré-visualização. Veja Termos de Utilização Complementares da Pré-visualizações do Microsoft Azure para obter os termos legais que se aplicam às funcionalidades do Azure que estão na versão beta, na pré-visualização ou que ainda não foram lançadas para disponibilidade geral.

Extensão Microsoft Graph Bicep

O Bicep foi originalmente criado para fornecer uma experiência de criação aprimorada sobre os modelos JSON do Azure Resource Manager, para implantação e gerenciamento de recursos do Azure. A extensibilidade do Bicep estende a capacidade original, permitindo que os modelos do Bicep façam referência a recursos fora do Azure Resource Manager.

Usando a extensibilidade do Bicep, a nova extensão do Microsoft Graph Bicep permite que você crie, implante e gerencie um conjunto limitado de recursos do Microsoft Graph (atualmente recursos do Microsoft Entra ID) em arquivos de modelo do Bicep, juntamente com os recursos do Azure.

• Os clientes do Azure podem usar ferramentas familiares para implantar recursos do Azure junto com os recursos do Microsoft Graph dos quais dependem, como aplicativos e entidades de serviço, usando a infraestrutura como código (IaC) e práticas de DevOps.
• Ele também abre a porta para que os clientes existentes do Microsoft Graph usem modelos Bicep e práticas de IaC para implantar e gerenciar os recursos de seus locatários.

Benefícios da extensão Microsoft Graph Bicep

• Experiência de criação: você obtém a mesma experiência de criação de primeira classe que é suportada na extensão Bicep para VS Code quando a usa para criar seus arquivos Bicep. O editor fornece segurança de tipo avançada, intellisense e validação de sintaxe.

  

  Você também pode criar arquivos Bicep no Visual Studio com a extensão Bicep para Visual Studio.

• Suporte para versões beta e v1.0 API: A extensão Microsoft Graph Bicep permite que você faça referência às versões beta e v1.0 dos tipos de recursos suportados do Microsoft Graph dentro do mesmo arquivo Bicep.

• Resultados repetíveis: implante repetidamente sua infraestrutura durante todo o ciclo de vida de desenvolvimento e tenha confiança de que seus recursos serão implantados de maneira consistente. Os arquivos Bicep são idempotentes, o que significa que você pode implantar o mesmo arquivo muitas vezes e obter os mesmos tipos de recursos no mesmo estado. Você pode desenvolver um arquivo que representa o estado desejado, em vez de desenvolver muitos arquivos separados para representar atualizações.

• Orquestração: Você não precisa se preocupar com as complexidades das operações de ordenação. O Resource Manager orquestra a implantação de recursos interdependentes para que eles sejam criados na ordem correta. Quando possível, o Resource Manager implanta recursos em paralelo para que suas implantações sejam concluídas mais rapidamente do que as implantações seriais. Você implanta o arquivo por meio de um comando, em vez de vários comandos imperativos.

Requisitos de licença

A implantação de recursos do Microsoft Graph usando o Bicep requer todas as licenças necessárias para trabalhar com os recursos do Microsoft Graph que você está implantando. É necessária uma subscrição válida do Azure, se também estiver a implementar quaisquer recursos do Azure.

Começar agora

Experimente o seu primeiro início rápido

Comece instalando as ferramentas do Bicep e, em seguida, prossiga para criar e implantar seu primeiro arquivo Bicep contendo recursos do Microsoft Graph em minutos.

Mais informações

Saiba mais com a comunidade

Você pode aprender mais sobre a extensibilidade do Bicep e como gerenciar objetos do Microsoft Entra declarativamente no treinamento técnico da John Savill no YouTube. Este recurso é fornecido pela comunidade e não é mantido oficialmente pela Microsoft.

Saiba mais sobre o Bicep

1. Entenda o Bicep, seus usos e a estrutura e sintaxe dos arquivos Bicep.
2. Explore os módulos do Learn para o Bicep.

Saiba mais sobre o Microsoft Graph

1. Saiba mais sobre o Microsoft Graph.
2. Compreender os princípios de autenticação e autorização no Microsoft Graph.
3. Experimente os tutoriais do Microsoft Graph.

Explore os tipos de Microsoft Graph Bicep

Para saber mais sobre os tipos de Microsoft Graph Bicep que estão disponíveis para uso em seus arquivos Bicep, consulte Referência de recursos do Microsoft Graph Bicep.