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
- 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:
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-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'
}
}
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 |
| scope | Use al crear un recurso en un ámbito diferente del ámbito de implementación. | Establezca esta propiedad en el nombre simbólico de un recurso para aplicar el recurso de extensión . |
| 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 | Indica si se debe instalar el servicio Agente de Azure Monitor en los equipos de desarrollo que pertenecen a este centro de desarrollo | '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:
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-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"
}
}
Valores de propiedad
Microsoft.DevCenter/devcenters
| Name | Description | Value |
|---|---|---|
| apiVersion | La versión de api | '2025-10-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 | Indica si se debe instalar el servicio Agente de Azure Monitor en los equipos de desarrollo que pertenecen a este centro de desarrollo | '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:
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-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"
}
}
}
}
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) |
| parent_id | Identificador del recurso al que se va a aplicar este recurso de extensión. | string (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-10-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 | Indica si se debe instalar el servicio Agente de Azure Monitor en los equipos de desarrollo que pertenecen a este centro de desarrollo | '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 |