Compartir a través de


Microsoft.DevCenter devcenters

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

Implementación en Azure
Esta plantilla proporciona una manera de configurar entornos de implementación.
configuración del servicio Dev Box

Implementación en Azure
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

Implementación en Azure
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

Implementación en Azure
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