Microsoft Graph Bicep kaynakları için dinamik türler kullanma

Microsoft Graph Bicep uzantısı, hem Microsoft Graph beta hem de v1.0 için anlamsal sürüm oluşturma olanağı sağlayan dinamik türler kullanır. Dinamik türlerin kullanılması, söz konusu kaynak türlerinin eski sürümlerini kullanan mevcut Bicep dosyalarınızın dağıtımını etkilemeden mevcut Microsoft Graph Bicep kaynak türlerinde gelecekteki hataya neden olan değişikliklere olanak tanır. Dinamik türleri kullandığınızda, belirli bir sürüme sahip Microsoft Graph Bicep türleri deposuna başvurulur ve Microsoft Yapıt Kayıt Defteri getirilir. Bu tür sürümler Bicep derleyicisi NuGet paketinden ayrılmıştır.

Dinamik türleri doğrudan main.bicep dosyasının içinde veya bicepconfig.json dosyasındaki bir kullanıcı dostu tür sürüm diğer adıyla yapılandırmanın iki yolu vardır ve bu yöntem main.bicep dosyasında başvurulabilir.

Tür sürümü seçme

Microsoft Yapıt Kayıt Defteri Microsoft Graph Bicep kaynak türleri deposuna bir başvuru eklemeniz gerekir. En son veya uygun depo sürümünü bulmak için Microsoft Yapıt Kayıt Defteri gidin ve "Microsoft Graph Bicep Uzantısı" araması yapın. Hem Microsoft Graph beta hem de v1.0 sürümleri vardır.

Bicep dosyasında dinamik türleri yapılandırma

main.bicep dosyasında, kullanılacak Microsoft Graph Bicep türleri deposu sürümüne başvurabilir ve yer tutucuyu <v1.0-version> Microsoft Graph v1.0 için kullanmak istediğiniz tür sürümüyle değiştirebilirsiniz.

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

Ayrıca, aynı Bicep dosyasında bir beta sürümü belirtebilir ve ardından her iki sürümdeki türleri kullanabilirsiniz.

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
}

Ayrıca, daha eski ve daha yeni Bicep türü sürümleri kullanan kaynakları bildirmek de mümkündür. Örnek, daha eski ve daha yeni bir türün nasıl kullanılacağını gösterir. Tam tür adı kullanarak, içeri aktarılan iki farklı uzantıda kullanılabilen aynı ada sahip bir tür arasında ayrımlar oluşturur:

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
}

Bicep yapılandırmasında dinamik türleri yapılandırma

ve <beta-version> yer tutucularını kullanmak istediğiniz tür sürümleriyle değiştirerek <v1.0-version> bicepconfig.json dosyasında kullanmak üzere Microsoft Graph Bicep türleri deposu sürümüne başvuran kullanıcı dostu bir diğer ad belirtebilirsiniz.

{  
    "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>"  
    }  
}

Bu diğer adlar, kullanılacak uzantı belirtilirken main.bicep dosyasında kullanılabilir. Gösterildiği gibi, Microsoft Graph v1.0 ve Microsoft Graph beta sürümlerinden kaynak bildirmenizi sağlayan bir v1.0 ve beta uzantısının kullanımını bildirebilirsiniz.

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
}

Yerleşik türlerden dinamik türleri kullanmaya geçiş

Microsoft Graph Bicep türleri, Bicep derleyicisi NuGet paketinde de yerleşik olarak bulunur. Bu NuGet paketi hem Microsoft Graph beta hem de v1.0 için Microsoft Graph türü tanımları içerir. Yerleşik türler, Eylül 2024'e kadar kullanılabilen tek seçenekti.

Yerleşik türlerden dinamik türlere geçin:

1. VS Code'ı başlatın ve main.bicep ve bicepconfig.json dosyalarınızı içeren klasörü açın.

2. main.bicep dosyasında, yerleşik uzantının microsoftGraph altında bir uyarı vardır. Ayrıntıları görmek için imlecinizi uyarının üzerine getirin.

   

3. Sorunu düzeltmek için uyarı ayrıntılarının altındaki Hızlı Düzeltme bağlantısını seçin.