Dynamische typen gebruiken voor Microsoft Graph Bicep-resources

De Microsoft Graph Bicep-extensie maakt gebruik van dynamische typen waarmee semantische versiebeheer mogelijk is voor zowel Microsoft Graph beta als v1.0. Met dynamische typen kunnen toekomstige wijzigingen in bestaande Microsoft Graph Bicep-resourcetypen worden gewijzigd zonder dat dit van invloed is op de implementatie van uw bestaande Bicep-bestanden die gebruikmaken van oudere versies van deze resourcetypen. Wanneer u dynamische typen gebruikt, wordt er naar een specifieke opslagplaats voor Microsoft Graph Bicep-typen verwezen en opgehaald uit de Microsoft-artefactregister. Deze typeversies worden losgekoppeld van het Bicep-compiler NuGet-pakket.

Er zijn twee manieren om dynamische typen rechtstreeks in het bestand main.bicep te configureren of met een gebruiksvriendelijke versiealias in het bicepconfig.json-bestand waarnaar kan worden verwezen in het bestand main.bicep .

Een typeversie kiezen

U moet vanuit de Microsoft-artefactregister een verwijzing toevoegen naar de resourcetypen van Microsoft Graph Bicep. Als u de meest recente of juiste opslagplaatsversie wilt vinden, gaat u naar de Microsoft-artefactregister en zoekt u naar 'Microsoft Graph Bicep Extension'. Er zijn versies voor zowel Microsoft Graph beta als v1.0.

Dynamische typen configureren in een Bicep-bestand

In het bestand main.bicep kunt u verwijzen naar de versie van de Microsoft Graph Bicep-typen die u wilt gebruiken, waarbij u de <v1.0-version> tijdelijke aanduiding vervangt door de typeversie die u wilt gebruiken voor Microsoft Graph v1.0.

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

U kunt ook een bètaversie opgeven in hetzelfde Bicep-bestand en vervolgens typen van beide versies gebruiken.

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
}

Daarnaast is het mogelijk om resources te declareren die gebruikmaken van oudere en nieuwere Bicep-typeversies. In het voorbeeld ziet u hoe u een ouder en nieuwer type gebruikt. Er wordt onderscheid gemaakt tussen een type van dezelfde naam dat beschikbaar is in twee verschillende geïmporteerde extensies, met behulp van een volledig gekwalificeerde typenaam:

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
}

Dynamische typen configureren in de Bicep-configuratie

U kunt een gebruiksvriendelijke alias opgeven die verwijst naar de opslagplaatsversie van Microsoft Graph Bicep die moet worden gebruikt in het bicepconfig.json-bestand , waarbij u de <v1.0-version> tijdelijke <beta-version> aanduidingen vervangt door de typeversies die u wilt gebruiken.

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

Deze aliassen kunnen vervolgens worden gebruikt in een main.bicep-bestand bij het opgeven van de extensie die moet worden gebruikt. Zoals wordt weergegeven, kunt u het gebruik van een v1.0- en bèta-extensie declareren waarmee u resources kunt declareren uit Microsoft Graph v1.0- en Microsoft Graph beta-versies.

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
}

Migreren naar het gebruik van dynamische typen van ingebouwde typen

Microsoft Graph Bicep-typen zijn ook ingebouwd in het NuGet-pakket bicep-compiler. Dit NuGet-pakket bevat Microsoft Graph-typedefinities voor zowel Microsoft Graph beta als v1.0. Ingebouwde typen waren de enige optie die beschikbaar was voor september 2024.

Schakel over naar dynamische typen van ingebouwde typen:

1. Start VS Code en open de map met uw bestanden main.bicep en bicepconfig.json .

2. In het bestand main.bicep wordt een waarschuwing weergegeven onder de microsoftGraph ingebouwde extensie. Beweeg de muisaanwijzer over de waarschuwing om de details te zien.

   

3. Als u het probleem wilt oplossen, selecteert u de koppeling Snelle oplossing onderaan de waarschuwingsdetails.