Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
- Latest
- 2025-10-01-preview
- 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
Définition de ressource Bicep
Le type de ressource devcenters/devboxdefinitions 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/devboxdefinitions, ajoutez le bicep suivant à votre modèle.
resource symbolicname 'Microsoft.DevCenter/devcenters/devboxdefinitions@2025-10-01-preview' = {
parent: resourceSymbolicName
location: 'string'
name: 'string'
properties: {
hibernateSupport: 'string'
imageReference: {
id: 'string'
}
osStorageType: 'string'
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
}
tags: {
{customized property}: 'string'
}
}
Valeurs de propriété
Microsoft.DevCenter/devcenters/devboxdefinitions
| Name | Description | Value |
|---|---|---|
| location | Emplacement géographique où réside la ressource | chaîne (obligatoire) |
| name | Nom de la ressource | string Constraints: Longueur minimale = 3 Longueur maximale = 63 Modèle = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obligatoire) |
| parent | Dans Bicep, vous pouvez spécifier la ressource parente d’une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente. Pour plus d’informations, consultez ressource enfant en dehors de la ressource parente. |
Nom symbolique de la ressource de type : devcenters |
| properties | Propriétés de définition de la zone de développement | DevBoxDefinitionProperties |
| tags | Balises de ressources | Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles |
DevBoxDefinitionProperties
| Name | Description | Value |
|---|---|---|
| hibernateSupport | Indique si les zones de développement créées avec cette définition sont capables d’être mises en veille prolongée. Toutes les images ne sont pas capables de prendre en charge la mise en veille prolongée. Pour en savoir plus, consultez https://aka.ms/devbox/hibernate | 'Disabled' 'Enabled' |
| imageReference | Informations de référence sur l’image. | ImageReference |
| osStorageType | Type de stockage utilisé pour le disque du système d’exploitation des zones de développement créées à l’aide de cette définition. | string |
| sku | Référence SKU pour les zones de développement créées à l’aide de cette définition. | Sku |
ImageReference
| Name | Description | Value |
|---|---|---|
| id | ID d’image ou ID de version d’image. Lorsque l’ID d’image est fourni, sa dernière version sera utilisée. | string |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Si la référence SKU prend en charge le scale-out/in, l’entier de capacité doit être inclus. Si le scale-out/in n’est pas possible pour la ressource, cela peut être omis. | int |
| family | Si le service a différentes générations de matériel, pour la même référence SKU, vous pouvez le capturer ici. | string |
| name | Nom de la référence SKU. Par exemple P3. Il s’agit généralement d’une lettre+code numérique | chaîne (obligatoire) |
| size | Taille de la référence SKU. Lorsque le champ de nom est la combinaison de niveau et d’une autre valeur, il s’agit du code autonome. | string |
| tier | Ce champ doit être implémenté par le fournisseur de ressources si le service a plusieurs niveaux, mais n’est pas obligatoire sur un PUT. | 'Basic' 'Free' 'Premium' 'Standard' |
TrackedResourceTags
| Name | Description | Value |
|---|
Exemples d’utilisation
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 | Description |
|---|---|
| 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/devboxdefinitions 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/devboxdefinitions, ajoutez le code JSON suivant à votre modèle.
{
"type": "Microsoft.DevCenter/devcenters/devboxdefinitions",
"apiVersion": "2025-10-01-preview",
"name": "string",
"location": "string",
"properties": {
"hibernateSupport": "string",
"imageReference": {
"id": "string"
},
"osStorageType": "string",
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
}
},
"tags": {
"{customized property}": "string"
}
}
Valeurs de propriété
Microsoft.DevCenter/devcenters/devboxdefinitions
| Name | Description | Value |
|---|---|---|
| apiVersion | Version de l’API | '2025-10-01-preview' |
| location | Emplacement géographique où réside la ressource | chaîne (obligatoire) |
| name | Nom de la ressource | string Constraints: Longueur minimale = 3 Longueur maximale = 63 Modèle = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obligatoire) |
| properties | Propriétés de définition de la zone de développement | DevBoxDefinitionProperties |
| 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/devboxdefinitions' |
DevBoxDefinitionProperties
| Name | Description | Value |
|---|---|---|
| hibernateSupport | Indique si les zones de développement créées avec cette définition sont capables d’être mises en veille prolongée. Toutes les images ne sont pas capables de prendre en charge la mise en veille prolongée. Pour en savoir plus, consultez https://aka.ms/devbox/hibernate | 'Disabled' 'Enabled' |
| imageReference | Informations de référence sur l’image. | ImageReference |
| osStorageType | Type de stockage utilisé pour le disque du système d’exploitation des zones de développement créées à l’aide de cette définition. | string |
| sku | Référence SKU pour les zones de développement créées à l’aide de cette définition. | Sku |
ImageReference
| Name | Description | Value |
|---|---|---|
| id | ID d’image ou ID de version d’image. Lorsque l’ID d’image est fourni, sa dernière version sera utilisée. | string |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Si la référence SKU prend en charge le scale-out/in, l’entier de capacité doit être inclus. Si le scale-out/in n’est pas possible pour la ressource, cela peut être omis. | int |
| family | Si le service a différentes générations de matériel, pour la même référence SKU, vous pouvez le capturer ici. | string |
| name | Nom de la référence SKU. Par exemple P3. Il s’agit généralement d’une lettre+code numérique | chaîne (obligatoire) |
| size | Taille de la référence SKU. Lorsque le champ de nom est la combinaison de niveau et d’une autre valeur, il s’agit du code autonome. | string |
| tier | Ce champ doit être implémenté par le fournisseur de ressources si le service a plusieurs niveaux, mais n’est pas obligatoire sur un PUT. | 'Basic' 'Free' 'Premium' 'Standard' |
TrackedResourceTags
| Name | Description | Value |
|---|
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 | Description |
|---|---|
|
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 Terraform (fournisseur AzAPI)
Le type de ressource devcenters/devboxdefinitions 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/devboxdefinitions, ajoutez la terraform suivante à votre modèle.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DevCenter/devcenters/devboxdefinitions@2025-10-01-preview"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
hibernateSupport = "string"
imageReference = {
id = "string"
}
osStorageType = "string"
sku = {
capacity = int
family = "string"
name = "string"
size = "string"
tier = "string"
}
}
}
}
Valeurs de propriété
Microsoft.DevCenter/devcenters/devboxdefinitions
| Name | Description | Value |
|---|---|---|
| location | Emplacement géographique où réside la ressource | chaîne (obligatoire) |
| name | Nom de la ressource | string Constraints: Longueur minimale = 3 Longueur maximale = 63 Modèle = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obligatoire) |
| parent_id | ID de la ressource qui est le parent de cette ressource. | ID de ressource de type : devcenters |
| properties | Propriétés de définition de la zone de développement | DevBoxDefinitionProperties |
| tags | Balises de ressources | Dictionnaire de noms et de valeurs d’étiquettes. |
| type | Type de ressource | « Microsoft.DevCenter/devcenters/devboxdefinitions@2025-10-01-preview » |
DevBoxDefinitionProperties
| Name | Description | Value |
|---|---|---|
| hibernateSupport | Indique si les zones de développement créées avec cette définition sont capables d’être mises en veille prolongée. Toutes les images ne sont pas capables de prendre en charge la mise en veille prolongée. Pour en savoir plus, consultez https://aka.ms/devbox/hibernate | 'Disabled' 'Enabled' |
| imageReference | Informations de référence sur l’image. | ImageReference |
| osStorageType | Type de stockage utilisé pour le disque du système d’exploitation des zones de développement créées à l’aide de cette définition. | string |
| sku | Référence SKU pour les zones de développement créées à l’aide de cette définition. | Sku |
ImageReference
| Name | Description | Value |
|---|---|---|
| id | ID d’image ou ID de version d’image. Lorsque l’ID d’image est fourni, sa dernière version sera utilisée. | string |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Si la référence SKU prend en charge le scale-out/in, l’entier de capacité doit être inclus. Si le scale-out/in n’est pas possible pour la ressource, cela peut être omis. | int |
| family | Si le service a différentes générations de matériel, pour la même référence SKU, vous pouvez le capturer ici. | string |
| name | Nom de la référence SKU. Par exemple P3. Il s’agit généralement d’une lettre+code numérique | chaîne (obligatoire) |
| size | Taille de la référence SKU. Lorsque le champ de nom est la combinaison de niveau et d’une autre valeur, il s’agit du code autonome. | string |
| tier | Ce champ doit être implémenté par le fournisseur de ressources si le service a plusieurs niveaux, mais n’est pas obligatoire sur un PUT. | 'Basic' 'Free' 'Premium' 'Standard' |
TrackedResourceTags
| Name | Description | Value |
|---|
Exemples d’utilisation
Échantillons Terraform
Exemple de base de déploiement de la définition de la boîte de développement du Centre de développement.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
provider "azurerm" {
features {
}
}
data "azurerm_client_config" "current" {
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "devCenter" {
type = "Microsoft.DevCenter/devcenters@2023-04-01"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
identity = {
type = "SystemAssigned"
userAssignedIdentities = null
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
resource "azapi_resource" "devBoxDefinition" {
type = "Microsoft.DevCenter/devcenters/devboxdefinitions@2024-10-01-preview"
parent_id = azapi_resource.devCenter.id
name = var.resource_name
location = var.location
body = {
properties = {
hibernateSupport = "Enabled"
imageReference = {
id = "${azapi_resource.devCenter.id}/galleries/default/images/microsoftvisualstudio_visualstudioplustools_vs-2022-ent-general-win10-m365-gen2"
},
sku = {
name = "general_i_8c32gb256ssd_v2"
}
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}