Microsoft.DevCenter центры разработки 2024-10-01-preview

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

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

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

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

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

resource symbolicname 'Microsoft.DevCenter/devcenters@2024-10-01-preview' = {
  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'
    }
    planId: 'string'
    projectCatalogSettings: {
      catalogItemSyncEnableStatus: 'string'
    }
    restrictedResourceTypes: [
      'string'
    ]
  }
  tags: {
    {customized property}: 'string'
  }
}

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

Microsoft.DevCenter/devcenters

Name Description Value
identity Свойства управляемого удостоверения ManagedServiceIdentity
location Географическое расположение, в котором находится ресурс строка (обязательно)
name Имя ресурса string

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

CustomerManagedKeyEncryption

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

CustomerManagedKeyEncryptionKeyIdentity

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

Constraints:
Минимальная длина = 36
Максимальная длина = 36
Шаблон = ^[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. string

DevBoxProvisioningSettings

Name Description Value
installAzureMonitorAgentEnableStatus Можно ли настроить каталоги проектов, связанные с проектами в этом центре разработки, для синхронизации элементов каталога. 'Disabled'
'Enabled'

DevCenterNetworkSettings

Name Description Value
microsoftHostedNetworkEnableStatus Указывает, могут ли пулы в этом Центре разработки использовать размещенные сети Майкрософт. Значение по умолчанию включено, если не задано. 'Disabled'
'Enabled'

DevCenterProjectCatalogSettings

Name Description Value
catalogItemSyncEnableStatus Можно ли настроить каталоги проектов, связанные с проектами в этом центре разработки, для синхронизации элементов каталога. 'Disabled'
'Enabled'

DevCenterProperties

Name Description Value
devBoxProvisioningSettings Параметры, используемые в подготовке всех модулей Dev Box, принадлежащих этому центру разработки. DevBoxProvisioningSettings
displayName Отображаемое имя центра разработки. string
encryption Параметры шифрования, используемые для шифрования на стороне сервера для закрытого содержимого (например, каталоги, журналы, настройки). Encryption
networkSettings Параметры сети, которые будут применяться к сетевым ресурсам, связанным с Центром разработки. DevCenterNetworkSettings
planId Идентификатор ресурса связанного плана string
projectCatalogSettings Параметры Центра разработки, используемые при связывании проекта с каталогом. DevCenterProjectCatalogSettings
restrictedResourceTypes Указывает типы ресурсов, которые ограничены доступом к проекту, если не разрешено политикой проекта. Массив строк, содержащий любой из:
'AttachedNetworks'
'Images'
'Skus'

Encryption

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

ManagedServiceIdentity

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

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

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

Примеры Bicep

Простой пример развертывания Центра разработки.

param resourceName string = 'acctest0001'
param location string = 'eastus'

resource devCenter 'Microsoft.DevCenter/devCenters@2025-02-01' = {
  name: resourceName
  location: location
}

resource userAssignedIdentity 'Microsoft.ManagedIdentity/userAssignedIdentities@2023-01-31' = {
  name: '${resourceName}-uai'
  location: location
}

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

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

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

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

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

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

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

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

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

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

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

{
  "type": "Microsoft.DevCenter/devcenters",
  "apiVersion": "2024-10-01-preview",
  "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"
    },
    "planId": "string",
    "projectCatalogSettings": {
      "catalogItemSyncEnableStatus": "string"
    },
    "restrictedResourceTypes": [ "string" ]
  },
  "tags": {
    "{customized property}": "string"
  }
}

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

Microsoft.DevCenter/devcenters

Name Description Value
apiVersion Версия API '2024-10-01-preview'
identity Свойства управляемого удостоверения ManagedServiceIdentity
location Географическое расположение, в котором находится ресурс строка (обязательно)
name Имя ресурса string

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

CustomerManagedKeyEncryption

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

CustomerManagedKeyEncryptionKeyIdentity

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

Constraints:
Минимальная длина = 36
Максимальная длина = 36
Шаблон = ^[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. string

DevBoxProvisioningSettings

Name Description Value
installAzureMonitorAgentEnableStatus Можно ли настроить каталоги проектов, связанные с проектами в этом центре разработки, для синхронизации элементов каталога. 'Disabled'
'Enabled'

DevCenterNetworkSettings

Name Description Value
microsoftHostedNetworkEnableStatus Указывает, могут ли пулы в этом Центре разработки использовать размещенные сети Майкрософт. Значение по умолчанию включено, если не задано. 'Disabled'
'Enabled'

DevCenterProjectCatalogSettings

Name Description Value
catalogItemSyncEnableStatus Можно ли настроить каталоги проектов, связанные с проектами в этом центре разработки, для синхронизации элементов каталога. 'Disabled'
'Enabled'

DevCenterProperties

Name Description Value
devBoxProvisioningSettings Параметры, используемые в подготовке всех модулей Dev Box, принадлежащих этому центру разработки. DevBoxProvisioningSettings
displayName Отображаемое имя центра разработки. string
encryption Параметры шифрования, используемые для шифрования на стороне сервера для закрытого содержимого (например, каталоги, журналы, настройки). Encryption
networkSettings Параметры сети, которые будут применяться к сетевым ресурсам, связанным с Центром разработки. DevCenterNetworkSettings
planId Идентификатор ресурса связанного плана string
projectCatalogSettings Параметры Центра разработки, используемые при связывании проекта с каталогом. DevCenterProjectCatalogSettings
restrictedResourceTypes Указывает типы ресурсов, которые ограничены доступом к проекту, если не разрешено политикой проекта. Массив строк, содержащий любой из:
'AttachedNetworks'
'Images'
'Skus'

Encryption

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

ManagedServiceIdentity

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

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

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

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

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

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

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

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

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

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

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

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

  • Группы ресурсов

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

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/devcenters@2024-10-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  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"
      }
      planId = "string"
      projectCatalogSettings = {
        catalogItemSyncEnableStatus = "string"
      }
      restrictedResourceTypes = [
        "string"
      ]
    }
  }
}

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

Microsoft.DevCenter/devcenters

Name Description Value
identity Свойства управляемого удостоверения ManagedServiceIdentity
location Географическое расположение, в котором находится ресурс строка (обязательно)
name Имя ресурса string

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

CustomerManagedKeyEncryption

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

CustomerManagedKeyEncryptionKeyIdentity

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

Constraints:
Минимальная длина = 36
Максимальная длина = 36
Шаблон = ^[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. string

DevBoxProvisioningSettings

Name Description Value
installAzureMonitorAgentEnableStatus Можно ли настроить каталоги проектов, связанные с проектами в этом центре разработки, для синхронизации элементов каталога. 'Disabled'
'Enabled'

DevCenterNetworkSettings

Name Description Value
microsoftHostedNetworkEnableStatus Указывает, могут ли пулы в этом Центре разработки использовать размещенные сети Майкрософт. Значение по умолчанию включено, если не задано. 'Disabled'
'Enabled'

DevCenterProjectCatalogSettings

Name Description Value
catalogItemSyncEnableStatus Можно ли настроить каталоги проектов, связанные с проектами в этом центре разработки, для синхронизации элементов каталога. 'Disabled'
'Enabled'

DevCenterProperties

Name Description Value
devBoxProvisioningSettings Параметры, используемые в подготовке всех модулей Dev Box, принадлежащих этому центру разработки. DevBoxProvisioningSettings
displayName Отображаемое имя центра разработки. string
encryption Параметры шифрования, используемые для шифрования на стороне сервера для закрытого содержимого (например, каталоги, журналы, настройки). Encryption
networkSettings Параметры сети, которые будут применяться к сетевым ресурсам, связанным с Центром разработки. DevCenterNetworkSettings
planId Идентификатор ресурса связанного плана string
projectCatalogSettings Параметры Центра разработки, используемые при связывании проекта с каталогом. DevCenterProjectCatalogSettings
restrictedResourceTypes Указывает типы ресурсов, которые ограничены доступом к проекту, если не разрешено политикой проекта. Массив строк, содержащий любой из:
'AttachedNetworks'
'Images'
'Skus'

Encryption

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

ManagedServiceIdentity

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

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

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

Примеры Terraform

Простой пример развертывания Центра разработки.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "eastus"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "userAssignedIdentity" {
  type      = "Microsoft.ManagedIdentity/userAssignedIdentities@2023-01-31"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}-uai"
  location  = var.location
  body      = {}
}

resource "azapi_resource" "devCenter" {
  type      = "Microsoft.DevCenter/devCenters@2025-02-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  identity {
    type         = "SystemAssigned, UserAssigned"
    identity_ids = [azapi_resource.userAssignedIdentity.id]
  }
  body = {}
  tags = {
    environment = "terraform-acctests"
    some_key    = "some-value"
  }
}

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

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

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