Compartilhar via


Centros de desenvolvimento Microsoft.DevCenter

Definição de recurso do Bicep

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

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

Formato de recurso

Para criar um recurso Microsoft.DevCenter/devcenters, adicione o Bicep a seguir ao 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 da propriedade

Microsoft.DevCenter/devcenters

Name Description Value
identidade Propriedades de identidade gerenciada. ManagedServiceIdentity
local A localização geográfica onde o recurso reside cadeia de caracteres (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 Centro de Desenvolvimento DevCenterProperties
escopo 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 marca. Consulte Marcas em modelos

CustomerManagedKeyEncryption

Name Description Value
keyEncryptionKeyIdentity Toda a configuração de identidade para configurações de chave gerenciada pelo cliente definindo qual identidade deve ser usada para autenticar no Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl URL da chave de criptografia de chave, com versão ou sem versão. Ex: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 ou https://contosovault.vault.azure.net/keys/contosokek. cadeia

CustomerManagedKeyEncryptionKeyIdentity

Name Description Value
delegatedIdentityClientId identidade delegada a ser usada para acessar a URL da chave de criptografia de chave. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente exclusivo com identityType systemAssignedIdentity e userAssignedIdentity - somente 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 URL da chave de criptografia de chave. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente exclusivo com identityType systemAssignedIdentity e delegatedResourceIdentity. cadeia

DevBoxProvisioningSettings

Name Description Value
installAzureMonitorAgentEnableStatus Indica se o serviço Agente do Azure Monitor deve ser instalado em Computadores de Desenvolvimento 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 será Habilitado se não for 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 Caixas de Desenvolvimento que pertencem a esse centro de desenvolvimento. DevBoxProvisioningSettings
displayName O nome de exibição do devcenter. cadeia
criptografia 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 em 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 gerenciada pelo cliente para o recurso. CustomerManagedKeyEncryption

ManagedServiceIdentity

Name Description Value
tipo Tipo de identidade de serviço gerenciado (em que 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 do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do 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

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

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

Exemplos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir contêm exemplos de Bicep para implantar esse tipo de recurso.

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

Definição de recurso de modelo do ARM

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

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

Formato de recurso

Para criar um recurso Microsoft.DevCenter/devcenters, adicione o JSON a seguir ao 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 da propriedade

Microsoft.DevCenter/devcenters

Name Description Value
apiVersion A versão da API '2025-10-01-preview'
identidade Propriedades de identidade gerenciada. ManagedServiceIdentity
local A localização geográfica onde o recurso reside cadeia de caracteres (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 Centro de Desenvolvimento DevCenterProperties
tags Etiquetas de recursos Dicionário de nomes e valores de marca. Consulte Marcas 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 gerenciada pelo cliente definindo qual identidade deve ser usada para autenticar no Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl URL da chave de criptografia de chave, com versão ou sem versão. Ex: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 ou https://contosovault.vault.azure.net/keys/contosokek. cadeia

CustomerManagedKeyEncryptionKeyIdentity

Name Description Value
delegatedIdentityClientId identidade delegada a ser usada para acessar a URL da chave de criptografia de chave. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente exclusivo com identityType systemAssignedIdentity e userAssignedIdentity - somente 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 URL da chave de criptografia de chave. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente exclusivo com identityType systemAssignedIdentity e delegatedResourceIdentity. cadeia

DevBoxProvisioningSettings

Name Description Value
installAzureMonitorAgentEnableStatus Indica se o serviço Agente do Azure Monitor deve ser instalado em Computadores de Desenvolvimento 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 será Habilitado se não for 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 Caixas de Desenvolvimento que pertencem a esse centro de desenvolvimento. DevBoxProvisioningSettings
displayName O nome de exibição do devcenter. cadeia
criptografia 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 em 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 gerenciada pelo cliente para o recurso. CustomerManagedKeyEncryption

ManagedServiceIdentity

Name Description Value
tipo Tipo de identidade de serviço gerenciado (em que 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 do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do 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 modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

Template Description
configurar o serviço ambientes de implantação

Implantar no Azure
Esse modelo fornece uma maneira de configurar ambientes de implantação.
configurar de serviço do Dev Box

Implantar no Azure
Esse modelo criaria todos os recursos de administrador do Dev Box de acordo com o guia de início rápido do Dev Box (/azure/dev-box/quickstart-create-dev-box). Você pode exibir todos os recursos criados ou ir diretamente para DevPortal.microsoft.com para criar sua primeira Caixa de Desenvolvimento.
Implantar o serviço de computador de desenvolvimento

Implantar no Azure
Este modelo fornece uma maneira de configurar todos os recursos necessários para criar um Computador de Desenvolvimento.
implantar o Serviço de Caixa de Desenvolvimento com de imagem interna

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

Definição de recurso do Terraform (provedor de AzAPI)

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

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

Formato de recurso

Para criar um recurso Microsoft.DevCenter/devcenters, adicione o Terraform a seguir 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 da propriedade

Microsoft.DevCenter/devcenters

Name Description Value
identidade Propriedades de identidade gerenciada. ManagedServiceIdentity
local A localização geográfica onde o recurso reside cadeia de caracteres (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. cadeia de caracteres (obrigatório)
properties Propriedades do Centro de Desenvolvimento DevCenterProperties
tags Etiquetas de recursos Dicionário de nomes e valores de marca.
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 gerenciada pelo cliente definindo qual identidade deve ser usada para autenticar no Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl URL da chave de criptografia de chave, com versão ou sem versão. Ex: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 ou https://contosovault.vault.azure.net/keys/contosokek. cadeia

CustomerManagedKeyEncryptionKeyIdentity

Name Description Value
delegatedIdentityClientId identidade delegada a ser usada para acessar a URL da chave de criptografia de chave. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente exclusivo com identityType systemAssignedIdentity e userAssignedIdentity - somente 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 URL da chave de criptografia de chave. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente exclusivo com identityType systemAssignedIdentity e delegatedResourceIdentity. cadeia

DevBoxProvisioningSettings

Name Description Value
installAzureMonitorAgentEnableStatus Indica se o serviço Agente do Azure Monitor deve ser instalado em Computadores de Desenvolvimento 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 será Habilitado se não for 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 Caixas de Desenvolvimento que pertencem a esse centro de desenvolvimento. DevBoxProvisioningSettings
displayName O nome de exibição do devcenter. cadeia
criptografia 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 em 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 gerenciada pelo cliente para o recurso. CustomerManagedKeyEncryption

ManagedServiceIdentity

Name Description Value
tipo Tipo de identidade de serviço gerenciado (em que 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 do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do 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

Exemplos do 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

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

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