Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
- Latest
- 2026-01-01-preview
- 2025-10-01-visualização
- 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
Definição de recurso do Bicep
O tipo de recurso de devcenters pode ser implantado com operações de destino:
- Grupos de recursos - Consulte comandos de implantação do grupo de recursos
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-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 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 |
| tags | Etiquetas de recursos | Dicionário de nomes e valores de tags. Ver 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 | Se os catálogos de projetos associados a projetos neste centro de desenvolvimento podem ser configurados para sincronizar itens de catálogo. | '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:
- Grupos de recursos - Consulte comandos de implantação do grupo de recursos
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-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 da propriedade
Microsoft.DevCenter/devcenters
| Name | Description | Value |
|---|---|---|
| apiVersion | A versão da API | '2025-04-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 tags. Ver 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 | Se os catálogos de projetos associados a projetos neste centro de desenvolvimento podem ser configurados para sincronizar itens de catálogo. | '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 |
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 do Terraform (provedor de AzAPI)
O tipo de recurso de devcenters pode ser implantado com operações de destino:
- Grupos de recursos
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-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 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 |
| tags | Etiquetas de recursos | Dicionário de nomes e valores de tags. |
| tipo | O tipo de recurso | "Microsoft.DevCenter/devcenters@2025-04-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 | Se os catálogos de projetos associados a projetos neste centro de desenvolvimento podem ser configurados para sincronizar itens de catálogo. | '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 |