Bagikan melalui

Mereferensikan sumber daya yang ada

  • Artikel

Bicep memungkinkan Anda mereferensikan sumber daya yang ada dengan nama uniknya, menggunakan kata kunci yang ada . Sumber daya Microsoft Graph (seperti aplikasi atau grup) yang awalnya dibuat di luar penyebaran file Bicep tidak mungkin memiliki kumpulan properti nama unik mereka. Artikel ini menjelaskan cara mengisi ulang properti nama unik sumber daya ini sehingga dapat disebarkan ulang atau direferensikan dalam file Bicep.

Penting

Microsoft Graph Bicep saat ini dalam PRATINJAU. Lihat Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure untuk persyaratan hukum yang berlaku pada fitur Azure dalam versi beta, pratinjau, atau belum dirilis secara umum.

Prasyarat

  • Pastikan Anda memiliki izin atau peran dengan hak istimewa paling sedikit untuk memperbarui sumber daya yang ada, atau bahwa Anda adalah pemilik sumber daya. Konsultasikan peran dengan hak istimewa paling sedikit berdasarkan tugas dan Izin pengguna default untuk melihat peran apa yang perlu Anda tetapkan.
  • Instal Azure CLI atau Azure PowerShell.

Isi ulang nama unik

Contoh berikut menunjukkan cara mengisi ulang nama unik untuk grup dan aplikasi menggunakan Azure CLI atau Azure PowerShell berikut, dengan asumsi Anda telah masuk.

az rest --method patch --url 'https://graph.microsoft.com/v1.0/groups/<replace-with-ID-of-your-group>' --body '{\"uniqueName\": \"TestGroup-2024-05-10\"}' --headers "content-type=application/json"
az rest --method patch --url 'https://graph.microsoft.com/v1.0/applications/<replace-with-ID-of-your-application>' --body '{\"uniqueName\": \"TestApp-2024-05-10\"}' --headers "content-type=application/json"

Menggunakan sumber daya yang ada di Bicep

  1. Luncurkan Visual Studio Code dan buat dua file baru, main.bicep dan bicepconfig.json, pastikan file tersebut berada di folder yang sama.

  2. Aktifkan beberapa fitur pratinjau dengan mengonfigurasi bicepconfig.json:

  {
      "experimentalFeaturesEnabled": {
      "extensibility": true
      }
  }
  1. Di main.bicep, tambahkan kode Bicep berikut, yang menggunakan existing kata kunci untuk mereferensikan grup dengan nama TestGroup-2024-05-10 uniknya dan aplikasi dengan TestApp-2024-05-10:
  provider microsoftGraph

  @description('Group to use')
  param groupName string = 'TestGroup-2024-05-10'

  @description('App to use')
  param appName string = 'TestApp-2024-05-10'

  resource group 'Microsoft.Graph/groups@v1.0' existing = {
      uniqueName: groupName
  }

  resource application 'Microsoft.Graph/applications@v1.0' existing = {
      uniqueName: appName
  }

  output groupId string = group.id
  output applicationId string = application.id
  1. Menyebarkan file Bicep menggunakan Azure CLI atau Azure PowerShell
  az deployment group create --resource-group exampleRG --template-file main.bicep

  DeploymentName          : main
  ResourceGroupName       : exampleRG
  ProvisioningState       : Succeeded
  Timestamp               : 18/04/2024 16:16:42
  Mode                    : Incremental
  TemplateLink            :
  Parameters              :
                          Name             Type                       Value
                          ===============  =========================  ==========
                          groupName        String                     "TestGroup-2024-05-10"
                          appName          String                     "TestApp-2024-05-10"


  Outputs                 :
                          Name             Type                       Value
                          ===============  =========================  ==========
                          group-id         String                     "<ID-of-your-group>"
                          app-id           String                     "<ID-of-your-app>"

Konten terkait