Поделиться через

Ссылки на существующие ресурсы

  • Статья

Bicep позволяет ссылаться на существующий ресурс по уникальному имени, используя существующий ключевое слово. Ресурсы Microsoft Graph (например, приложения или группы), созданные за пределами развертывания файлов Bicep, вряд ли имеют уникальный набор свойств имени. В этой статье описывается, как заполнить уникальное свойство имен этих ресурсов, чтобы их можно было повторно развернуть или ссылаться в Bicep-файле.

Внимание

Microsoft Graph Bicep в настоящее время находится в предварительной версии. Юридические условия, применимые к функциям Azure, которые находятся в состоянии бета-версии, предварительной версии или иным образом еще не выпущены в общедоступной версии, см. на странице Дополнительные условия использования предварительных версий в Microsoft Azure.

Необходимые компоненты

  • Убедитесь, что у вас есть наименее привилегированные разрешения или роли для обновления существующих ресурсов или того, что вы являетесь владельцем ресурса. Ознакомьтесь с наименее привилегированными ролями по задачам и разрешениям пользователей по умолчанию, чтобы узнать, какие роли необходимо назначить.
  • Установите Azure CLI или Azure PowerShell.

Резервное заполнение уникального имени

В следующем примере показано, как заполнить уникальное имя группы и приложения с помощью следующего Интерфейса командной строки Azure или Azure PowerShell, если вы уже вошли в систему.

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"

Использование существующего ресурса в Bicep

  1. Запустите Visual Studio Code и создайте два новых файла, main.bicep и bicepconfig.json, убедившись, что они находятся в одной папке.

  2. Включите некоторые функции предварительной версии, настроив bicepconfig.json:

  {
      "experimentalFeaturesEnabled": {
      "extensibility": true
      }
  }
  1. В main.bicep добавьте следующий код Bicep, который использует existing ключевое слово для ссылки на группу по уникальному имени TestGroup-2024-05-10 и приложению: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
  1. Развертывание Bicep-файла с помощью Azure CLI или Azure PowerShell
  az deployment group create --resource-group exampleRG --template-file 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>"

Связанный контент