Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
- 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 recursos do bíceps
O tipo de recurso devcenters pode ser implantado com operações que visam:
- Grupos de recursos - Consulte comandos de implantação de grupo de recursos
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-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 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 |
| 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 | 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 é 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:
- Grupos de recursos - Consulte comandos de implantação de grupo de recursos
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-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 de propriedade
Microsoft.DevCenter/devcenters
| Name | Description | Value |
|---|---|---|
| apiVersion | A versão api | '2025-04-01-preview' |
| 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 | 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 é 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 |
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 recursos Terraform (provedor AzAPI)
O tipo de recurso devcenters pode ser implantado com operações que visam:
- Grupos de recursos
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-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 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 |
| 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 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 | 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 é 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 |