Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
- Latest
- Avance del 01-01-2026
- 2025-10-01-vista previa
- 2025-07-01-preview
- 2025-04-01-preview
- 2025-02-01
- 2024-10-01-preview
- 2024-08-01-preview
- 2024-07-01-preview
- 2024-06-01-preview
- 2024-05-01-preview
- 2024-02-01
- 2023-10-01-preview
- 2023-08-01-preview
- 2023-04-01
- 2023-01-01-preview
- 2022-11-11-preview
- 2022-10-12-preview
- 2022-09-01-preview
- 2022-08-01-preview
Definición de recursos de Bicep
El tipo de recurso de los centros de desarrollo se puede implementar con operaciones destinadas a:
- grupos de recursos: consulte comandos de implementación de grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.DevCenter/devcenters, agregue el siguiente bicep a la plantilla.
resource symbolicname 'Microsoft.DevCenter/devcenters@2025-04-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'
}
}
Valores de propiedad
Microsoft.DevCenter/devcenters
| Name | Description | Value |
|---|---|---|
| identity | Propiedades de identidad administrada | ManagedServiceIdentity |
| location | Ubicación geográfica donde reside el recurso | string (obligatorio) |
| name | El nombre del recurso | string Constraints: Longitud mínima = 3 Longitud máxima = 26 Patrón = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (obligatorio) |
| properties | Propiedades de DevCenter | DevCenterProperties |
| tags | Etiquetas de recursos | Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas |
CustomerManagedKeyEncryption
| Name | Description | Value |
|---|---|---|
| keyEncryptionKeyIdentity | Toda la configuración de identidad para la configuración de clave administrada por el cliente que define qué identidad se debe usar para autenticarse en Key Vault. | CustomerManagedKeyEncryptionKeyIdentity |
| keyEncryptionKeyUrl | URL de clave de cifrado, versionada o no versionada. Por ejemplo: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 o https://contosovault.vault.azure.net/keys/contosokek. |
string |
CustomerManagedKeyEncryptionKeyIdentity
| Name | Description | Value |
|---|---|---|
| delegatedIdentityClientId | identidad delegada que se va a usar para acceder a la dirección URL de la clave de cifrado de claves. Por ejemplo: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente excluyente con identityType systemAssignedIdentity y userAssignedIdentity: solo uso interno. | string Constraints: Longitud mínima = 36 Longitud máxima = 36 Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| identityType | Los valores pueden ser systemAssignedIdentity o userAssignedIdentity | 'delegatedResourceIdentity' 'systemAssignedIdentity' 'userAssignedIdentity' |
| userAssignedIdentityResourceId | identidad asignada por el usuario que se usará para acceder a la dirección URL de la clave de cifrado de claves. Por ejemplo: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente excluyente con identityType systemAssignedIdentity y delegatedResourceIdentity. | string |
DevBoxProvisioningSettings
| Name | Description | Value |
|---|---|---|
| installAzureMonitorAgentEnableStatus | Si los catálogos de proyectos asociados a proyectos de este centro de desarrollo se pueden configurar para sincronizar elementos de catálogo. | 'Disabled' 'Enabled' |
DevCenterNetworkSettings
| Name | Description | Value |
|---|---|---|
| microsoftHostedNetworkEnableStatus | Indica si los grupos de este Centro de desarrollo pueden usar redes hospedadas de Microsoft. El valor predeterminado es Habilitado si no se establece. | 'Disabled' 'Enabled' |
DevCenterProjectCatalogSettings
| Name | Description | Value |
|---|---|---|
| catalogItemSyncEnableStatus | Si los catálogos de proyectos asociados a proyectos de este centro de desarrollo se pueden configurar para sincronizar elementos de catálogo. | 'Disabled' 'Enabled' |
DevCenterProperties
| Name | Description | Value |
|---|---|---|
| devBoxProvisioningSettings | Configuración que se usará en el aprovisionamiento de todos los cuadros de desarrollo que pertenecen a este centro de desarrollo. | DevBoxProvisioningSettings |
| displayName | Nombre para mostrar del centro de desarrollo. | string |
| encryption | Configuración de cifrado que se usará para el cifrado del lado servidor para el contenido propietario (como catálogos, registros, personalizaciones). | Encryption |
| networkSettings | Configuración de red que se aplicará en los recursos de red asociados al Centro de desarrollo. | DevCenterNetworkSettings |
| projectCatalogSettings | Configuración del Centro de desarrollo que se usará al asociar un proyecto con un catálogo. | DevCenterProjectCatalogSettings |
Encryption
| Name | Description | Value |
|---|---|---|
| customerManagedKeyEncryption | Todas las propiedades de cifrado de claves administradas por el cliente para el recurso. | CustomerManagedKeyEncryption |
ManagedServiceIdentity
| Name | Description | Value |
|---|---|---|
| type | Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). | 'None' 'SystemAssigned' 'Asignado al sistema, asignado al usuario' 'UserAssigned' (obligatorio) |
| userAssignedIdentities | Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. | UserAssignedIdentities |
TrackedResourceTags
| Name | Description | Value |
|---|
UserAssignedIdentities
| Name | Description | Value |
|---|
UserAssignedIdentity
| Name | Description | Value |
|---|
Ejemplos de uso
Módulos comprobados de Azure
Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.
| Module | Description |
|---|---|
| Centro de desarrollo | Módulo de recursos de AVM para el Centro de desarrollo |
Ejemplos de inicio rápido de Azure
Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.
| Archivo de Bicep | Description |
|---|---|
| Configurar entornos de implementación | Esta plantilla proporciona una manera de configurar entornos de implementación. |
| configuración del servicio Dev Box | Esta plantilla crearía todos los recursos de administración de Dev Box según la guía de inicio rápido de Dev Box (/azure/dev-box/quickstart-create-dev-box). Puede ver todos los recursos creados o ir directamente a DevPortal.microsoft.com para crear su primer cuadro de desarrollo. |
| Implementación del servicio Dev Box | Esta plantilla proporciona una forma de configurar todos los recursos necesarios para crear un Dev Box. |
| Implementación de Dev Box Service con una imagen integrada | Esta plantilla proporciona una manera de implementar un servicio Dev Box con una imagen integrada. |
Definición de recursos de plantilla de ARM
El tipo de recurso de los centros de desarrollo se puede implementar con operaciones destinadas a:
- grupos de recursos: consulte comandos de implementación de grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.DevCenter/devcenters, agregue el siguiente JSON a la plantilla.
{
"type": "Microsoft.DevCenter/devcenters",
"apiVersion": "2025-04-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"
}
}
Valores de propiedad
Microsoft.DevCenter/devcenters
| Name | Description | Value |
|---|---|---|
| apiVersion | La versión de api | '2025-04-01-preview' |
| identity | Propiedades de identidad administrada | ManagedServiceIdentity |
| location | Ubicación geográfica donde reside el recurso | string (obligatorio) |
| name | El nombre del recurso | string Constraints: Longitud mínima = 3 Longitud máxima = 26 Patrón = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (obligatorio) |
| properties | Propiedades de DevCenter | DevCenterProperties |
| tags | Etiquetas de recursos | Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas |
| type | El tipo de recurso | 'Microsoft.DevCenter/devcenters' |
CustomerManagedKeyEncryption
| Name | Description | Value |
|---|---|---|
| keyEncryptionKeyIdentity | Toda la configuración de identidad para la configuración de clave administrada por el cliente que define qué identidad se debe usar para autenticarse en Key Vault. | CustomerManagedKeyEncryptionKeyIdentity |
| keyEncryptionKeyUrl | URL de clave de cifrado, versionada o no versionada. Por ejemplo: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 o https://contosovault.vault.azure.net/keys/contosokek. |
string |
CustomerManagedKeyEncryptionKeyIdentity
| Name | Description | Value |
|---|---|---|
| delegatedIdentityClientId | identidad delegada que se va a usar para acceder a la dirección URL de la clave de cifrado de claves. Por ejemplo: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente excluyente con identityType systemAssignedIdentity y userAssignedIdentity: solo uso interno. | string Constraints: Longitud mínima = 36 Longitud máxima = 36 Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| identityType | Los valores pueden ser systemAssignedIdentity o userAssignedIdentity | 'delegatedResourceIdentity' 'systemAssignedIdentity' 'userAssignedIdentity' |
| userAssignedIdentityResourceId | identidad asignada por el usuario que se usará para acceder a la dirección URL de la clave de cifrado de claves. Por ejemplo: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente excluyente con identityType systemAssignedIdentity y delegatedResourceIdentity. | string |
DevBoxProvisioningSettings
| Name | Description | Value |
|---|---|---|
| installAzureMonitorAgentEnableStatus | Si los catálogos de proyectos asociados a proyectos de este centro de desarrollo se pueden configurar para sincronizar elementos de catálogo. | 'Disabled' 'Enabled' |
DevCenterNetworkSettings
| Name | Description | Value |
|---|---|---|
| microsoftHostedNetworkEnableStatus | Indica si los grupos de este Centro de desarrollo pueden usar redes hospedadas de Microsoft. El valor predeterminado es Habilitado si no se establece. | 'Disabled' 'Enabled' |
DevCenterProjectCatalogSettings
| Name | Description | Value |
|---|---|---|
| catalogItemSyncEnableStatus | Si los catálogos de proyectos asociados a proyectos de este centro de desarrollo se pueden configurar para sincronizar elementos de catálogo. | 'Disabled' 'Enabled' |
DevCenterProperties
| Name | Description | Value |
|---|---|---|
| devBoxProvisioningSettings | Configuración que se usará en el aprovisionamiento de todos los cuadros de desarrollo que pertenecen a este centro de desarrollo. | DevBoxProvisioningSettings |
| displayName | Nombre para mostrar del centro de desarrollo. | string |
| encryption | Configuración de cifrado que se usará para el cifrado del lado servidor para el contenido propietario (como catálogos, registros, personalizaciones). | Encryption |
| networkSettings | Configuración de red que se aplicará en los recursos de red asociados al Centro de desarrollo. | DevCenterNetworkSettings |
| projectCatalogSettings | Configuración del Centro de desarrollo que se usará al asociar un proyecto con un catálogo. | DevCenterProjectCatalogSettings |
Encryption
| Name | Description | Value |
|---|---|---|
| customerManagedKeyEncryption | Todas las propiedades de cifrado de claves administradas por el cliente para el recurso. | CustomerManagedKeyEncryption |
ManagedServiceIdentity
| Name | Description | Value |
|---|---|---|
| type | Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). | 'None' 'SystemAssigned' 'Asignado al sistema, asignado al usuario' 'UserAssigned' (obligatorio) |
| userAssignedIdentities | Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. | UserAssignedIdentities |
TrackedResourceTags
| Name | Description | Value |
|---|
UserAssignedIdentities
| Name | Description | Value |
|---|
UserAssignedIdentity
| Name | Description | Value |
|---|
Ejemplos de uso
Plantillas de inicio rápido de Azure
Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.
| Template | Description |
|---|---|
Configurar entornos de implementación
|
Esta plantilla proporciona una manera de configurar entornos de implementación. |
|
configuración del servicio Dev Box
|
Esta plantilla crearía todos los recursos de administración de Dev Box según la guía de inicio rápido de Dev Box (/azure/dev-box/quickstart-create-dev-box). Puede ver todos los recursos creados o ir directamente a DevPortal.microsoft.com para crear su primer cuadro de desarrollo. |
|
Implementación del servicio Dev Box
|
Esta plantilla proporciona una forma de configurar todos los recursos necesarios para crear un Dev Box. |
|
Implementación de Dev Box Service con una imagen integrada
|
Esta plantilla proporciona una manera de implementar un servicio Dev Box con una imagen integrada. |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso de los centros de desarrollo se puede implementar con operaciones destinadas a:
- Grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.DevCenter/devcenters, agregue el siguiente terraform a la plantilla.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DevCenter/devcenters@2025-04-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"
}
}
}
}
Valores de propiedad
Microsoft.DevCenter/devcenters
| Name | Description | Value |
|---|---|---|
| identity | Propiedades de identidad administrada | ManagedServiceIdentity |
| location | Ubicación geográfica donde reside el recurso | string (obligatorio) |
| name | El nombre del recurso | string Constraints: Longitud mínima = 3 Longitud máxima = 26 Patrón = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (obligatorio) |
| properties | Propiedades de DevCenter | DevCenterProperties |
| tags | Etiquetas de recursos | Diccionario de nombres y valores de etiqueta. |
| type | El tipo de recurso | "Microsoft.DevCenter/devcenters@2025-04-01-preview" |
CustomerManagedKeyEncryption
| Name | Description | Value |
|---|---|---|
| keyEncryptionKeyIdentity | Toda la configuración de identidad para la configuración de clave administrada por el cliente que define qué identidad se debe usar para autenticarse en Key Vault. | CustomerManagedKeyEncryptionKeyIdentity |
| keyEncryptionKeyUrl | URL de clave de cifrado, versionada o no versionada. Por ejemplo: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 o https://contosovault.vault.azure.net/keys/contosokek. |
string |
CustomerManagedKeyEncryptionKeyIdentity
| Name | Description | Value |
|---|---|---|
| delegatedIdentityClientId | identidad delegada que se va a usar para acceder a la dirección URL de la clave de cifrado de claves. Por ejemplo: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente excluyente con identityType systemAssignedIdentity y userAssignedIdentity: solo uso interno. | string Constraints: Longitud mínima = 36 Longitud máxima = 36 Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| identityType | Los valores pueden ser systemAssignedIdentity o userAssignedIdentity | 'delegatedResourceIdentity' 'systemAssignedIdentity' 'userAssignedIdentity' |
| userAssignedIdentityResourceId | identidad asignada por el usuario que se usará para acceder a la dirección URL de la clave de cifrado de claves. Por ejemplo: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente excluyente con identityType systemAssignedIdentity y delegatedResourceIdentity. | string |
DevBoxProvisioningSettings
| Name | Description | Value |
|---|---|---|
| installAzureMonitorAgentEnableStatus | Si los catálogos de proyectos asociados a proyectos de este centro de desarrollo se pueden configurar para sincronizar elementos de catálogo. | 'Disabled' 'Enabled' |
DevCenterNetworkSettings
| Name | Description | Value |
|---|---|---|
| microsoftHostedNetworkEnableStatus | Indica si los grupos de este Centro de desarrollo pueden usar redes hospedadas de Microsoft. El valor predeterminado es Habilitado si no se establece. | 'Disabled' 'Enabled' |
DevCenterProjectCatalogSettings
| Name | Description | Value |
|---|---|---|
| catalogItemSyncEnableStatus | Si los catálogos de proyectos asociados a proyectos de este centro de desarrollo se pueden configurar para sincronizar elementos de catálogo. | 'Disabled' 'Enabled' |
DevCenterProperties
| Name | Description | Value |
|---|---|---|
| devBoxProvisioningSettings | Configuración que se usará en el aprovisionamiento de todos los cuadros de desarrollo que pertenecen a este centro de desarrollo. | DevBoxProvisioningSettings |
| displayName | Nombre para mostrar del centro de desarrollo. | string |
| encryption | Configuración de cifrado que se usará para el cifrado del lado servidor para el contenido propietario (como catálogos, registros, personalizaciones). | Encryption |
| networkSettings | Configuración de red que se aplicará en los recursos de red asociados al Centro de desarrollo. | DevCenterNetworkSettings |
| projectCatalogSettings | Configuración del Centro de desarrollo que se usará al asociar un proyecto con un catálogo. | DevCenterProjectCatalogSettings |
Encryption
| Name | Description | Value |
|---|---|---|
| customerManagedKeyEncryption | Todas las propiedades de cifrado de claves administradas por el cliente para el recurso. | CustomerManagedKeyEncryption |
ManagedServiceIdentity
| Name | Description | Value |
|---|---|---|
| type | Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). | 'None' 'SystemAssigned' 'Asignado al sistema, asignado al usuario' 'UserAssigned' (obligatorio) |
| userAssignedIdentities | Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. | UserAssignedIdentities |
TrackedResourceTags
| Name | Description | Value |
|---|
UserAssignedIdentities
| Name | Description | Value |
|---|
UserAssignedIdentity
| Name | Description | Value |
|---|
Ejemplos de uso
Ejemplos de Terraform
Un ejemplo básico de implementación del Centro de desarrollo.
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"
}
}
Módulos comprobados de Azure
Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.
| Module | Description |
|---|---|
| Centro de desarrollo | Módulo de recursos de AVM para el Centro de desarrollo |