Modelos de bíceps para recursos do Microsoft Graph

Os modelos Bicep 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 em todo o ciclo de vida de desenvolvimento para implantar repetidamente sua infraestrutura. O arquivo usa a linguagem Bicep , uma DSL (linguagem específica de domínio) 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 em que o aplicativo Web é 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 do Microsoft Graph e os recursos da entidade de serviço em um arquivo Bicep, em vez de criá-los manualmente com antecedência. No mesmo arquivo, você pode definir os recursos do aplicativo lógico e do aplicativo Web. Em seguida, você pode implantar repetidamente o arquivo em todo o ciclo de vida de desenvolvimento e ter certeza de que todos os recursos do Azure e do Microsoft Graph são implantados de forma consistente.

Importante

O Microsoft Graph Bicep está atualmente em versão prévia. Veja os Termos de Uso Complementares para Versões Prévias do Microsoft Azure para obter termos legais que se aplicam aos recursos do Azure que estão em versão beta, versão prévia ou que, de outra forma, ainda não foram lançados em disponibilidade geral.

Extensão do Microsoft Graph Bicep

O Bicep foi originalmente criado para fornecer uma experiência de criação aprimorada em modelos JSON do Azure Resource Manager, para implantação e gerenciamento de recursos do Azure. A extensibilidade do Bicep estende a funcionalidade 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 Bicep do Microsoft Graph permite que você crie, implante e gerencie um conjunto limitado de recursos do Microsoft Graph (atualmente recursos de ID do Microsoft Entra) em arquivos de modelo 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 IaC (infraestrutura como código) 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 Bicep do Microsoft Graph

• Experiência de criação: você obtém a mesma experiência de criação de primeira classe com suporte na Extensão Bicep para VS Code ao usá-la 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 de API beta e v1.0: a extensão Bicep do Microsoft Graph permite que você faça referência às versões beta e v1.0 de tipos de recursos do Microsoft Graph com suporte no mesmo arquivo Bicep.

• Resultados repetidos: Implante repetidamente sua infraestrutura em todo seu ciclo de vida de desenvolvimento e com a confiança de que seus recursos são implantados em um estado 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 represente o estado desejado, em vez de desenvolver vários 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 dos 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. Uma assinatura válida do Azure é necessária, se também estiver implantando recursos do Azure.

Introdução

Experimente 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.

Saiba mais

Saiba mais com a comunidade

Você pode saber mais sobre a extensibilidade do Bicep e como gerenciar objetos do Microsoft Entra declarativamente no Treinamento técnico de John Savill no YouTube. Esse 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 Bicep.

Saiba mais sobre o Microsoft Graph

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

Explorar os tipos de bíceps do Microsoft Graph

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