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


Центры разработки Microsoft.DevCenter

Определение ресурсов Bicep

Тип ресурса devcenters можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.DevCenter/devcenters, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.DevCenter/devcenters@2025-02-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    devBoxProvisioningSettings: {
      installAzureMonitorAgentEnableStatus: 'string'
    }
    displayName: 'string'
    encryption: {
      customerManagedKeyEncryption: {
        keyEncryptionKeyIdentity: {
          delegatedIdentityClientId: 'string'
          identityType: 'string'
          userAssignedIdentityResourceId: 'string'
        }
        keyEncryptionKeyUrl: 'string'
      }
    }
    networkSettings: {
      microsoftHostedNetworkEnableStatus: 'string'
    }
    projectCatalogSettings: {
      catalogItemSyncEnableStatus: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Значения свойств

CustomerManagedKeyEncryption

Имя Описание Ценность
keyEncryptionKeyIdentity Все настройки удостоверений для параметров ключей, управляемых клиентом, определяют, какое удостоверение следует использовать для проверки подлинности в Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl URL-адрес ключа шифрования ключей, версия или не версия. Например, https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 или https://contosovault.vault.azure.net/keys/contosokek. струна

CustomerManagedKeyEncryptionKeyIdentity

Имя Описание Ценность
delegatedIdentityClientId Делегированное удостоверение, используемое для доступа к URL-адресу ключа шифрования ключей. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<группы ресурсов>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Взаимоисключающая с identityType systemAssignedIdentity и userAssignedIdentity — только внутреннее использование. струна

Ограничения целостности:
Минимальная длина = 36
Максимальная длина = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType Значения могут быть systemAssignedIdentity или userAssignedIdentity "delegatedResourceIdentity"
SystemAssignedIdentity
UserAssignedIdentity
userAssignedIdentityResourceId назначаемое пользователем удостоверение для доступа к url-адресу ключа шифрования ключей. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<группы ресурсов>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Взаимоисключающая с identityType systemAssignedIdentity и делегатомResourceIdentity. струна

DevBoxProvisioningSettings

Имя Описание Ценность
installAzureMonitorAgentEnableStatus Можно ли настроить каталоги проектов, связанные с проектами в этом центре разработки, для синхронизации элементов каталога. "Отключено"
"Включено"

DevCenterNetworkSettings

Имя Описание Ценность
microsoftHostedNetworkEnableStatus Указывает, могут ли пулы в этом Центре разработки использовать размещенные сети Майкрософт. Значение по умолчанию включено, если не задано. "Отключено"
"Включено"

DevCenterProjectCatalogSettings

Имя Описание Ценность
catalogItemSyncEnableStatus Можно ли настроить каталоги проектов, связанные с проектами в этом центре разработки, для синхронизации элементов каталога. "Отключено"
"Включено"

DevCenterProperties

Имя Описание Ценность
devBoxProvisioningSettings Параметры, используемые в подготовке всех модулей Dev Box, принадлежащих этому центру разработки. DevBoxProvisioningSettings
displayName Отображаемое имя центра разработки. струна
шифрование Параметры шифрования, используемые для шифрования на стороне сервера для закрытого содержимого (например, каталоги, журналы, настройки). шифрования
networkSettings Параметры сети, которые будут применяться к сетевым ресурсам, связанным с Центром разработки. DevCenterNetworkSettings
projectCatalogSettings Параметры Центра разработки, используемые при связывании проекта с каталогом. DevCenterProjectCatalogSettings

Шифрование

Имя Описание Ценность
customerManagedKeyEncryption Все свойства шифрования ключей, управляемых клиентом, для ресурса. CustomerManagedKeyEncryption

ManagedServiceIdentity

Имя Описание Ценность
тип Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned). "Нет"
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned (обязательно)
userAssignedIdentities Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах. UserAssignedIdentities

Microsoft.DevCenter/devcenters

Имя Описание Ценность
тождество Свойства управляемого удостоверения ManagedServiceIdentity
местоположение Географическое расположение, в котором находится ресурс строка (обязательно)
имя Имя ресурса струна

Ограничения целостности:
Минимальная длина = 3
Максимальная длина = 26
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (обязательно)
свойства Свойства DevCenter DevCenterProperties
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах

TrackedResourceTags

Имя Описание Ценность

UserAssignedIdentities

Имя Описание Ценность

UserAssignedIdentity

Имя Описание Ценность

Примеры использования

Примеры быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.

Bicep-файл Описание
Настройка службы сред развертывания Этот шаблон предоставляет способ настройки сред развертывания.
настройка службы Dev Box Этот шаблон создаст все ресурсы администратора Dev Box в рамках краткого руководства по началу работы Dev Box (/azure/dev-box/quickstart-create-dev-box). Вы можете просмотреть все созданные ресурсы или напрямую перейти к DevPortal.microsoft.com для создания первого поля разработки.
развертывание службы Dev Box Со встроенным образом Этот шаблон предоставляет способ развертывания службы Dev Box со встроенным образом.

Определение ресурса шаблона ARM

Тип ресурса devcenters можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.DevCenter/devcenters, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.DevCenter/devcenters",
  "apiVersion": "2025-02-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "devBoxProvisioningSettings": {
      "installAzureMonitorAgentEnableStatus": "string"
    },
    "displayName": "string",
    "encryption": {
      "customerManagedKeyEncryption": {
        "keyEncryptionKeyIdentity": {
          "delegatedIdentityClientId": "string",
          "identityType": "string",
          "userAssignedIdentityResourceId": "string"
        },
        "keyEncryptionKeyUrl": "string"
      }
    },
    "networkSettings": {
      "microsoftHostedNetworkEnableStatus": "string"
    },
    "projectCatalogSettings": {
      "catalogItemSyncEnableStatus": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Значения свойств

CustomerManagedKeyEncryption

Имя Описание Ценность
keyEncryptionKeyIdentity Все настройки удостоверений для параметров ключей, управляемых клиентом, определяют, какое удостоверение следует использовать для проверки подлинности в Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl URL-адрес ключа шифрования ключей, версия или не версия. Например, https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 или https://contosovault.vault.azure.net/keys/contosokek. струна

CustomerManagedKeyEncryptionKeyIdentity

Имя Описание Ценность
delegatedIdentityClientId Делегированное удостоверение, используемое для доступа к URL-адресу ключа шифрования ключей. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<группы ресурсов>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Взаимоисключающая с identityType systemAssignedIdentity и userAssignedIdentity — только внутреннее использование. струна

Ограничения целостности:
Минимальная длина = 36
Максимальная длина = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType Значения могут быть systemAssignedIdentity или userAssignedIdentity "delegatedResourceIdentity"
SystemAssignedIdentity
UserAssignedIdentity
userAssignedIdentityResourceId назначаемое пользователем удостоверение для доступа к url-адресу ключа шифрования ключей. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<группы ресурсов>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Взаимоисключающая с identityType systemAssignedIdentity и делегатомResourceIdentity. струна

DevBoxProvisioningSettings

Имя Описание Ценность
installAzureMonitorAgentEnableStatus Можно ли настроить каталоги проектов, связанные с проектами в этом центре разработки, для синхронизации элементов каталога. "Отключено"
"Включено"

DevCenterNetworkSettings

Имя Описание Ценность
microsoftHostedNetworkEnableStatus Указывает, могут ли пулы в этом Центре разработки использовать размещенные сети Майкрософт. Значение по умолчанию включено, если не задано. "Отключено"
"Включено"

DevCenterProjectCatalogSettings

Имя Описание Ценность
catalogItemSyncEnableStatus Можно ли настроить каталоги проектов, связанные с проектами в этом центре разработки, для синхронизации элементов каталога. "Отключено"
"Включено"

DevCenterProperties

Имя Описание Ценность
devBoxProvisioningSettings Параметры, используемые в подготовке всех модулей Dev Box, принадлежащих этому центру разработки. DevBoxProvisioningSettings
displayName Отображаемое имя центра разработки. струна
шифрование Параметры шифрования, используемые для шифрования на стороне сервера для закрытого содержимого (например, каталоги, журналы, настройки). шифрования
networkSettings Параметры сети, которые будут применяться к сетевым ресурсам, связанным с Центром разработки. DevCenterNetworkSettings
projectCatalogSettings Параметры Центра разработки, используемые при связывании проекта с каталогом. DevCenterProjectCatalogSettings

Шифрование

Имя Описание Ценность
customerManagedKeyEncryption Все свойства шифрования ключей, управляемых клиентом, для ресурса. CustomerManagedKeyEncryption

ManagedServiceIdentity

Имя Описание Ценность
тип Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned). "Нет"
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned (обязательно)
userAssignedIdentities Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах. UserAssignedIdentities

Microsoft.DevCenter/devcenters

Имя Описание Ценность
apiVersion Версия API '2025-02-01'
тождество Свойства управляемого удостоверения ManagedServiceIdentity
местоположение Географическое расположение, в котором находится ресурс строка (обязательно)
имя Имя ресурса струна

Ограничения целостности:
Минимальная длина = 3
Максимальная длина = 26
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (обязательно)
свойства Свойства DevCenter DevCenterProperties
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
тип Тип ресурса "Microsoft.DevCenter/devcenters"

TrackedResourceTags

Имя Описание Ценность

UserAssignedIdentities

Имя Описание Ценность

UserAssignedIdentity

Имя Описание Ценность

Примеры использования

Шаблоны быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.

Шаблон Описание
Настройка службы сред развертывания

развертывание в Azure
Этот шаблон предоставляет способ настройки сред развертывания.
настройка службы Dev Box

развертывание в Azure
Этот шаблон создаст все ресурсы администратора Dev Box в рамках краткого руководства по началу работы Dev Box (/azure/dev-box/quickstart-create-dev-box). Вы можете просмотреть все созданные ресурсы или напрямую перейти к DevPortal.microsoft.com для создания первого поля разработки.
развертывание службы Dev Box Со встроенным образом

развертывание в Azure
Этот шаблон предоставляет способ развертывания службы Dev Box со встроенным образом.

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса devcenters можно развернуть с помощью операций, предназначенных для следующих операций:

  • групп ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.DevCenter/devcenters, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/devcenters@2025-02-01"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      devBoxProvisioningSettings = {
        installAzureMonitorAgentEnableStatus = "string"
      }
      displayName = "string"
      encryption = {
        customerManagedKeyEncryption = {
          keyEncryptionKeyIdentity = {
            delegatedIdentityClientId = "string"
            identityType = "string"
            userAssignedIdentityResourceId = "string"
          }
          keyEncryptionKeyUrl = "string"
        }
      }
      networkSettings = {
        microsoftHostedNetworkEnableStatus = "string"
      }
      projectCatalogSettings = {
        catalogItemSyncEnableStatus = "string"
      }
    }
  }
}

Значения свойств

CustomerManagedKeyEncryption

Имя Описание Ценность
keyEncryptionKeyIdentity Все настройки удостоверений для параметров ключей, управляемых клиентом, определяют, какое удостоверение следует использовать для проверки подлинности в Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl URL-адрес ключа шифрования ключей, версия или не версия. Например, https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 или https://contosovault.vault.azure.net/keys/contosokek. струна

CustomerManagedKeyEncryptionKeyIdentity

Имя Описание Ценность
delegatedIdentityClientId Делегированное удостоверение, используемое для доступа к URL-адресу ключа шифрования ключей. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<группы ресурсов>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Взаимоисключающая с identityType systemAssignedIdentity и userAssignedIdentity — только внутреннее использование. струна

Ограничения целостности:
Минимальная длина = 36
Максимальная длина = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType Значения могут быть systemAssignedIdentity или userAssignedIdentity "delegatedResourceIdentity"
SystemAssignedIdentity
UserAssignedIdentity
userAssignedIdentityResourceId назначаемое пользователем удостоверение для доступа к url-адресу ключа шифрования ключей. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<группы ресурсов>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Взаимоисключающая с identityType systemAssignedIdentity и делегатомResourceIdentity. струна

DevBoxProvisioningSettings

Имя Описание Ценность
installAzureMonitorAgentEnableStatus Можно ли настроить каталоги проектов, связанные с проектами в этом центре разработки, для синхронизации элементов каталога. "Отключено"
"Включено"

DevCenterNetworkSettings

Имя Описание Ценность
microsoftHostedNetworkEnableStatus Указывает, могут ли пулы в этом Центре разработки использовать размещенные сети Майкрософт. Значение по умолчанию включено, если не задано. "Отключено"
"Включено"

DevCenterProjectCatalogSettings

Имя Описание Ценность
catalogItemSyncEnableStatus Можно ли настроить каталоги проектов, связанные с проектами в этом центре разработки, для синхронизации элементов каталога. "Отключено"
"Включено"

DevCenterProperties

Имя Описание Ценность
devBoxProvisioningSettings Параметры, используемые в подготовке всех модулей Dev Box, принадлежащих этому центру разработки. DevBoxProvisioningSettings
displayName Отображаемое имя центра разработки. струна
шифрование Параметры шифрования, используемые для шифрования на стороне сервера для закрытого содержимого (например, каталоги, журналы, настройки). шифрования
networkSettings Параметры сети, которые будут применяться к сетевым ресурсам, связанным с Центром разработки. DevCenterNetworkSettings
projectCatalogSettings Параметры Центра разработки, используемые при связывании проекта с каталогом. DevCenterProjectCatalogSettings

Шифрование

Имя Описание Ценность
customerManagedKeyEncryption Все свойства шифрования ключей, управляемых клиентом, для ресурса. CustomerManagedKeyEncryption

ManagedServiceIdentity

Имя Описание Ценность
тип Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned). "Нет"
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned (обязательно)
userAssignedIdentities Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах. UserAssignedIdentities

Microsoft.DevCenter/devcenters

Имя Описание Ценность
тождество Свойства управляемого удостоверения ManagedServiceIdentity
местоположение Географическое расположение, в котором находится ресурс строка (обязательно)
имя Имя ресурса струна

Ограничения целостности:
Минимальная длина = 3
Максимальная длина = 26
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (обязательно)
свойства Свойства DevCenter DevCenterProperties
Теги Теги ресурсов Словарь имен и значений тегов.
тип Тип ресурса "Microsoft.DevCenter/devcenters@2025-02-01"

TrackedResourceTags

Имя Описание Ценность

UserAssignedIdentities

Имя Описание Ценность

UserAssignedIdentity

Имя Описание Ценность

Примеры использования

Проверенные модули Azure

Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.

Модуль Описание
Центра разработки Модуль ресурсов AVM для Центра разработки