Udostępnij przez


Microsoft.DevCenter devcenters

Definicja zasobu Bicep

Typ zasobu devcenters można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DevCenter/devcenters, dodaj następujący element Bicep do szablonu.

resource symbolicname 'Microsoft.DevCenter/devcenters@2025-10-01-preview' = {
  scope: resourceSymbolicName or scope
  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'
  }
}

Wartości właściwości

Microsoft.DevCenter/devcenters

Name Description Value
tożsamość Właściwości tożsamości zarządzanej. ManagedServiceIdentity
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
name Nazwa zasobu string

Constraints:
Minimalna długość = 3
Maksymalna długość = 26
Wzorzec = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (wymagane)
properties Właściwości DevCenter DevCenterProperties
zakres Użyj polecenia podczas tworzenia zasobu w zakresie innym niż zakres wdrożenia. Ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia.
tags Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

CustomerManagedKeyEncryption

Name Description Value
keyEncryptionKeyIdentity Cała konfiguracja tożsamości dla ustawień klucza zarządzanego przez klienta definiująca tożsamość, która powinna być używana do uwierzytelniania w usłudze Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl adres URL klucza szyfrowania klucza, wersja lub bez wersji. Na przykład: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 lub https://contosovault.vault.azure.net/keys/contosokek. ciąg

CustomerManagedKeyEncryptionKeyIdentity

Name Description Value
delegatedIdentityClientId tożsamość delegowana do użycia na potrzeby uzyskiwania dostępu do adresu URL klucza szyfrowania klucza. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupa zasobów>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Wzajemnie wykluczające się z identityType systemAssignedIdentity i userAssignedIdentity — tylko użycie wewnętrzne. string

Constraints:
Minimalna długość = 36
Maksymalna długość = 36
Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType Wartości mogą być systemAssignedIdentity lub userAssignedIdentity 'delegatedResourceIdentity'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId tożsamość przypisana przez użytkownika do użycia na potrzeby uzyskiwania dostępu do adresu URL klucza szyfrowania klucza. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupa zasobów>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Wzajemnie wyklucza się z identityType systemAssignedIdentity i delegatedResourceIdentity. ciąg

DevBoxProvisioningSettings

Name Description Value
installAzureMonitorAgentEnableStatus Wskazuje, czy należy zainstalować usługę agenta usługi Azure Monitor na polach deweloperskich należących do tego centrum deweloperów 'Disabled'
'Enabled'

DevCenterNetworkSettings

Name Description Value
microsoftHostedNetworkEnableStatus Wskazuje, czy pule w tym Centrum deweloperów mogą używać sieci hostowanych przez firmę Microsoft. Wartości domyślne to Włączone, jeśli nie są ustawione. 'Disabled'
'Enabled'

DevCenterProjectCatalogSettings

Name Description Value
catalogItemSyncEnableStatus Określa, czy katalogi projektów skojarzone z projektami w tym centrum deweloperów można skonfigurować do synchronizowania elementów wykazu. 'Disabled'
'Enabled'

DevCenterProperties

Name Description Value
devBoxProvisioningSettings Ustawienia, które mają być używane w aprowizacji wszystkich pól deweloperskich należących do tego centrum deweloperów. DevBoxProvisioningSettings
displayName Nazwa wyświetlana centrum deweloperów. ciąg
szyfrowanie Ustawienia szyfrowania, które mają być używane do szyfrowania po stronie serwera dla zastrzeżonej zawartości (takich jak wykazy, dzienniki, dostosowania). Encryption
networkSettings Ustawienia sieci, które będą wymuszane na zasobach sieciowych skojarzonych z Centrum deweloperów. DevCenterNetworkSettings
projectCatalogSettings Ustawienia Centrum deweloperów, które mają być używane podczas kojarzenia projektu z wykazem. DevCenterProjectCatalogSettings

Encryption

Name Description Value
customerManagedKeyEncryption Wszystkie właściwości szyfrowania kluczy zarządzanych przez klienta dla zasobu. CustomerManagedKeyEncryption

ManagedServiceIdentity

Name Description Value
typ Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). 'None'
'SystemAssigned'
"SystemAssigned, UserAssigned"
"UserAssigned" (wymagane)
userAssignedIdentities Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. UserAssignedIdentities

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Module Description
Centrum deweloperów Moduł zasobów AVM dla Centrum deweloperów

Przykłady szybkiego startu platformy Azure

Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.

Plik Bicep Description
Konfigurowanie usługi środowiska wdrażania Ten szablon umożliwia konfigurowanie środowisk wdrażania.
Konfigurowanie usługi Dev Box Ten szablon umożliwia utworzenie wszystkich zasobów administracyjnych usługi Dev Box zgodnie z przewodnikiem Szybki start dotyczącym usługi Dev Box (/azure/dev-box/quickstart-create-dev-box). Możesz wyświetlić wszystkie utworzone zasoby lub bezpośrednio przejść do DevPortal.microsoft.com, aby utworzyć pierwsze rozwiązanie Dev Box.
Wdrażanie usługi Dev Box Service Ten szablon umożliwia skonfigurowanie wszystkich zasobów wymaganych do utworzenia urządzenia Dev Box.
wdrażanie usługi Dev Box Service z wbudowanym obrazem Ten szablon umożliwia wdrożenie usługi Dev Box z wbudowanym obrazem.

Definicja zasobu szablonu usługi ARM

Typ zasobu devcenters można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DevCenter/devcenters, dodaj następujący kod JSON do szablonu.

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

Wartości właściwości

Microsoft.DevCenter/devcenters

Name Description Value
apiVersion Wersja interfejsu API "2025-10-01-podgląd"
tożsamość Właściwości tożsamości zarządzanej. ManagedServiceIdentity
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
name Nazwa zasobu string

Constraints:
Minimalna długość = 3
Maksymalna długość = 26
Wzorzec = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (wymagane)
properties Właściwości DevCenter DevCenterProperties
tags Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu 'Microsoft.DevCenter/devcenters'

CustomerManagedKeyEncryption

Name Description Value
keyEncryptionKeyIdentity Cała konfiguracja tożsamości dla ustawień klucza zarządzanego przez klienta definiująca tożsamość, która powinna być używana do uwierzytelniania w usłudze Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl adres URL klucza szyfrowania klucza, wersja lub bez wersji. Na przykład: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 lub https://contosovault.vault.azure.net/keys/contosokek. ciąg

CustomerManagedKeyEncryptionKeyIdentity

Name Description Value
delegatedIdentityClientId tożsamość delegowana do użycia na potrzeby uzyskiwania dostępu do adresu URL klucza szyfrowania klucza. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupa zasobów>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Wzajemnie wykluczające się z identityType systemAssignedIdentity i userAssignedIdentity — tylko użycie wewnętrzne. string

Constraints:
Minimalna długość = 36
Maksymalna długość = 36
Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType Wartości mogą być systemAssignedIdentity lub userAssignedIdentity 'delegatedResourceIdentity'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId tożsamość przypisana przez użytkownika do użycia na potrzeby uzyskiwania dostępu do adresu URL klucza szyfrowania klucza. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupa zasobów>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Wzajemnie wyklucza się z identityType systemAssignedIdentity i delegatedResourceIdentity. ciąg

DevBoxProvisioningSettings

Name Description Value
installAzureMonitorAgentEnableStatus Wskazuje, czy należy zainstalować usługę agenta usługi Azure Monitor na polach deweloperskich należących do tego centrum deweloperów 'Disabled'
'Enabled'

DevCenterNetworkSettings

Name Description Value
microsoftHostedNetworkEnableStatus Wskazuje, czy pule w tym Centrum deweloperów mogą używać sieci hostowanych przez firmę Microsoft. Wartości domyślne to Włączone, jeśli nie są ustawione. 'Disabled'
'Enabled'

DevCenterProjectCatalogSettings

Name Description Value
catalogItemSyncEnableStatus Określa, czy katalogi projektów skojarzone z projektami w tym centrum deweloperów można skonfigurować do synchronizowania elementów wykazu. 'Disabled'
'Enabled'

DevCenterProperties

Name Description Value
devBoxProvisioningSettings Ustawienia, które mają być używane w aprowizacji wszystkich pól deweloperskich należących do tego centrum deweloperów. DevBoxProvisioningSettings
displayName Nazwa wyświetlana centrum deweloperów. ciąg
szyfrowanie Ustawienia szyfrowania, które mają być używane do szyfrowania po stronie serwera dla zastrzeżonej zawartości (takich jak wykazy, dzienniki, dostosowania). Encryption
networkSettings Ustawienia sieci, które będą wymuszane na zasobach sieciowych skojarzonych z Centrum deweloperów. DevCenterNetworkSettings
projectCatalogSettings Ustawienia Centrum deweloperów, które mają być używane podczas kojarzenia projektu z wykazem. DevCenterProjectCatalogSettings

Encryption

Name Description Value
customerManagedKeyEncryption Wszystkie właściwości szyfrowania kluczy zarządzanych przez klienta dla zasobu. CustomerManagedKeyEncryption

ManagedServiceIdentity

Name Description Value
typ Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). 'None'
'SystemAssigned'
"SystemAssigned, UserAssigned"
"UserAssigned" (wymagane)
userAssignedIdentities Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. UserAssignedIdentities

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Template Description
Konfigurowanie usługi środowiska wdrażania

wdrażanie w usłudze Azure
Ten szablon umożliwia konfigurowanie środowisk wdrażania.
Konfigurowanie usługi Dev Box

wdrażanie w usłudze Azure
Ten szablon umożliwia utworzenie wszystkich zasobów administracyjnych usługi Dev Box zgodnie z przewodnikiem Szybki start dotyczącym usługi Dev Box (/azure/dev-box/quickstart-create-dev-box). Możesz wyświetlić wszystkie utworzone zasoby lub bezpośrednio przejść do DevPortal.microsoft.com, aby utworzyć pierwsze rozwiązanie Dev Box.
Wdrażanie usługi Dev Box Service

wdrażanie w usłudze Azure
Ten szablon umożliwia skonfigurowanie wszystkich zasobów wymaganych do utworzenia urządzenia Dev Box.
wdrażanie usługi Dev Box Service z wbudowanym obrazem

wdrażanie w usłudze Azure
Ten szablon umożliwia wdrożenie usługi Dev Box z wbudowanym obrazem.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu devcenters można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DevCenter/devcenters, dodaj następujący program Terraform do szablonu.

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

Wartości właściwości

Microsoft.DevCenter/devcenters

Name Description Value
tożsamość Właściwości tożsamości zarządzanej. ManagedServiceIdentity
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
name Nazwa zasobu string

Constraints:
Minimalna długość = 3
Maksymalna długość = 26
Wzorzec = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (wymagane)
parent_id Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. ciąg (wymagany)
properties Właściwości DevCenter DevCenterProperties
tags Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft.DevCenter/devcenters@2025-10-01-preview"

CustomerManagedKeyEncryption

Name Description Value
keyEncryptionKeyIdentity Cała konfiguracja tożsamości dla ustawień klucza zarządzanego przez klienta definiująca tożsamość, która powinna być używana do uwierzytelniania w usłudze Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl adres URL klucza szyfrowania klucza, wersja lub bez wersji. Na przykład: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 lub https://contosovault.vault.azure.net/keys/contosokek. ciąg

CustomerManagedKeyEncryptionKeyIdentity

Name Description Value
delegatedIdentityClientId tożsamość delegowana do użycia na potrzeby uzyskiwania dostępu do adresu URL klucza szyfrowania klucza. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupa zasobów>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Wzajemnie wykluczające się z identityType systemAssignedIdentity i userAssignedIdentity — tylko użycie wewnętrzne. string

Constraints:
Minimalna długość = 36
Maksymalna długość = 36
Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType Wartości mogą być systemAssignedIdentity lub userAssignedIdentity 'delegatedResourceIdentity'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId tożsamość przypisana przez użytkownika do użycia na potrzeby uzyskiwania dostępu do adresu URL klucza szyfrowania klucza. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupa zasobów>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Wzajemnie wyklucza się z identityType systemAssignedIdentity i delegatedResourceIdentity. ciąg

DevBoxProvisioningSettings

Name Description Value
installAzureMonitorAgentEnableStatus Wskazuje, czy należy zainstalować usługę agenta usługi Azure Monitor na polach deweloperskich należących do tego centrum deweloperów 'Disabled'
'Enabled'

DevCenterNetworkSettings

Name Description Value
microsoftHostedNetworkEnableStatus Wskazuje, czy pule w tym Centrum deweloperów mogą używać sieci hostowanych przez firmę Microsoft. Wartości domyślne to Włączone, jeśli nie są ustawione. 'Disabled'
'Enabled'

DevCenterProjectCatalogSettings

Name Description Value
catalogItemSyncEnableStatus Określa, czy katalogi projektów skojarzone z projektami w tym centrum deweloperów można skonfigurować do synchronizowania elementów wykazu. 'Disabled'
'Enabled'

DevCenterProperties

Name Description Value
devBoxProvisioningSettings Ustawienia, które mają być używane w aprowizacji wszystkich pól deweloperskich należących do tego centrum deweloperów. DevBoxProvisioningSettings
displayName Nazwa wyświetlana centrum deweloperów. ciąg
szyfrowanie Ustawienia szyfrowania, które mają być używane do szyfrowania po stronie serwera dla zastrzeżonej zawartości (takich jak wykazy, dzienniki, dostosowania). Encryption
networkSettings Ustawienia sieci, które będą wymuszane na zasobach sieciowych skojarzonych z Centrum deweloperów. DevCenterNetworkSettings
projectCatalogSettings Ustawienia Centrum deweloperów, które mają być używane podczas kojarzenia projektu z wykazem. DevCenterProjectCatalogSettings

Encryption

Name Description Value
customerManagedKeyEncryption Wszystkie właściwości szyfrowania kluczy zarządzanych przez klienta dla zasobu. CustomerManagedKeyEncryption

ManagedServiceIdentity

Name Description Value
typ Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). 'None'
'SystemAssigned'
"SystemAssigned, UserAssigned"
"UserAssigned" (wymagane)
userAssignedIdentities Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. UserAssignedIdentities

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrażania Centrum deweloperów.

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

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Module Description
Centrum deweloperów Moduł zasobów AVM dla Centrum deweloperów