Partager via


Projets Microsoft.DevCenter 2023-08-01-preview

Définition de ressource Bicep

Le type de ressource de projets 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/projects, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.DevCenter/projects@2023-08-01-preview' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  properties: {
    description: 'string'
    devCenterId: 'string'
    maxDevBoxesPerUser: int
  }
  tags: {
    {customized property}: 'string'
  }
}

Valeurs de propriété

Microsoft.DevCenter/projects

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)
properties Propriétés d’un projet. ProjectProperties
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

ProjectProperties

Name Description Value
description Description du projet. string
devCenterId ID de ressource d’un DevCenter associé string
maxDevBoxesPerUser Lorsqu’il est spécifié, limite le nombre maximal de boîtes de développement qu’un seul utilisateur peut créer sur tous les pools du projet. Cela n’aura aucun effet sur les zones de développement existantes lorsqu’elles sont réduites. int

Constraints:
Valeur minimale = 0

TrackedResourceTags

Name Description Value

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 Description
Projet de centre de développement Module de ressources AVM pour le projet du Dev Center

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 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 de projets 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/projects, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.DevCenter/projects",
  "apiVersion": "2023-08-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "description": "string",
    "devCenterId": "string",
    "maxDevBoxesPerUser": "int"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valeurs de propriété

Microsoft.DevCenter/projects

Name Description Value
apiVersion Version de l’API '2023-08-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 d’un projet. ProjectProperties
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/projects'

ProjectProperties

Name Description Value
description Description du projet. string
devCenterId ID de ressource d’un DevCenter associé string
maxDevBoxesPerUser Lorsqu’il est spécifié, limite le nombre maximal de boîtes de développement qu’un seul utilisateur peut créer sur tous les pools du projet. Cela n’aura aucun effet sur les zones de développement existantes lorsqu’elles sont réduites. int

Constraints:
Valeur minimale = 0

TrackedResourceTags

Name Description Value

Exemples d’utilisation

Modèles de démarrage rapide Azure

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

Template Description
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 de projets 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/projects, ajoutez terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/projects@2023-08-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      description = "string"
      devCenterId = "string"
      maxDevBoxesPerUser = int
    }
  }
}

Valeurs de propriété

Microsoft.DevCenter/projects

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 à laquelle appliquer cette ressource d’extension. chaîne (obligatoire)
properties Propriétés d’un projet. ProjectProperties
tags Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource "Microsoft.DevCenter/projects@2023-08-01-preview"

ProjectProperties

Name Description Value
description Description du projet. string
devCenterId ID de ressource d’un DevCenter associé string
maxDevBoxesPerUser Lorsqu’il est spécifié, limite le nombre maximal de boîtes de développement qu’un seul utilisateur peut créer sur tous les pools du projet. Cela n’aura aucun effet sur les zones de développement existantes lorsqu’elles sont réduites. int

Constraints:
Valeur minimale = 0

TrackedResourceTags

Name Description Value

Exemples d’utilisation

Échantillons Terraform

Un exemple de base de déploiement d’un projet 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 = "westus"
}

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@2025-02-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  identity {
    type = "SystemAssigned"
  }
  body = {
    properties = {}
  }
}

resource "azapi_resource" "project" {
  type      = "Microsoft.DevCenter/projects@2025-02-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}-proj"
  location  = var.location
  body = {
    properties = {
      description        = ""
      devCenterId        = azapi_resource.devCenter.id
      maxDevBoxesPerUser = 0
    }
  }
}