Verwijzen naar bestaande resources

Met Bicep kunt u verwijzen naar een bestaande resource op basis van de unieke naam, met behulp van het bestaande trefwoord. Microsoft Graph-resources (zoals toepassingen of groepen) die oorspronkelijk buiten een Bicep-bestandsimplementatie zijn gemaakt, hebben waarschijnlijk geen unieke naameigenschap ingesteld. In dit artikel wordt beschreven hoe u de unieke naameigenschap van deze resources kunt doorvoeren, zodat ze opnieuw kunnen worden geïmplementeerd of waarnaar kan worden verwezen in een Bicep-bestand.

Belangrijk

Microsoft Graph Bicep is momenteel in PREVIEW. Raadpleeg de Aanvullende voorwaarden voor Microsoft Azure-previews voor juridische voorwaarden die van toepassing zijn op Azure-functies die in bèta of preview zijn of die anders nog niet algemeen beschikbaar zijn.

Vereisten

• Zorg ervoor dat u over de minst bevoegde machtigingen of rollen beschikt om bestaande resources bij te werken of dat u een eigenaar van de resource bent. Raadpleeg rollen met minimale bevoegdheden per taak en standaardgebruikersmachtigingen om te zien welke rollen u moet toewijzen.
• Installeer Azure CLI of Azure PowerShell.

De unieke naam opnieuw doorvoeren

In het volgende voorbeeld ziet u hoe u een unieke naam voor een groep en een toepassing kunt doorvoeren met behulp van de volgende Azure CLI of Azure PowerShell, ervan uitgaande dat u zich al hebt aangemeld.

Azure-CLI

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"

Azure PowerShell

# Use the id (NOT appId) of the application you want to update
$appUri = 'https://graph.microsoft.com/v1.0/applications/<replace-with-ID-of-your-application>'

# Use the id of the group you want to update
$groupUri = 'https://graph.microsoft.com/v1.0/groups/<replace-with-ID-of-your-group>'

# Create JSON payload to set the immutable uniqueName property
$appPayload = '{"uniqueName":"TestApp-2024-05-10"}'
$groupPayload = '{"uniqueName":"TestGroup-2024-05-10"}'

# Invoke Az REST request in the signed-in user's context
Invoke-AzRestMethod -Uri $appUri -Method PATCH -Payload $appPayload
Invoke-AzRestMethod -Uri $groupUri -Method PATCH -Payload $groupPayload

Een bestaande resource gebruiken in Bicep

1. Start Visual Studio Code en maak twee nieuwe bestanden, main.bicep en bicepconfig.json, en zorg ervoor dat ze zich in dezelfde map bevinden.

2. Schakel enkele preview-functies in door bicepconfig.json te configureren:

  {
      "experimentalFeaturesEnabled": {
      "extensibility": true
      }
  }

3. Voeg in main.bicep de volgende Bicep-code toe, die het existing trefwoord gebruikt om naar de groep te verwijzen op de unieke naam TestGroup-2024-05-10 en de toepassing op TestApp-2024-05-10:

  extension 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

4. Het Bicep-bestand implementeren met behulp van Azure CLI of Azure PowerShell

Azure-CLI

  az deployment group create --resource-group exampleRG --template-file main.bicep

Azure PowerShell

  New-AzResourceGroupDeployment -ResourceGroupName "exampleRG" -TemplateFile ".\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>"

Gerelateerde inhoud

• Unieke benoemde resources