Delen via


Microsoft.DevCenter devcenters

Bicep-resourcedefinitie

Het resourcetype devcenters kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Microsoft.DevCenter/devcenters-resource wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

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

Eigenschapswaarden

Microsoft.DevCenter/devcenters

Name Description Value
identity Eigenschappen van beheerde identiteit. ManagedServiceIdentity
location De geografische locatie waar de resource zich bevindt tekenreeks (vereist)
name De resourcenaam string

Constraints:
Minimale lengte = 3
Maximale lengte = 26
Patroon = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (vereist)
properties DevCenter eigenschappen DevCenterProperties
tags Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen

CustomerManagedKeyEncryption

Name Description Value
keyEncryptionKeyIdentity Alle identiteitsconfiguraties voor door de klant beheerde sleutelinstellingen die definiëren welke identiteit moet worden gebruikt voor verificatie bij Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl sleutelversleutelingssleutel-URL, versie of niet-versie. Bijvoorbeeld: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 of https://contosovault.vault.azure.net/keys/contosokek. string

CustomerManagedKeyEncryptionKeyIdentity

Name Description Value
delegatedIdentityClientId Gedelegeerde identiteit die moet worden gebruikt voor toegang tot de URL van de sleutelversleutelingssleutel. Bijvoorbeeld: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<resourcegroep>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Wederzijds exclusief met identityType systemAssignedIdentity en userAssignedIdentity - alleen intern gebruik. string

Constraints:
Minimale lengte = 36
Maximale lengte = 36
Patroon = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType Waarden kunnen systemAssignedIdentity of userAssignedIdentity zijn 'delegatedResourceIdentity'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId door de gebruiker toegewezen identiteit die moet worden gebruikt voor toegang tot de URL van de sleutelversleutelingssleutel. Bijvoorbeeld: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<resourcegroep>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Wederzijds exclusief met identityType systemAssignedIdentity en delegatedResourceIdentity. string

DevBoxProvisioningSettings

Name Description Value
installAzureMonitorAgentEnableStatus Geeft aan of de Azure Monitor Agent-service moet worden geïnstalleerd op ontwikkelboxen die bij dit ontwikkelaarscentrum horen 'Disabled'
'Enabled'

DevCenterNetworkSettings

Name Description Value
microsoftHostedNetworkEnableStatus Hiermee wordt aangegeven of pools in dit Ontwikkelaarscentrum gebruikmaken van gehoste netwerken van Microsoft. De standaardinstelling is ingeschakeld als deze niet is ingesteld. 'Disabled'
'Enabled'

DevCenterProjectCatalogSettings

Name Description Value
catalogItemSyncEnableStatus Of projectcatalogussen die zijn gekoppeld aan projecten in dit ontwikkelaarscentrum, kunnen worden geconfigureerd voor het synchroniseren van catalogusitems. 'Disabled'
'Enabled'

DevCenterProperties

Name Description Value
devBoxProvisioningSettings Instellingen die moeten worden gebruikt bij het inrichten van alle Dev Boxes die deel uitmaken van dit ontwikkelaarscentrum. DevBoxProvisioningSettings
displayName De weergavenaam van het devcenter. string
encryption Versleutelingsinstellingen die moeten worden gebruikt voor versleuteling aan de serverzijde voor bedrijfseigen inhoud (zoals catalogi, logboeken, aanpassingen). Encryption
networkSettings Netwerkinstellingen die worden afgedwongen op netwerkbronnen die zijn gekoppeld aan het Ontwikkelaarscentrum. DevCenterNetworkSettings
projectCatalogSettings Dev Center-instellingen die moeten worden gebruikt bij het koppelen van een project aan een catalogus. DevCenterProjectCatalogSettings

Encryption

Name Description Value
customerManagedKeyEncryption Alle door de klant beheerde sleutelversleutelingseigenschappen voor de resource. CustomerManagedKeyEncryption

ManagedServiceIdentity

Name Description Value
type Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). 'None'
'SystemAssigned'
'Systeemtoegewezen, Gebruikertoegewezen'
UserAssigned (vereist)
userAssignedIdentities De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen. UserAssignedIdentities

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

Gebruiksvoorbeelden

Geverifieerde Azure-modules

De volgende azure-geverifieerde modules kunnen worden gebruikt om dit resourcetype te implementeren.

Module Description
Ontwikkelaarscentrum AVM-resourcemodule voor Ontwikkelaarscentrum

Azure-snelstartvoorbeelden

De volgende Azure-quickstartsjablonen bicep-voorbeelden bevatten voor het implementeren van dit resourcetype.

Bicep-bestand Description
implementatieomgevingen configureren Deze sjabloon biedt een manier om implementatieomgevingen te configureren.
Dev Box-service configureren Met deze sjabloon worden alle Dev Box-beheerbronnen gemaakt volgens de Quick Start-handleiding voor Dev Box (/azure/dev-box/quickstart-create-dev-box). U kunt alle gemaakte resources bekijken of rechtstreeks naar DevPortal.microsoft.com gaan om uw eerste Dev Box te maken.
Dev Box-service implementeren Deze sjabloon biedt een manier om alle bronnen te configureren die nodig zijn om een Dev Box te maken.
Dev Box Service implementeren met ingebouwde installatiekopie Deze sjabloon biedt een manier om een Dev Box-service met ingebouwde installatiekopie te implementeren.

Resourcedefinitie van ARM-sjabloon

Het resourcetype devcenters kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Microsoft.DevCenter/devcenters-resource wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

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

Eigenschapswaarden

Microsoft.DevCenter/devcenters

Name Description Value
apiVersion De API-versie '2026-01-01-preview'
identity Eigenschappen van beheerde identiteit. ManagedServiceIdentity
location De geografische locatie waar de resource zich bevindt tekenreeks (vereist)
name De resourcenaam string

Constraints:
Minimale lengte = 3
Maximale lengte = 26
Patroon = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (vereist)
properties DevCenter eigenschappen DevCenterProperties
tags Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen
type Het resourcetype 'Microsoft.DevCenter/devcenters'

CustomerManagedKeyEncryption

Name Description Value
keyEncryptionKeyIdentity Alle identiteitsconfiguraties voor door de klant beheerde sleutelinstellingen die definiëren welke identiteit moet worden gebruikt voor verificatie bij Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl sleutelversleutelingssleutel-URL, versie of niet-versie. Bijvoorbeeld: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 of https://contosovault.vault.azure.net/keys/contosokek. string

CustomerManagedKeyEncryptionKeyIdentity

Name Description Value
delegatedIdentityClientId Gedelegeerde identiteit die moet worden gebruikt voor toegang tot de URL van de sleutelversleutelingssleutel. Bijvoorbeeld: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<resourcegroep>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Wederzijds exclusief met identityType systemAssignedIdentity en userAssignedIdentity - alleen intern gebruik. string

Constraints:
Minimale lengte = 36
Maximale lengte = 36
Patroon = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType Waarden kunnen systemAssignedIdentity of userAssignedIdentity zijn 'delegatedResourceIdentity'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId door de gebruiker toegewezen identiteit die moet worden gebruikt voor toegang tot de URL van de sleutelversleutelingssleutel. Bijvoorbeeld: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<resourcegroep>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Wederzijds exclusief met identityType systemAssignedIdentity en delegatedResourceIdentity. string

DevBoxProvisioningSettings

Name Description Value
installAzureMonitorAgentEnableStatus Geeft aan of de Azure Monitor Agent-service moet worden geïnstalleerd op ontwikkelboxen die bij dit ontwikkelaarscentrum horen 'Disabled'
'Enabled'

DevCenterNetworkSettings

Name Description Value
microsoftHostedNetworkEnableStatus Hiermee wordt aangegeven of pools in dit Ontwikkelaarscentrum gebruikmaken van gehoste netwerken van Microsoft. De standaardinstelling is ingeschakeld als deze niet is ingesteld. 'Disabled'
'Enabled'

DevCenterProjectCatalogSettings

Name Description Value
catalogItemSyncEnableStatus Of projectcatalogussen die zijn gekoppeld aan projecten in dit ontwikkelaarscentrum, kunnen worden geconfigureerd voor het synchroniseren van catalogusitems. 'Disabled'
'Enabled'

DevCenterProperties

Name Description Value
devBoxProvisioningSettings Instellingen die moeten worden gebruikt bij het inrichten van alle Dev Boxes die deel uitmaken van dit ontwikkelaarscentrum. DevBoxProvisioningSettings
displayName De weergavenaam van het devcenter. string
encryption Versleutelingsinstellingen die moeten worden gebruikt voor versleuteling aan de serverzijde voor bedrijfseigen inhoud (zoals catalogi, logboeken, aanpassingen). Encryption
networkSettings Netwerkinstellingen die worden afgedwongen op netwerkbronnen die zijn gekoppeld aan het Ontwikkelaarscentrum. DevCenterNetworkSettings
projectCatalogSettings Dev Center-instellingen die moeten worden gebruikt bij het koppelen van een project aan een catalogus. DevCenterProjectCatalogSettings

Encryption

Name Description Value
customerManagedKeyEncryption Alle door de klant beheerde sleutelversleutelingseigenschappen voor de resource. CustomerManagedKeyEncryption

ManagedServiceIdentity

Name Description Value
type Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). 'None'
'SystemAssigned'
'Systeemtoegewezen, Gebruikertoegewezen'
UserAssigned (vereist)
userAssignedIdentities De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen. UserAssignedIdentities

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

Gebruiksvoorbeelden

Azure-snelstartsjablonen

De volgende Azure-quickstartsjablonen dit resourcetype implementeren.

Template Description
implementatieomgevingen configureren

implementeren in Azure
Deze sjabloon biedt een manier om implementatieomgevingen te configureren.
Dev Box-service configureren

implementeren in Azure
Met deze sjabloon worden alle Dev Box-beheerbronnen gemaakt volgens de Quick Start-handleiding voor Dev Box (/azure/dev-box/quickstart-create-dev-box). U kunt alle gemaakte resources bekijken of rechtstreeks naar DevPortal.microsoft.com gaan om uw eerste Dev Box te maken.
Dev Box-service implementeren

implementeren in Azure
Deze sjabloon biedt een manier om alle bronnen te configureren die nodig zijn om een Dev Box te maken.
Dev Box Service implementeren met ingebouwde installatiekopie

implementeren in Azure
Deze sjabloon biedt een manier om een Dev Box-service met ingebouwde installatiekopie te implementeren.

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype devcenters kan worden geïmplementeerd met bewerkingen die zijn gericht op:

  • Resourcegroepen

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Microsoft.DevCenter/devcenters-resource wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

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

Eigenschapswaarden

Microsoft.DevCenter/devcenters

Name Description Value
identity Eigenschappen van beheerde identiteit. ManagedServiceIdentity
location De geografische locatie waar de resource zich bevindt tekenreeks (vereist)
name De resourcenaam string

Constraints:
Minimale lengte = 3
Maximale lengte = 26
Patroon = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (vereist)
properties DevCenter eigenschappen DevCenterProperties
tags Resourcetags Woordenlijst met tagnamen en -waarden.
type Het resourcetype "Microsoft.DevCenter/devcenters@2026-01-01-preview"

CustomerManagedKeyEncryption

Name Description Value
keyEncryptionKeyIdentity Alle identiteitsconfiguraties voor door de klant beheerde sleutelinstellingen die definiëren welke identiteit moet worden gebruikt voor verificatie bij Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl sleutelversleutelingssleutel-URL, versie of niet-versie. Bijvoorbeeld: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 of https://contosovault.vault.azure.net/keys/contosokek. string

CustomerManagedKeyEncryptionKeyIdentity

Name Description Value
delegatedIdentityClientId Gedelegeerde identiteit die moet worden gebruikt voor toegang tot de URL van de sleutelversleutelingssleutel. Bijvoorbeeld: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<resourcegroep>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Wederzijds exclusief met identityType systemAssignedIdentity en userAssignedIdentity - alleen intern gebruik. string

Constraints:
Minimale lengte = 36
Maximale lengte = 36
Patroon = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType Waarden kunnen systemAssignedIdentity of userAssignedIdentity zijn 'delegatedResourceIdentity'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId door de gebruiker toegewezen identiteit die moet worden gebruikt voor toegang tot de URL van de sleutelversleutelingssleutel. Bijvoorbeeld: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<resourcegroep>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Wederzijds exclusief met identityType systemAssignedIdentity en delegatedResourceIdentity. string

DevBoxProvisioningSettings

Name Description Value
installAzureMonitorAgentEnableStatus Geeft aan of de Azure Monitor Agent-service moet worden geïnstalleerd op ontwikkelboxen die bij dit ontwikkelaarscentrum horen 'Disabled'
'Enabled'

DevCenterNetworkSettings

Name Description Value
microsoftHostedNetworkEnableStatus Hiermee wordt aangegeven of pools in dit Ontwikkelaarscentrum gebruikmaken van gehoste netwerken van Microsoft. De standaardinstelling is ingeschakeld als deze niet is ingesteld. 'Disabled'
'Enabled'

DevCenterProjectCatalogSettings

Name Description Value
catalogItemSyncEnableStatus Of projectcatalogussen die zijn gekoppeld aan projecten in dit ontwikkelaarscentrum, kunnen worden geconfigureerd voor het synchroniseren van catalogusitems. 'Disabled'
'Enabled'

DevCenterProperties

Name Description Value
devBoxProvisioningSettings Instellingen die moeten worden gebruikt bij het inrichten van alle Dev Boxes die deel uitmaken van dit ontwikkelaarscentrum. DevBoxProvisioningSettings
displayName De weergavenaam van het devcenter. string
encryption Versleutelingsinstellingen die moeten worden gebruikt voor versleuteling aan de serverzijde voor bedrijfseigen inhoud (zoals catalogi, logboeken, aanpassingen). Encryption
networkSettings Netwerkinstellingen die worden afgedwongen op netwerkbronnen die zijn gekoppeld aan het Ontwikkelaarscentrum. DevCenterNetworkSettings
projectCatalogSettings Dev Center-instellingen die moeten worden gebruikt bij het koppelen van een project aan een catalogus. DevCenterProjectCatalogSettings

Encryption

Name Description Value
customerManagedKeyEncryption Alle door de klant beheerde sleutelversleutelingseigenschappen voor de resource. CustomerManagedKeyEncryption

ManagedServiceIdentity

Name Description Value
type Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). 'None'
'SystemAssigned'
'Systeemtoegewezen, Gebruikertoegewezen'
UserAssigned (vereist)
userAssignedIdentities De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen. UserAssignedIdentities

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

Gebruiksvoorbeelden

Terraform-monsters

Een eenvoudig voorbeeld van het implementeren van 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"
  }
}

Geverifieerde Azure-modules

De volgende azure-geverifieerde modules kunnen worden gebruikt om dit resourcetype te implementeren.

Module Description
Ontwikkelaarscentrum AVM-resourcemodule voor Ontwikkelaarscentrum