Partilhar via


Centros de desenvolvimento Microsoft.DevCenter

Definição de recursos do bíceps

O tipo de recurso devcenters pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.DevCenter/devcenters, adicione o seguinte Bicep ao seu modelo.

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 propriedade

Microsoft.DevCenter/devcenters

Name Description Value
identidade Propriedades de identidade gerenciadas. ManagedServiceIdentity
localização A geolocalização onde o recurso vive string (obrigatório)
name O nome do recurso string

Constraints:
Comprimento mínimo = 3
Comprimento máximo = 26
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (obrigatório)
properties Propriedades do DevCenter DevCenterProperties
âmbito Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .
tags Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

CustomerManagedKeyEncryption

Name Description Value
keyEncryptionKeyIdentity Toda a configuração de identidade para configurações de chave gerenciadas pelo cliente definindo qual identidade deve ser usada para autenticação no Cofre de Chaves. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl chave de criptografia Url, versionada ou não-versionada. Ex: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 ou https://contosovault.vault.azure.net/keys/contosokek. cadeia (de caracteres)

CustomerManagedKeyEncryptionKeyIdentity

Name Description Value
delegatedIdentityClientId identidade delegada a ser usada para acessar a chave de criptografia de chave Url. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente exclusivo com identityType systemAssignedIdentity e userAssignedIdentity - apenas para uso interno. string

Constraints:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType Os valores podem ser systemAssignedIdentity ou userAssignedIdentity 'delegatedResourceIdentity'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId identidade atribuída pelo usuário a ser usada para acessar a chave de criptografia de chave Url. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente exclusivo com identityType systemAssignedIdentity e delegatedResourceIdentity. cadeia (de caracteres)

DevBoxProvisioningSettings

Name Description Value
installAzureMonitorAgentEnableStatus Indica se o serviço Azure Monitor Agent deve ser instalado em Dev Boxes que pertencem a este centro de desenvolvimento 'Disabled'
'Enabled'

DevCenterNetworkSettings

Name Description Value
microsoftHostedNetworkEnableStatus Indica se os pools neste Centro de Desenvolvimento podem usar o Microsoft Hosted Networks. O padrão é Ativado se não estiver definido. 'Disabled'
'Enabled'

DevCenterProjectCatalogSettings

Name Description Value
catalogItemSyncEnableStatus Se os catálogos de projetos associados a projetos neste centro de desenvolvimento podem ser configurados para sincronizar itens de catálogo. 'Disabled'
'Enabled'

DevCenterProperties

Name Description Value
devBoxProvisioningSettings Configurações a serem usadas no provisionamento de todas as Dev Boxes que pertencem a este centro de desenvolvimento. DevBoxProvisioningSettings
displayName O nome de exibição do devcenter. cadeia (de caracteres)
cifragem Configurações de criptografia a serem usadas para criptografia do lado do servidor para conteúdo proprietário (como catálogos, logs, personalizações). Encryption
networkSettings Configurações de rede que serão impostas nos recursos de rede associados ao Centro de Desenvolvimento. DevCenterNetworkSettings
projectCatalogSettings Configurações do Centro de Desenvolvimento a serem usadas ao associar um projeto a um catálogo. DevCenterProjectCatalogSettings

Encryption

Name Description Value
customerManagedKeyEncryption Todas as propriedades de criptografia de chave gerenciadas pelo cliente para o recurso. CustomerManagedKeyEncryption

ManagedServiceIdentity

Name Description Value
tipo Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

Exemplos de uso

Módulos verificados do Azure

Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.

Module Description
Centro de Desenvolvimento Módulo de recursos do AVM para o Centro de Desenvolvimento

Exemplos de início rápido do Azure

Os seguintes modelos início rápido do Azure contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Description
de serviço Configurar Ambientes de Implantação Este modelo fornece uma maneira de configurar ambientes de implantação.
Configurar o serviço Caixa de Desenvolvimento Este modelo criaria todos os recursos de administração da Caixa de Desenvolvimento de acordo com o guia de início rápido da Caixa de Desenvolvimento (/azure/dev-box/quickstart-create-dev-box). Você pode visualizar todos os recursos criados ou ir diretamente para DevPortal.microsoft.com para criar sua primeira Caixa de Desenvolvimento.
Implantar o Serviço de Caixa de Desenvolvimento Este modelo fornece uma maneira de configurar todos os recursos necessários para criar uma Caixa de Desenvolvimento.
Implantar o Dev Box Service com de imagem interna Este modelo fornece uma maneira de implantar um serviço Dev Box com imagem interna.

Definição de recurso de modelo ARM

O tipo de recurso devcenters pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.DevCenter/devcenters, adicione o seguinte JSON ao seu modelo.

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

Microsoft.DevCenter/devcenters

Name Description Value
apiVersion A versão api '2025-10-01-pré-visualização'
identidade Propriedades de identidade gerenciadas. ManagedServiceIdentity
localização A geolocalização onde o recurso vive string (obrigatório)
name O nome do recurso string

Constraints:
Comprimento mínimo = 3
Comprimento máximo = 26
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (obrigatório)
properties Propriedades do DevCenter DevCenterProperties
tags Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.DevCenter/devcenters'

CustomerManagedKeyEncryption

Name Description Value
keyEncryptionKeyIdentity Toda a configuração de identidade para configurações de chave gerenciadas pelo cliente definindo qual identidade deve ser usada para autenticação no Cofre de Chaves. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl chave de criptografia Url, versionada ou não-versionada. Ex: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 ou https://contosovault.vault.azure.net/keys/contosokek. cadeia (de caracteres)

CustomerManagedKeyEncryptionKeyIdentity

Name Description Value
delegatedIdentityClientId identidade delegada a ser usada para acessar a chave de criptografia de chave Url. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente exclusivo com identityType systemAssignedIdentity e userAssignedIdentity - apenas para uso interno. string

Constraints:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType Os valores podem ser systemAssignedIdentity ou userAssignedIdentity 'delegatedResourceIdentity'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId identidade atribuída pelo usuário a ser usada para acessar a chave de criptografia de chave Url. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente exclusivo com identityType systemAssignedIdentity e delegatedResourceIdentity. cadeia (de caracteres)

DevBoxProvisioningSettings

Name Description Value
installAzureMonitorAgentEnableStatus Indica se o serviço Azure Monitor Agent deve ser instalado em Dev Boxes que pertencem a este centro de desenvolvimento 'Disabled'
'Enabled'

DevCenterNetworkSettings

Name Description Value
microsoftHostedNetworkEnableStatus Indica se os pools neste Centro de Desenvolvimento podem usar o Microsoft Hosted Networks. O padrão é Ativado se não estiver definido. 'Disabled'
'Enabled'

DevCenterProjectCatalogSettings

Name Description Value
catalogItemSyncEnableStatus Se os catálogos de projetos associados a projetos neste centro de desenvolvimento podem ser configurados para sincronizar itens de catálogo. 'Disabled'
'Enabled'

DevCenterProperties

Name Description Value
devBoxProvisioningSettings Configurações a serem usadas no provisionamento de todas as Dev Boxes que pertencem a este centro de desenvolvimento. DevBoxProvisioningSettings
displayName O nome de exibição do devcenter. cadeia (de caracteres)
cifragem Configurações de criptografia a serem usadas para criptografia do lado do servidor para conteúdo proprietário (como catálogos, logs, personalizações). Encryption
networkSettings Configurações de rede que serão impostas nos recursos de rede associados ao Centro de Desenvolvimento. DevCenterNetworkSettings
projectCatalogSettings Configurações do Centro de Desenvolvimento a serem usadas ao associar um projeto a um catálogo. DevCenterProjectCatalogSettings

Encryption

Name Description Value
customerManagedKeyEncryption Todas as propriedades de criptografia de chave gerenciadas pelo cliente para o recurso. CustomerManagedKeyEncryption

ManagedServiceIdentity

Name Description Value
tipo Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

Exemplos de uso

Modelos de início rápido do Azure

Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.

Template Description
de serviço Configurar Ambientes de Implantação

Implantar no Azure
Este modelo fornece uma maneira de configurar ambientes de implantação.
Configurar o serviço Caixa de Desenvolvimento

Implantar no Azure
Este modelo criaria todos os recursos de administração da Caixa de Desenvolvimento de acordo com o guia de início rápido da Caixa de Desenvolvimento (/azure/dev-box/quickstart-create-dev-box). Você pode visualizar todos os recursos criados ou ir diretamente para DevPortal.microsoft.com para criar sua primeira Caixa de Desenvolvimento.
Implantar o Serviço de Caixa de Desenvolvimento

Implantar no Azure
Este modelo fornece uma maneira de configurar todos os recursos necessários para criar uma Caixa de Desenvolvimento.
Implantar o Dev Box Service com de imagem interna

Implantar no Azure
Este modelo fornece uma maneira de implantar um serviço Dev Box com imagem interna.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso devcenters pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.DevCenter/devcenters, adicione o seguinte Terraform ao seu modelo.

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 propriedade

Microsoft.DevCenter/devcenters

Name Description Value
identidade Propriedades de identidade gerenciadas. ManagedServiceIdentity
localização A geolocalização onde o recurso vive string (obrigatório)
name O nome do recurso string

Constraints:
Comprimento mínimo = 3
Comprimento máximo = 26
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. string (obrigatório)
properties Propriedades do DevCenter DevCenterProperties
tags Etiquetas de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.DevCenter/devcenters@2025-10-01-preview"

CustomerManagedKeyEncryption

Name Description Value
keyEncryptionKeyIdentity Toda a configuração de identidade para configurações de chave gerenciadas pelo cliente definindo qual identidade deve ser usada para autenticação no Cofre de Chaves. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl chave de criptografia Url, versionada ou não-versionada. Ex: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 ou https://contosovault.vault.azure.net/keys/contosokek. cadeia (de caracteres)

CustomerManagedKeyEncryptionKeyIdentity

Name Description Value
delegatedIdentityClientId identidade delegada a ser usada para acessar a chave de criptografia de chave Url. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente exclusivo com identityType systemAssignedIdentity e userAssignedIdentity - apenas para uso interno. string

Constraints:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType Os valores podem ser systemAssignedIdentity ou userAssignedIdentity 'delegatedResourceIdentity'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId identidade atribuída pelo usuário a ser usada para acessar a chave de criptografia de chave Url. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente exclusivo com identityType systemAssignedIdentity e delegatedResourceIdentity. cadeia (de caracteres)

DevBoxProvisioningSettings

Name Description Value
installAzureMonitorAgentEnableStatus Indica se o serviço Azure Monitor Agent deve ser instalado em Dev Boxes que pertencem a este centro de desenvolvimento 'Disabled'
'Enabled'

DevCenterNetworkSettings

Name Description Value
microsoftHostedNetworkEnableStatus Indica se os pools neste Centro de Desenvolvimento podem usar o Microsoft Hosted Networks. O padrão é Ativado se não estiver definido. 'Disabled'
'Enabled'

DevCenterProjectCatalogSettings

Name Description Value
catalogItemSyncEnableStatus Se os catálogos de projetos associados a projetos neste centro de desenvolvimento podem ser configurados para sincronizar itens de catálogo. 'Disabled'
'Enabled'

DevCenterProperties

Name Description Value
devBoxProvisioningSettings Configurações a serem usadas no provisionamento de todas as Dev Boxes que pertencem a este centro de desenvolvimento. DevBoxProvisioningSettings
displayName O nome de exibição do devcenter. cadeia (de caracteres)
cifragem Configurações de criptografia a serem usadas para criptografia do lado do servidor para conteúdo proprietário (como catálogos, logs, personalizações). Encryption
networkSettings Configurações de rede que serão impostas nos recursos de rede associados ao Centro de Desenvolvimento. DevCenterNetworkSettings
projectCatalogSettings Configurações do Centro de Desenvolvimento a serem usadas ao associar um projeto a um catálogo. DevCenterProjectCatalogSettings

Encryption

Name Description Value
customerManagedKeyEncryption Todas as propriedades de criptografia de chave gerenciadas pelo cliente para o recurso. CustomerManagedKeyEncryption

ManagedServiceIdentity

Name Description Value
tipo Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

Exemplos de uso

Amostras Terraform

Um exemplo básico de implantação do Centro de Desenvolvimento.

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 verificados do Azure

Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.

Module Description
Centro de Desenvolvimento Módulo de recursos do AVM para o Centro de Desenvolvimento