Vývojová centra Microsoft.DevCenter

Definice prostředku Bicep

Typ prostředku devcenters je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.DevCenter/devcenters, přidejte do šablony následující bicep.

resource symbolicname 'Microsoft.DevCenter/devcenters@2026-01-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'
    }
    projectCatalogSettings: {
      catalogItemSyncEnableStatus: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Hodnoty vlastností

Microsoft.DevCenter/devcenters

Name Description Value
identita Vlastnosti spravované identity ManagedServiceIdentity
poloha Geografické umístění, ve kterém se nachází zdroj string (povinné)
name Název prostředku string

Constraints:
Minimální délka = 3
Maximální délka = 26
Model = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (povinné)
properties Vlastnosti DevCenter DevCenterProperties
tags Štítky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách

CustomerManagedKeyEncryption

Name Description Value
keyEncryptionKeyIdentity Veškerá konfigurace identity pro nastavení klíčů spravovaných zákazníkem definující identitu, která se má použít k ověřování ve službě Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl adresa URL šifrovacího klíče klíče, verze nebo neverze. Příklad: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 nebo https://contosovault.vault.azure.net/keys/contosokek. řetězec

CustomerManagedKeyEncryptionKeyIdentity

Name Description Value
delegatedIdentityClientId delegovaná identita pro přístup k adrese URL šifrovacího klíče klíče. Příklad: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<skupiny prostředků>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Vzájemně se vylučují s identityType systemAssignedIdentity a userAssignedIdentity – pouze interní použití. string

Constraints:
Minimální délka = 36
Maximální délka = 36
Model = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType Hodnoty můžou být systemAssignedIdentity nebo userAssignedIdentity. 'delegatedResourceIdentity'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId identita přiřazená uživatelem, která se má použít pro přístup k adrese URL šifrovacího klíče klíče. Příklad: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<skupiny prostředků>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Vzájemně se vylučují s identityType systemAssignedIdentity a delegatedResourceIdentity. řetězec

DevBoxProvisioningSettings

Name Description Value
installAzureMonitorAgentEnableStatus Určuje, jestli se má nainstalovat služba Azure Monitor Agent do Dev Boxů, které patří do tohoto vývojového centra 'Disabled'
'Enabled'

DevCenterNetworkSettings

Name Description Value
microsoftHostedNetworkEnableStatus Určuje, jestli fondy v tomto vývojovém centru můžou používat hostované sítě Microsoftu. Pokud není nastavená, nastaví se výchozí hodnota Povoleno. 'Disabled'
'Enabled'

DevCenterProjectCatalogSettings

Name Description Value
catalogItemSyncEnableStatus Určuje, jestli je možné katalogy projektů přidružené k projektům v tomto vývojovém centru nakonfigurovat tak, aby synchronizovaly položky katalogu. 'Disabled'
'Enabled'

DevCenterProperties

Name Description Value
devBoxProvisioningSettings Nastavení, která se mají použít při zřizování všech vývojových polí, která patří do tohoto vývojového centra. DevBoxProvisioningSettings
displayName Zobrazovaný název devcenter. řetězec
šifrování Nastavení šifrování, která se mají použít pro šifrování na straně serveru pro proprietární obsah (například katalogy, protokoly, vlastní nastavení). Encryption
networkSettings Nastavení sítě, která se budou vynucovat u síťových prostředků přidružených k Dev Center. DevCenterNetworkSettings
projectCatalogSettings Nastavení Dev Center, která se mají použít při přidružování projektu ke katalogu DevCenterProjectCatalogSettings

Encryption

Name Description Value
customerManagedKeyEncryption Všechny vlastnosti šifrování klíče spravované zákazníkem pro prostředek. CustomerManagedKeyEncryption

ManagedServiceIdentity

Name Description Value
typ Typ identity spravované služby (kde jsou povolené typy SystemAssigned i UserAssigned). 'None'
'SystemAssigned'
SystemAssigned, UserAssigned
UserAssigned (povinné)
userAssignedIdentities Sada identit přiřazených uživatelem přidružená k prostředku. Klíče slovníku userAssignedIdentities budou ID prostředků ARM ve formuláři: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Hodnoty slovníku můžou být prázdné objekty ({}) v požadavcích. UserAssignedIdentities

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

Příklady použití

Ukázky Bicep

Základní příklad nasazení služby Dev Center.

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

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
}

Ověřené moduly Azure

K nasazení tohoto typu prostředku je možné použít následující ověřené moduly Azure.

Module Description
Centrum pro vývojáře Modul prostředků AVM pro Dev Center

Ukázky rychlého startu Azure

Následující šablony Azure pro rychlý start obsahují ukázky Bicep pro nasazení tohoto typu prostředku.

Soubor Bicep Description
konfigurace služby prostředí nasazení Tato šablona poskytuje způsob konfigurace prostředí nasazení.
konfigurace služby Dev Box Tato šablona by vytvořila všechny prostředky pro správu Dev Boxu podle úvodní příručky pro Dev Box (/azure/dev-box/quickstart-create-dev-box). Můžete zobrazit všechny vytvořené prostředky nebo přejít přímo na DevPortal.microsoft.com a vytvořit svůj první Dev Box.
Nasazení služby Dev Box Service Tato šablona poskytuje způsob, jak nakonfigurovat všechny zdroje potřebné k vytvoření Dev Boxu.
nasazení služby Dev Box Service s integrovanou imagí Tato šablona poskytuje způsob, jak nasadit službu Dev Box s integrovanou imagí.

Definice prostředku šablony ARM

Typ prostředku devcenters je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.DevCenter/devcenters, přidejte do šablony následující JSON.

{
  "type": "Microsoft.DevCenter/devcenters",
  "apiVersion": "2026-01-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"
    },
    "projectCatalogSettings": {
      "catalogItemSyncEnableStatus": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Hodnoty vlastností

Microsoft.DevCenter/devcenters

Name Description Value
apiVersion Verze rozhraní API 'Náhled 1. 1. 2026'
identita Vlastnosti spravované identity ManagedServiceIdentity
poloha Geografické umístění, ve kterém se nachází zdroj string (povinné)
name Název prostředku string

Constraints:
Minimální délka = 3
Maximální délka = 26
Model = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (povinné)
properties Vlastnosti DevCenter DevCenterProperties
tags Štítky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách
typ Typ prostředku 'Microsoft.DevCenter/devcenters'

CustomerManagedKeyEncryption

Name Description Value
keyEncryptionKeyIdentity Veškerá konfigurace identity pro nastavení klíčů spravovaných zákazníkem definující identitu, která se má použít k ověřování ve službě Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl adresa URL šifrovacího klíče klíče, verze nebo neverze. Příklad: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 nebo https://contosovault.vault.azure.net/keys/contosokek. řetězec

CustomerManagedKeyEncryptionKeyIdentity

Name Description Value
delegatedIdentityClientId delegovaná identita pro přístup k adrese URL šifrovacího klíče klíče. Příklad: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<skupiny prostředků>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Vzájemně se vylučují s identityType systemAssignedIdentity a userAssignedIdentity – pouze interní použití. string

Constraints:
Minimální délka = 36
Maximální délka = 36
Model = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType Hodnoty můžou být systemAssignedIdentity nebo userAssignedIdentity. 'delegatedResourceIdentity'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId identita přiřazená uživatelem, která se má použít pro přístup k adrese URL šifrovacího klíče klíče. Příklad: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<skupiny prostředků>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Vzájemně se vylučují s identityType systemAssignedIdentity a delegatedResourceIdentity. řetězec

DevBoxProvisioningSettings

Name Description Value
installAzureMonitorAgentEnableStatus Určuje, jestli se má nainstalovat služba Azure Monitor Agent do Dev Boxů, které patří do tohoto vývojového centra 'Disabled'
'Enabled'

DevCenterNetworkSettings

Name Description Value
microsoftHostedNetworkEnableStatus Určuje, jestli fondy v tomto vývojovém centru můžou používat hostované sítě Microsoftu. Pokud není nastavená, nastaví se výchozí hodnota Povoleno. 'Disabled'
'Enabled'

DevCenterProjectCatalogSettings

Name Description Value
catalogItemSyncEnableStatus Určuje, jestli je možné katalogy projektů přidružené k projektům v tomto vývojovém centru nakonfigurovat tak, aby synchronizovaly položky katalogu. 'Disabled'
'Enabled'

DevCenterProperties

Name Description Value
devBoxProvisioningSettings Nastavení, která se mají použít při zřizování všech vývojových polí, která patří do tohoto vývojového centra. DevBoxProvisioningSettings
displayName Zobrazovaný název devcenter. řetězec
šifrování Nastavení šifrování, která se mají použít pro šifrování na straně serveru pro proprietární obsah (například katalogy, protokoly, vlastní nastavení). Encryption
networkSettings Nastavení sítě, která se budou vynucovat u síťových prostředků přidružených k Dev Center. DevCenterNetworkSettings
projectCatalogSettings Nastavení Dev Center, která se mají použít při přidružování projektu ke katalogu DevCenterProjectCatalogSettings

Encryption

Name Description Value
customerManagedKeyEncryption Všechny vlastnosti šifrování klíče spravované zákazníkem pro prostředek. CustomerManagedKeyEncryption

ManagedServiceIdentity

Name Description Value
typ Typ identity spravované služby (kde jsou povolené typy SystemAssigned i UserAssigned). 'None'
'SystemAssigned'
SystemAssigned, UserAssigned
UserAssigned (povinné)
userAssignedIdentities Sada identit přiřazených uživatelem přidružená k prostředku. Klíče slovníku userAssignedIdentities budou ID prostředků ARM ve formuláři: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Hodnoty slovníku můžou být prázdné objekty ({}) v požadavcích. UserAssignedIdentities

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

Příklady použití

Šablony azure pro rychlý start

Následující šablony Azure Pro rychlý start nasadit tento typ prostředku.

Template Description
konfigurace služby prostředí nasazení

nasazení do Azure
Tato šablona poskytuje způsob konfigurace prostředí nasazení.
konfigurace služby Dev Box

nasazení do Azure
Tato šablona by vytvořila všechny prostředky pro správu Dev Boxu podle úvodní příručky pro Dev Box (/azure/dev-box/quickstart-create-dev-box). Můžete zobrazit všechny vytvořené prostředky nebo přejít přímo na DevPortal.microsoft.com a vytvořit svůj první Dev Box.
Nasazení služby Dev Box Service

nasazení do Azure
Tato šablona poskytuje způsob, jak nakonfigurovat všechny zdroje potřebné k vytvoření Dev Boxu.
nasazení služby Dev Box Service s integrovanou imagí

nasazení do Azure
Tato šablona poskytuje způsob, jak nasadit službu Dev Box s integrovanou imagí.

Definice prostředku Terraformu (poskytovatel AzAPI)

Typ prostředku devcenters je možné nasadit s operacemi, které cílí:

  • skupiny prostředků

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.DevCenter/devcenters, přidejte do šablony následující Terraform.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/devcenters@2026-01-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"
      }
      projectCatalogSettings = {
        catalogItemSyncEnableStatus = "string"
      }
    }
  }
}

Hodnoty vlastností

Microsoft.DevCenter/devcenters

Name Description Value
identita Vlastnosti spravované identity ManagedServiceIdentity
poloha Geografické umístění, ve kterém se nachází zdroj string (povinné)
name Název prostředku string

Constraints:
Minimální délka = 3
Maximální délka = 26
Model = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (povinné)
properties Vlastnosti DevCenter DevCenterProperties
tags Štítky prostředků Slovník názvů a hodnot značek
typ Typ prostředku "Microsoft.DevCenter/devcenters@2026-01-01-preview"

CustomerManagedKeyEncryption

Name Description Value
keyEncryptionKeyIdentity Veškerá konfigurace identity pro nastavení klíčů spravovaných zákazníkem definující identitu, která se má použít k ověřování ve službě Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl adresa URL šifrovacího klíče klíče, verze nebo neverze. Příklad: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 nebo https://contosovault.vault.azure.net/keys/contosokek. řetězec

CustomerManagedKeyEncryptionKeyIdentity

Name Description Value
delegatedIdentityClientId delegovaná identita pro přístup k adrese URL šifrovacího klíče klíče. Příklad: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<skupiny prostředků>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Vzájemně se vylučují s identityType systemAssignedIdentity a userAssignedIdentity – pouze interní použití. string

Constraints:
Minimální délka = 36
Maximální délka = 36
Model = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType Hodnoty můžou být systemAssignedIdentity nebo userAssignedIdentity. 'delegatedResourceIdentity'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId identita přiřazená uživatelem, která se má použít pro přístup k adrese URL šifrovacího klíče klíče. Příklad: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<skupiny prostředků>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Vzájemně se vylučují s identityType systemAssignedIdentity a delegatedResourceIdentity. řetězec

DevBoxProvisioningSettings

Name Description Value
installAzureMonitorAgentEnableStatus Určuje, jestli se má nainstalovat služba Azure Monitor Agent do Dev Boxů, které patří do tohoto vývojového centra 'Disabled'
'Enabled'

DevCenterNetworkSettings

Name Description Value
microsoftHostedNetworkEnableStatus Určuje, jestli fondy v tomto vývojovém centru můžou používat hostované sítě Microsoftu. Pokud není nastavená, nastaví se výchozí hodnota Povoleno. 'Disabled'
'Enabled'

DevCenterProjectCatalogSettings

Name Description Value
catalogItemSyncEnableStatus Určuje, jestli je možné katalogy projektů přidružené k projektům v tomto vývojovém centru nakonfigurovat tak, aby synchronizovaly položky katalogu. 'Disabled'
'Enabled'

DevCenterProperties

Name Description Value
devBoxProvisioningSettings Nastavení, která se mají použít při zřizování všech vývojových polí, která patří do tohoto vývojového centra. DevBoxProvisioningSettings
displayName Zobrazovaný název devcenter. řetězec
šifrování Nastavení šifrování, která se mají použít pro šifrování na straně serveru pro proprietární obsah (například katalogy, protokoly, vlastní nastavení). Encryption
networkSettings Nastavení sítě, která se budou vynucovat u síťových prostředků přidružených k Dev Center. DevCenterNetworkSettings
projectCatalogSettings Nastavení Dev Center, která se mají použít při přidružování projektu ke katalogu DevCenterProjectCatalogSettings

Encryption

Name Description Value
customerManagedKeyEncryption Všechny vlastnosti šifrování klíče spravované zákazníkem pro prostředek. CustomerManagedKeyEncryption

ManagedServiceIdentity

Name Description Value
typ Typ identity spravované služby (kde jsou povolené typy SystemAssigned i UserAssigned). 'None'
'SystemAssigned'
SystemAssigned, UserAssigned
UserAssigned (povinné)
userAssignedIdentities Sada identit přiřazených uživatelem přidružená k prostředku. Klíče slovníku userAssignedIdentities budou ID prostředků ARM ve formuláři: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Hodnoty slovníku můžou být prázdné objekty ({}) v požadavcích. UserAssignedIdentities

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

Příklady použití

Ukázky Terraformu

Základní příklad nasazení služby Dev Center.

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

Ověřené moduly Azure

K nasazení tohoto typu prostředku je možné použít následující ověřené moduly Azure.

Module Description
Centrum pro vývojáře Modul prostředků AVM pro Dev Center