Menggunakan jenis dinamis untuk sumber daya Microsoft Graph Bicep

Ekstensi Microsoft Graph Bicep menggunakan jenis dinamis yang memungkinkan penerapan versi semantik untuk Microsoft Graph beta dan v1.0. Menggunakan jenis dinamis memungkinkan perubahan signifikan di masa mendatang dalam jenis sumber daya Microsoft Graph Bicep, tanpa memengaruhi penyebaran file Bicep Anda yang sudah ada yang menggunakan versi lama dari jenis sumber daya tersebut. Ketika Anda menggunakan tipe dinamis, repositori tipe Microsoft Graph Bicep versi tertentu dirujuk dan diambil dari Registri Artefak Microsoft. Versi jenis ini dipisahkan dari paket NuGet kompiler Bicep.

Ada dua cara untuk mengonfigurasi jenis dinamis baik langsung dalam file main.bicep atau dengan alias versi jenis yang mudah digunakan dalam file bicepconfig.json yang dapat dirujuk dalam file main.bicep.

Pilih versi tipe

Anda perlu menambahkan referensi ke repositori jenis sumber daya Microsoft Graph Bicep dari Registri Artefak Microsoft. Untuk menemukan versi repositori terbaru atau yang sesuai, buka Registri Artefak Microsoft dan cari "Ekstensi Microsoft Graph Bicep". Ada versi untuk Microsoft Graph beta dan v1.0.

Mengonfigurasi jenis dinamis dalam file Bicep

Dalam file main.bicep, Anda dapat merujuk versi repositori tipe Bicep Microsoft Graph yang ingin digunakan, mengganti <v1.0-version> dengan versi tipe yang Anda ingin gunakan untuk Microsoft Graph v1.0.

extension 'br:mcr.microsoft.com/bicep/extensions/microsoftgraph/v1.0:<v1.0-version>'

Anda juga dapat menentukan versi beta dalam file Bicep yang sama lalu menggunakan jenis dari kedua versi.

extension 'br:mcr.microsoft.com/bicep/extensions/microsoftgraph/v1.0:<v1.0-version>'
extension 'br:mcr.microsoft.com/bicep/extensions/microsoftgraph/beta:<beta-version>'

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

// using Microsoft Graph beta
resource app 'Microsoft.Graph/applications@beta' existing = {
    uniqueName: appName
}

Selain itu, dimungkinkan untuk mendeklarasikan sumber daya yang menggunakan versi tipe Bicep yang lebih lama dan lebih baru. Contoh menunjukkan cara menggunakan jenis yang lebih lama dan lebih baru. Ini membedakan antara jenis nama yang sama yang tersedia dalam dua ekstensi impor yang berbeda, dengan menggunakan nama jenis yang sepenuhnya memenuhi syarat:

extension 'br:mcr.microsoft.com/bicep/extensions/microsoftgraph/v1.0:<v1.0-version-latest>' as latestGraphV1
extension 'br:mcr.microsoft.com/bicep/extensions/microsoftgraph/v1.0:<v1.0-version-older>' as olderGraphV1

// using the latest version of the Microsoft Graph v1.0 Bicep types
resource group 'latestGraphV1:Microsoft.Graph/groups@v1.0' existing = {
    uniqueName: groupName
}

// using and older version of the Microsoft Graph v1.0 Bicep types
resource app 'olderGraphV1:Microsoft.Graph/applications@v1.0' existing = {
    uniqueName: appName
}

Mengatur tipe dinamis dalam konfigurasi Bicep

Anda dapat menentukan alias yang mudah digunakan yang merujuk pada versi repo tipe Microsoft Graph Bicep untuk digunakan dalam file bicepconfig.json, mengganti placeholder <v1.0-version> dan <beta-version> dengan versi tipe yang ingin digunakan.

{  
    "experimentalFeaturesEnabled": {  
        "extensibility": true  
    },
    "extensions": {  
        "graphV1": "br:mcr.microsoft.com/bicep/extensions/microsoftgraph/v1.0:<v1.0-version>",
        "graphBeta": "br:mcr.microsoft.com/bicep/extensions/microsoftgraph/beta:<beta-version>"  
    }  
}

Alias tersebut kemudian dapat digunakan dalam file main.bicep saat menentukan ekstensi yang akan digunakan. Seperti yang ditunjukkan, Anda dapat mendeklarasikan penggunaan ekstensi v1.0 dan beta yang memungkinkan Anda untuk mendeklarasikan sumber daya dari Microsoft Graph versi v1.0 dan beta.

extension graphV1
extension graphBeta

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

// using Microsoft Graph beta
resource app 'Microsoft.Graph/applications@beta' existing = {
    uniqueName: appName
}

Catatan

Anda juga dapat mendeklarasikan alias untuk versi jenis yang berbeda dari versi Microsoft Graph yang sama (seperti versi jenis Bicep yang lebih baru dan lebih lama dari Microsoft Graph v1.0) dalam file bicepconfig.json dan mereferensikan alias tersebut dalam file main.bicep saat mengimpor ekstensi dan mendeklarasikan sumber daya menggunakan nama jenis yang sepenuhnya memenuhi syarat.

Migrasi ke menggunakan jenis dinamis dari jenis bawaan

Jenis Microsoft Graph Bicep juga terintegrasi dalam paket NuGet kompilator Bicep. Paket NuGet ini berisi definisi jenis Microsoft Graph untuk Microsoft Graph beta dan v1.0. Jenis bawaan adalah satu-satunya opsi yang tersedia sebelum September 2024.

Penting

Jenis bawaan tidak disarankan untuk digunakan lagi dan akan dihentikan pada 24 Januari 2025. Hingga tanggal pensiun, jenis bawaan, ditandai dengan extension microsoftGraph, akan berdampingan dengan jenis dinamis baru. Setiap perubahan tipe Microsoft Graph Bicep hanya akan tersedia melalui versi baru dari tipe dinamis.

Beralih ke jenis dinamis dari jenis bawaan:

1. Luncurkan Visual Studio Code dan buka folder yang berisi file main.bicep dan bicepconfig.json Anda.

2. Dalam file main.bicep, ada peringatan di bawah microsoftGraph ekstensi bawaan. Arahkan kursor Anda ke atas peringatan untuk melihat detailnya.

   

3. Untuk memperbaiki masalah, pilih tautan Perbaikan Cepat di bagian bawah detail peringatan.