Partager via


Microsoft.DevCenter devcenters 2026-01-01-preview

Définition de ressource Bicep

Le type de ressource devcenters peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.DevCenter/devcenters, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.DevCenter/devcenters@2026-01-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'
  }
}

Valeurs de propriété

Microsoft.DevCenter/devcenters

Nom Descriptif Valeur
identity Propriétés d’identité managée. ManagedServiceIdentity
location Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource string

Constraints:
Longueur minimale = 3
Longueur maximale = 26
Modèle = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (obligatoire)
Propriétés Propriétés de DevCenter DevCenterProperties
portée Utilisez-la lors de la création d’une ressource dans une étendue différente de l’étendue de déploiement. Définissez cette propriété sur le nom symbolique d’une ressource pour appliquer la ressource d’extension .
tags Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

CustomerManagedKeyEncryption

Nom Descriptif Valeur
keyEncryptionKeyIdentity Toutes les configurations d’identité pour les paramètres de clé gérés par le client qui définissent l’identité à utiliser pour l’authentification auprès de Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl URL de clé de chiffrement de clé, versionnée ou non versionnée. Ex : https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 ou https://contosovault.vault.azure.net/keys/contosokek. ficelle

CustomerManagedKeyEncryptionKeyIdentity

Nom Descriptif Valeur
delegatedIdentityClientId identité déléguée à utiliser pour accéder à l’URL de clé de chiffrement de clé. Ex : /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<groupe de ressources>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuellement exclusif avec identityType systemAssignedIdentity et userAssignedIdentity - utilisation interne uniquement. string

Constraints:
Longueur minimale = 36
Longueur maximale = 36
Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType Les valeurs peuvent être systemAssignedIdentity ou userAssignedIdentity 'IdentitéRessource déléguée'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId identité affectée par l’utilisateur à utiliser pour accéder à l’URL de clé de chiffrement de clé. Ex : /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<groupe de ressources>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuellement exclusif avec identityType systemAssignedIdentity et delegatedResourceIdentity. ficelle

DevBoxProvisioningSettings

Nom Descriptif Valeur
installAzureMonitorAgentEnableStatus Indique s’il faut installer le service de l’agent Azure Monitor sur les Dev Box qui appartiennent à ce centre de développement 'Disabled'
'Enabled'

DevCenterNetworkSettings

Nom Descriptif Valeur
microsoftHostedNetworkEnableStatus Indique si les pools dans ce Centre de développement peuvent utiliser des réseaux hébergés Par Microsoft. La valeur par défaut est Activée si elle n’est pas définie. 'Disabled'
'Enabled'

DevCenterProjectCatalogSettings

Nom Descriptif Valeur
catalogItemSyncEnableStatus Indique si les catalogues de projets associés aux projets dans ce centre de développement peuvent être configurés pour synchroniser les éléments de catalogue. 'Disabled'
'Enabled'

DevCenterProperties

Nom Descriptif Valeur
devBoxProvisioningSettings Paramètres à utiliser dans l’approvisionnement de toutes les zones de développement appartenant à ce centre de développement. DevBoxProvisioningSettings
nom d’affichage Nom complet du devcenter. ficelle
encryption Paramètres de chiffrement à utiliser pour le chiffrement côté serveur pour le contenu propriétaire (tels que les catalogues, les journaux, les personnalisations). Chiffrement
networkSettings Paramètres réseau qui seront appliqués aux ressources réseau associées au Centre de développement. DevCenterNetworkSettings
projectCatalogSettings Paramètres du Centre de développement à utiliser lors de l’association d’un projet à un catalogue. DevCenterProjectCatalogSettings

Chiffrement

Nom Descriptif Valeur
customerManagedKeyEncryption Toutes les propriétés de chiffrement de clé gérées par le client pour la ressource. CustomerManagedKeyEncryption

ManagedServiceIdentity

Nom Descriptif Valeur
type Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés). « Aucun »
'SystemAssigned'
« SystemAssigned, UserAssigned »
'UserAssigned' (obligatoire)
userAssignedIdentities Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes. UserAssignedIdentities

TrackedResourceTags

Nom Descriptif Valeur

UserAssignedIdentities

Nom Descriptif Valeur

UserAssignedIdentity

Nom Descriptif Valeur

Exemples d’utilisation

Modules vérifiés Azure

Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.

Module Descriptif
Centre de développement Module de ressources AVM pour le Centre de développement

Exemples de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants contiennent des exemples Bicep pour le déploiement de ce type de ressource.

Fichier Bicep Descriptif
configurer le service Environnements de déploiement Ce modèle permet de configurer des environnements de déploiement.
configurer le service Dev Box Ce modèle crée toutes les ressources d’administration Dev Box en fonction du guide de démarrage rapide dev Box (/azure/dev-box/quickstart-create-dev-box). Vous pouvez afficher toutes les ressources créées ou accéder directement à DevPortal.microsoft.com pour créer votre première zone de développement.
Déployer le service Dev Box Ce modèle permet de configurer toutes les ressources requises pour créer une Dev Box.
déployer Dev Box Service avec des d’images intégrées Ce modèle permet de déployer un service Dev Box avec une image intégrée.

Définition de ressource de modèle ARM

Le type de ressource devcenters peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.DevCenter/devcenters, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.DevCenter/devcenters",
  "apiVersion": "2026-01-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"
  }
}

Valeurs de propriété

Microsoft.DevCenter/devcenters

Nom Descriptif Valeur
apiVersion Version de l’API « Aperçu 2026-01-01- »
identity Propriétés d’identité managée. ManagedServiceIdentity
location Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource string

Constraints:
Longueur minimale = 3
Longueur maximale = 26
Modèle = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (obligatoire)
Propriétés Propriétés de DevCenter DevCenterProperties
tags Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource 'Microsoft.DevCenter/devcenters'

CustomerManagedKeyEncryption

Nom Descriptif Valeur
keyEncryptionKeyIdentity Toutes les configurations d’identité pour les paramètres de clé gérés par le client qui définissent l’identité à utiliser pour l’authentification auprès de Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl URL de clé de chiffrement de clé, versionnée ou non versionnée. Ex : https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 ou https://contosovault.vault.azure.net/keys/contosokek. ficelle

CustomerManagedKeyEncryptionKeyIdentity

Nom Descriptif Valeur
delegatedIdentityClientId identité déléguée à utiliser pour accéder à l’URL de clé de chiffrement de clé. Ex : /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<groupe de ressources>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuellement exclusif avec identityType systemAssignedIdentity et userAssignedIdentity - utilisation interne uniquement. string

Constraints:
Longueur minimale = 36
Longueur maximale = 36
Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType Les valeurs peuvent être systemAssignedIdentity ou userAssignedIdentity 'IdentitéRessource déléguée'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId identité affectée par l’utilisateur à utiliser pour accéder à l’URL de clé de chiffrement de clé. Ex : /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<groupe de ressources>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuellement exclusif avec identityType systemAssignedIdentity et delegatedResourceIdentity. ficelle

DevBoxProvisioningSettings

Nom Descriptif Valeur
installAzureMonitorAgentEnableStatus Indique s’il faut installer le service de l’agent Azure Monitor sur les Dev Box qui appartiennent à ce centre de développement 'Disabled'
'Enabled'

DevCenterNetworkSettings

Nom Descriptif Valeur
microsoftHostedNetworkEnableStatus Indique si les pools dans ce Centre de développement peuvent utiliser des réseaux hébergés Par Microsoft. La valeur par défaut est Activée si elle n’est pas définie. 'Disabled'
'Enabled'

DevCenterProjectCatalogSettings

Nom Descriptif Valeur
catalogItemSyncEnableStatus Indique si les catalogues de projets associés aux projets dans ce centre de développement peuvent être configurés pour synchroniser les éléments de catalogue. 'Disabled'
'Enabled'

DevCenterProperties

Nom Descriptif Valeur
devBoxProvisioningSettings Paramètres à utiliser dans l’approvisionnement de toutes les zones de développement appartenant à ce centre de développement. DevBoxProvisioningSettings
nom d’affichage Nom complet du devcenter. ficelle
encryption Paramètres de chiffrement à utiliser pour le chiffrement côté serveur pour le contenu propriétaire (tels que les catalogues, les journaux, les personnalisations). Chiffrement
networkSettings Paramètres réseau qui seront appliqués aux ressources réseau associées au Centre de développement. DevCenterNetworkSettings
projectCatalogSettings Paramètres du Centre de développement à utiliser lors de l’association d’un projet à un catalogue. DevCenterProjectCatalogSettings

Chiffrement

Nom Descriptif Valeur
customerManagedKeyEncryption Toutes les propriétés de chiffrement de clé gérées par le client pour la ressource. CustomerManagedKeyEncryption

ManagedServiceIdentity

Nom Descriptif Valeur
type Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés). « Aucun »
'SystemAssigned'
« SystemAssigned, UserAssigned »
'UserAssigned' (obligatoire)
userAssignedIdentities Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes. UserAssignedIdentities

TrackedResourceTags

Nom Descriptif Valeur

UserAssignedIdentities

Nom Descriptif Valeur

UserAssignedIdentity

Nom Descriptif Valeur

Exemples d’utilisation

Modèles de démarrage rapide Microsoft Azure

Les modèles de démarrage rapide Azure suivants déployer ce type de ressource.

Template Descriptif
configurer le service Environnements de déploiement

Déployer sur Azure
Ce modèle permet de configurer des environnements de déploiement.
configurer le service Dev Box

Déployer sur Azure
Ce modèle crée toutes les ressources d’administration Dev Box en fonction du guide de démarrage rapide dev Box (/azure/dev-box/quickstart-create-dev-box). Vous pouvez afficher toutes les ressources créées ou accéder directement à DevPortal.microsoft.com pour créer votre première zone de développement.
Déployer le service Dev Box

Déployer sur Azure
Ce modèle permet de configurer toutes les ressources requises pour créer une Dev Box.
déployer Dev Box Service avec des d’images intégrées

Déployer sur Azure
Ce modèle permet de déployer un service Dev Box avec une image intégrée.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource devcenters peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.DevCenter/devcenters, ajoutez le terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/devcenters@2026-01-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"
      }
    }
  }
}

Valeurs de propriété

Microsoft.DevCenter/devcenters

Nom Descriptif Valeur
identity Propriétés d’identité managée. ManagedServiceIdentity
location Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource string

Constraints:
Longueur minimale = 3
Longueur maximale = 26
Modèle = ^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$ (obligatoire)
parent_id ID de la ressource à laquelle appliquer cette ressource d’extension. chaîne (obligatoire)
Propriétés Propriétés de DevCenter DevCenterProperties
tags Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.DevCenter/devcenters@2026-01-01-preview »

CustomerManagedKeyEncryption

Nom Descriptif Valeur
keyEncryptionKeyIdentity Toutes les configurations d’identité pour les paramètres de clé gérés par le client qui définissent l’identité à utiliser pour l’authentification auprès de Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl URL de clé de chiffrement de clé, versionnée ou non versionnée. Ex : https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 ou https://contosovault.vault.azure.net/keys/contosokek. ficelle

CustomerManagedKeyEncryptionKeyIdentity

Nom Descriptif Valeur
delegatedIdentityClientId identité déléguée à utiliser pour accéder à l’URL de clé de chiffrement de clé. Ex : /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<groupe de ressources>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuellement exclusif avec identityType systemAssignedIdentity et userAssignedIdentity - utilisation interne uniquement. string

Constraints:
Longueur minimale = 36
Longueur maximale = 36
Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType Les valeurs peuvent être systemAssignedIdentity ou userAssignedIdentity 'IdentitéRessource déléguée'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId identité affectée par l’utilisateur à utiliser pour accéder à l’URL de clé de chiffrement de clé. Ex : /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<groupe de ressources>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuellement exclusif avec identityType systemAssignedIdentity et delegatedResourceIdentity. ficelle

DevBoxProvisioningSettings

Nom Descriptif Valeur
installAzureMonitorAgentEnableStatus Indique s’il faut installer le service de l’agent Azure Monitor sur les Dev Box qui appartiennent à ce centre de développement 'Disabled'
'Enabled'

DevCenterNetworkSettings

Nom Descriptif Valeur
microsoftHostedNetworkEnableStatus Indique si les pools dans ce Centre de développement peuvent utiliser des réseaux hébergés Par Microsoft. La valeur par défaut est Activée si elle n’est pas définie. 'Disabled'
'Enabled'

DevCenterProjectCatalogSettings

Nom Descriptif Valeur
catalogItemSyncEnableStatus Indique si les catalogues de projets associés aux projets dans ce centre de développement peuvent être configurés pour synchroniser les éléments de catalogue. 'Disabled'
'Enabled'

DevCenterProperties

Nom Descriptif Valeur
devBoxProvisioningSettings Paramètres à utiliser dans l’approvisionnement de toutes les zones de développement appartenant à ce centre de développement. DevBoxProvisioningSettings
nom d’affichage Nom complet du devcenter. ficelle
encryption Paramètres de chiffrement à utiliser pour le chiffrement côté serveur pour le contenu propriétaire (tels que les catalogues, les journaux, les personnalisations). Chiffrement
networkSettings Paramètres réseau qui seront appliqués aux ressources réseau associées au Centre de développement. DevCenterNetworkSettings
projectCatalogSettings Paramètres du Centre de développement à utiliser lors de l’association d’un projet à un catalogue. DevCenterProjectCatalogSettings

Chiffrement

Nom Descriptif Valeur
customerManagedKeyEncryption Toutes les propriétés de chiffrement de clé gérées par le client pour la ressource. CustomerManagedKeyEncryption

ManagedServiceIdentity

Nom Descriptif Valeur
type Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés). « Aucun »
'SystemAssigned'
« SystemAssigned, UserAssigned »
'UserAssigned' (obligatoire)
userAssignedIdentities Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes. UserAssignedIdentities

TrackedResourceTags

Nom Descriptif Valeur

UserAssignedIdentities

Nom Descriptif Valeur

UserAssignedIdentity

Nom Descriptif Valeur

Exemples d’utilisation

Exemples Terraform

Un exemple de base de déploiement du Centre de développement.

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"
  }
}

Modules vérifiés Azure

Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.

Module Descriptif
Centre de développement Module de ressources AVM pour le Centre de développement