Verwenden dynamischer Typen für Microsoft Graph-Bicep-Ressourcen

Die Microsoft Graph Bicep-Erweiterung unterstützt dynamische Typen, mit denen Sie die semantische Versionsverwaltung sowohl für Microsoft Graph Beta als auch für v1.0 verwenden können. Mit dynamischen Typen können Sie bestimmte Versionen von Microsoft Graph Bicep-Ressourcentypen verwenden, sodass zukünftige Änderungen keine Auswirkungen auf Ihre vorhandenen Bicep-Dateien haben. Wenn Sie dynamische Typen verwenden, ruft Bicep die erforderliche Typversion aus der Microsoft Artifact Registry ab. Diese Typversionen sind unabhängig vom Bicep-Compiler-NuGet-Paket.

Sie können dynamische Typen auf zwei Arten konfigurieren:

• Direkt in der Datei main.bicep.
• Durch das Definieren eines benutzerfreundlichen Versionsaliases in der Datei bicepconfig.json und das Verweisen darauf in main.bicep.

Typversion auswählen

Um Microsoft Graph Bicep-Ressourcentypen zu verwenden, fügen Sie einen Verweis auf das Typen-Repository in der Microsoft Artifact Registry hinzu. Wechseln Sie zur Microsoft Artifact-Registrierung , und suchen Sie nach "Microsoft Graph Bicep-Erweiterung", um die neueste oder erforderliche Version für Microsoft Graph Beta und v1.0 zu finden.

Konfigurieren dynamischer Typen in einer Bicep-Datei

Verweisen Sie in der Datei "main.bicep " auf die gewünschte Repositoryversion von Microsoft Graph Bicep-Typen. Ersetzen Sie die <v1.0-version> Version des Typs Microsoft Graph v1.0, die Sie verwenden möchten.

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

Sie können auch Typen aus beiden Versionen in derselben Datei verwenden:

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

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

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

Deklarieren Sie Ressourcen mit unterschiedlichen Typversionen. Um zwischen Typen mit demselben Namen aus verschiedenen Erweiterungen zu unterscheiden, verwenden Sie einen vollqualifizierten Typnamen:

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

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

// Use an older Microsoft Graph v1.0 Bicep type version
resource app 'olderGraphV1:Microsoft.Graph/applications@v1.0' existing = {
    uniqueName: appName
}

Konfigurieren Sie dynamische Typen in der Bicep-Konfiguration

Definieren Sie benutzerfreundliche Aliase für Microsoft Graph Bicep-Typversionen in bicepconfig.json. Ersetzen <v1.0-version> und <beta-version> mit den gewünschten Versionen.

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

Verwenden Sie als Nächstes diese Aliase in der Datei "main.bicep ":

extension graphV1
extension graphBeta

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

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

Sie können in bicepconfig.json auch Aliase für unterschiedliche Typversionen von derselben Microsoft Graph-Version (z. B. neuere und ältere v1.0-Typen) definieren und in "main.bicep " mit vollqualifizierten Typnamen referenzieren.

Beispiel: in bicepconfig.json

{
    "extensions": {
        "graphV1Latest": "br:mcr.microsoft.com/bicep/extensions/microsoftgraph/v1.0:0.2.0-preview",
        "graphV1Older": "br:mcr.microsoft.com/bicep/extensions/microsoftgraph/v1.0:0.1.8-preview"
    }
}

Als Nächstes in main.bicep:

extension graphV1Latest
extension graphV1Older

// Use the latest Microsoft Graph v1.0 Bicep types
resource group 'graphV1Latest:Microsoft.Graph/groups@v1.0' existing = {
    uniqueName: groupName
}

// Use an older Microsoft Graph v1.0 Bicep type version
resource app 'graphV1Older:Microsoft.Graph/applications@v1.0' existing = {
    uniqueName: appName
}