Partager via


Projets/pools Microsoft.DevCenter

Définition de ressource Bicep

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

resource symbolicname 'Microsoft.DevCenter/projects/pools@2025-10-01-preview' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    activeHoursConfiguration: {
      autoStartEnableStatus: 'string'
      daysOfWeekLimit: int
      defaultDaysOfWeek: [
        'string'
      ]
      defaultEndTimeHour: int
      defaultStartTimeHour: int
      defaultTimeZone: 'string'
      keepAwakeEnableStatus: 'string'
    }
    devBoxDefinition: {
      imageReference: {
        id: 'string'
      }
      sku: {
        capacity: int
        family: 'string'
        name: 'string'
        size: 'string'
        tier: 'string'
      }
    }
    devBoxDefinitionName: 'string'
    devBoxDefinitionType: 'string'
    devBoxTunnelEnableStatus: 'string'
    displayName: 'string'
    licenseType: 'string'
    localAdministrator: 'string'
    managedVirtualNetworkRegions: [
      'string'
    ]
    networkConnectionName: 'string'
    singleSignOnStatus: 'string'
    stopOnDisconnect: {
      gracePeriodMinutes: int
      status: 'string'
    }
    stopOnNoConnect: {
      gracePeriodMinutes: int
      status: 'string'
    }
    virtualNetworkType: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valeurs de propriété

Microsoft.DevCenter/projects/pools

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 : projets
properties Propriétés de la piscine PoolProperties
tags Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

ActiveHoursConfiguration

Name Description Value
autoStartEnableStatus Active ou désactive si la zone de développement doit être démarrée automatiquement au début des heures d’activité. 'Disabled'
'Enabled'
daysOfWeekLimit Nombre maximal de jours par semaine pendant lesquels un utilisateur peut activer les fonctionnalités liées aux heures d’activité. int
defaultDaysOfWeek Les jours de la semaine où les fonctionnalités d’heures actives seront activées. Il s’agit d’une valeur par défaut qui peut être mise à jour par chaque utilisateur. Tableau de chaînes contenant l’un des éléments suivants :
'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Wednesday'
defaultEndTimeHour Heure de fin par défaut des heures actives. int
defaultStartTimeHour Heure de début par défaut des heures actives. int
defaultTimeZone ID de fuseau horaire IANA par défaut des heures actives. string
keepAwakeEnableStatus Active ou désactive si la boîte de développement doit être conservée éveillée pendant les heures d’activité. 'Disabled'
'Enabled'

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

PoolDevBoxDefinition

Name Description Value
imageReference Informations de référence sur l’image. ImageReference
sku Référence SKU pour les zones de développement créées à partir du pool. Sku

PoolProperties

Name Description Value
activeHoursConfiguration Paramètres de configuration des heures actives pour les Dev Box créées dans ce pool. ActiveHoursConfiguration
devBoxDefinition Définition des machines créées à partir de ce pool. Est ignoré si devBoxDefinitionType est Référence ou non fourni. PoolDevBoxDefinition
devBoxDefinitionName Nom d’une définition de zone de développement dans le projet parent de ce pool. Est ignoré si devBoxDefinitionType est Value. string
devBoxDefinitionType Indique si le pool est créé à partir d’une définition de zone de développement existante ou s’il est fourni directement. 'Reference'
'Value'
devBoxTunnelEnableStatus Indique si le tunnel Dev Box est activé pour le pool. 'Disabled'
'Enabled'
displayName Nom complet du pool. string
licenseType Spécifie le type de licence indiquant que l’appelant a déjà acquis des licences pour les zones de développement qui seront créées. 'Windows_Client'
localAdministrator Indique si les propriétaires des zones de développement de ce pool sont ajoutés en tant qu’administrateurs locaux sur la zone de développement. 'Disabled'
'Enabled'
managedVirtualNetworkRegions Régions du réseau virtuel managé (obligatoire lorsque managedNetworkType est géré). string[]
networkConnectionName Nom d’une connexion réseau dans le projet parent de ce pool. string
singleSignOnStatus Indique si les zones de développement de ce pool sont créées avec l’authentification unique activée. L’authentification unique doit également être activée sur le locataire. 'Disabled'
'Enabled'
stopOnDisconnect Arrêtez les paramètres de configuration de déconnexion pour les zones de développement créées dans ce pool. StopOnDisconnectConfiguration
stopOnNoConnect Arrêtez-vous sur aucun paramètre de configuration de connexion pour les zones de développement créées dans ce pool. StopOnNoConnectConfiguration
virtualNetworkType Indique si le pool utilise un réseau virtuel géré par Microsoft ou un réseau fourni par le client. 'Managed'
'Unmanaged'

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'

StopOnDisconnectConfiguration

Name Description Value
gracePeriodMinutes Heure spécifiée en minutes à attendre avant d’arrêter une zone de développement une fois la déconnexion détectée. int
status Indique si la fonctionnalité pour arrêter la boîte de développement lors de la déconnexion une fois la période de grâce expirée est activée. 'Disabled'
'Enabled'

StopOnNoConnectConfiguration

Name Description Value
gracePeriodMinutes Heure spécifiée en minutes à attendre avant d’arrêter une zone de développement si aucune connexion n’est établie. int
status Permet à la fonctionnalité d’arrêter une boîte de développement démarrée lorsqu’elle n’a pas été connectée, une fois la période de grâce expirée. 'Disabled'
'Enabled'

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

{
  "type": "Microsoft.DevCenter/projects/pools",
  "apiVersion": "2025-10-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "activeHoursConfiguration": {
      "autoStartEnableStatus": "string",
      "daysOfWeekLimit": "int",
      "defaultDaysOfWeek": [ "string" ],
      "defaultEndTimeHour": "int",
      "defaultStartTimeHour": "int",
      "defaultTimeZone": "string",
      "keepAwakeEnableStatus": "string"
    },
    "devBoxDefinition": {
      "imageReference": {
        "id": "string"
      },
      "sku": {
        "capacity": "int",
        "family": "string",
        "name": "string",
        "size": "string",
        "tier": "string"
      }
    },
    "devBoxDefinitionName": "string",
    "devBoxDefinitionType": "string",
    "devBoxTunnelEnableStatus": "string",
    "displayName": "string",
    "licenseType": "string",
    "localAdministrator": "string",
    "managedVirtualNetworkRegions": [ "string" ],
    "networkConnectionName": "string",
    "singleSignOnStatus": "string",
    "stopOnDisconnect": {
      "gracePeriodMinutes": "int",
      "status": "string"
    },
    "stopOnNoConnect": {
      "gracePeriodMinutes": "int",
      "status": "string"
    },
    "virtualNetworkType": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valeurs de propriété

Microsoft.DevCenter/projects/pools

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 la piscine PoolProperties
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/pools'

ActiveHoursConfiguration

Name Description Value
autoStartEnableStatus Active ou désactive si la zone de développement doit être démarrée automatiquement au début des heures d’activité. 'Disabled'
'Enabled'
daysOfWeekLimit Nombre maximal de jours par semaine pendant lesquels un utilisateur peut activer les fonctionnalités liées aux heures d’activité. int
defaultDaysOfWeek Les jours de la semaine où les fonctionnalités d’heures actives seront activées. Il s’agit d’une valeur par défaut qui peut être mise à jour par chaque utilisateur. Tableau de chaînes contenant l’un des éléments suivants :
'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Wednesday'
defaultEndTimeHour Heure de fin par défaut des heures actives. int
defaultStartTimeHour Heure de début par défaut des heures actives. int
defaultTimeZone ID de fuseau horaire IANA par défaut des heures actives. string
keepAwakeEnableStatus Active ou désactive si la boîte de développement doit être conservée éveillée pendant les heures d’activité. 'Disabled'
'Enabled'

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

PoolDevBoxDefinition

Name Description Value
imageReference Informations de référence sur l’image. ImageReference
sku Référence SKU pour les zones de développement créées à partir du pool. Sku

PoolProperties

Name Description Value
activeHoursConfiguration Paramètres de configuration des heures actives pour les Dev Box créées dans ce pool. ActiveHoursConfiguration
devBoxDefinition Définition des machines créées à partir de ce pool. Est ignoré si devBoxDefinitionType est Référence ou non fourni. PoolDevBoxDefinition
devBoxDefinitionName Nom d’une définition de zone de développement dans le projet parent de ce pool. Est ignoré si devBoxDefinitionType est Value. string
devBoxDefinitionType Indique si le pool est créé à partir d’une définition de zone de développement existante ou s’il est fourni directement. 'Reference'
'Value'
devBoxTunnelEnableStatus Indique si le tunnel Dev Box est activé pour le pool. 'Disabled'
'Enabled'
displayName Nom complet du pool. string
licenseType Spécifie le type de licence indiquant que l’appelant a déjà acquis des licences pour les zones de développement qui seront créées. 'Windows_Client'
localAdministrator Indique si les propriétaires des zones de développement de ce pool sont ajoutés en tant qu’administrateurs locaux sur la zone de développement. 'Disabled'
'Enabled'
managedVirtualNetworkRegions Régions du réseau virtuel managé (obligatoire lorsque managedNetworkType est géré). string[]
networkConnectionName Nom d’une connexion réseau dans le projet parent de ce pool. string
singleSignOnStatus Indique si les zones de développement de ce pool sont créées avec l’authentification unique activée. L’authentification unique doit également être activée sur le locataire. 'Disabled'
'Enabled'
stopOnDisconnect Arrêtez les paramètres de configuration de déconnexion pour les zones de développement créées dans ce pool. StopOnDisconnectConfiguration
stopOnNoConnect Arrêtez-vous sur aucun paramètre de configuration de connexion pour les zones de développement créées dans ce pool. StopOnNoConnectConfiguration
virtualNetworkType Indique si le pool utilise un réseau virtuel géré par Microsoft ou un réseau fourni par le client. 'Managed'
'Unmanaged'

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'

StopOnDisconnectConfiguration

Name Description Value
gracePeriodMinutes Heure spécifiée en minutes à attendre avant d’arrêter une zone de développement une fois la déconnexion détectée. int
status Indique si la fonctionnalité pour arrêter la boîte de développement lors de la déconnexion une fois la période de grâce expirée est activée. 'Disabled'
'Enabled'

StopOnNoConnectConfiguration

Name Description Value
gracePeriodMinutes Heure spécifiée en minutes à attendre avant d’arrêter une zone de développement si aucune connexion n’est établie. int
status Permet à la fonctionnalité d’arrêter une boîte de développement démarrée lorsqu’elle n’a pas été connectée, une fois la période de grâce expirée. 'Disabled'
'Enabled'

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/projects/pools@2025-10-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      activeHoursConfiguration = {
        autoStartEnableStatus = "string"
        daysOfWeekLimit = int
        defaultDaysOfWeek = [
          "string"
        ]
        defaultEndTimeHour = int
        defaultStartTimeHour = int
        defaultTimeZone = "string"
        keepAwakeEnableStatus = "string"
      }
      devBoxDefinition = {
        imageReference = {
          id = "string"
        }
        sku = {
          capacity = int
          family = "string"
          name = "string"
          size = "string"
          tier = "string"
        }
      }
      devBoxDefinitionName = "string"
      devBoxDefinitionType = "string"
      devBoxTunnelEnableStatus = "string"
      displayName = "string"
      licenseType = "string"
      localAdministrator = "string"
      managedVirtualNetworkRegions = [
        "string"
      ]
      networkConnectionName = "string"
      singleSignOnStatus = "string"
      stopOnDisconnect = {
        gracePeriodMinutes = int
        status = "string"
      }
      stopOnNoConnect = {
        gracePeriodMinutes = int
        status = "string"
      }
      virtualNetworkType = "string"
    }
  }
}

Valeurs de propriété

Microsoft.DevCenter/projects/pools

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 : projets
properties Propriétés de la piscine PoolProperties
tags Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.DevCenter/projects/pools@2025-10-01-preview »

ActiveHoursConfiguration

Name Description Value
autoStartEnableStatus Active ou désactive si la zone de développement doit être démarrée automatiquement au début des heures d’activité. 'Disabled'
'Enabled'
daysOfWeekLimit Nombre maximal de jours par semaine pendant lesquels un utilisateur peut activer les fonctionnalités liées aux heures d’activité. int
defaultDaysOfWeek Les jours de la semaine où les fonctionnalités d’heures actives seront activées. Il s’agit d’une valeur par défaut qui peut être mise à jour par chaque utilisateur. Tableau de chaînes contenant l’un des éléments suivants :
'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Wednesday'
defaultEndTimeHour Heure de fin par défaut des heures actives. int
defaultStartTimeHour Heure de début par défaut des heures actives. int
defaultTimeZone ID de fuseau horaire IANA par défaut des heures actives. string
keepAwakeEnableStatus Active ou désactive si la boîte de développement doit être conservée éveillée pendant les heures d’activité. 'Disabled'
'Enabled'

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

PoolDevBoxDefinition

Name Description Value
imageReference Informations de référence sur l’image. ImageReference
sku Référence SKU pour les zones de développement créées à partir du pool. Sku

PoolProperties

Name Description Value
activeHoursConfiguration Paramètres de configuration des heures actives pour les Dev Box créées dans ce pool. ActiveHoursConfiguration
devBoxDefinition Définition des machines créées à partir de ce pool. Est ignoré si devBoxDefinitionType est Référence ou non fourni. PoolDevBoxDefinition
devBoxDefinitionName Nom d’une définition de zone de développement dans le projet parent de ce pool. Est ignoré si devBoxDefinitionType est Value. string
devBoxDefinitionType Indique si le pool est créé à partir d’une définition de zone de développement existante ou s’il est fourni directement. 'Reference'
'Value'
devBoxTunnelEnableStatus Indique si le tunnel Dev Box est activé pour le pool. 'Disabled'
'Enabled'
displayName Nom complet du pool. string
licenseType Spécifie le type de licence indiquant que l’appelant a déjà acquis des licences pour les zones de développement qui seront créées. 'Windows_Client'
localAdministrator Indique si les propriétaires des zones de développement de ce pool sont ajoutés en tant qu’administrateurs locaux sur la zone de développement. 'Disabled'
'Enabled'
managedVirtualNetworkRegions Régions du réseau virtuel managé (obligatoire lorsque managedNetworkType est géré). string[]
networkConnectionName Nom d’une connexion réseau dans le projet parent de ce pool. string
singleSignOnStatus Indique si les zones de développement de ce pool sont créées avec l’authentification unique activée. L’authentification unique doit également être activée sur le locataire. 'Disabled'
'Enabled'
stopOnDisconnect Arrêtez les paramètres de configuration de déconnexion pour les zones de développement créées dans ce pool. StopOnDisconnectConfiguration
stopOnNoConnect Arrêtez-vous sur aucun paramètre de configuration de connexion pour les zones de développement créées dans ce pool. StopOnNoConnectConfiguration
virtualNetworkType Indique si le pool utilise un réseau virtuel géré par Microsoft ou un réseau fourni par le client. 'Managed'
'Unmanaged'

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'

StopOnDisconnectConfiguration

Name Description Value
gracePeriodMinutes Heure spécifiée en minutes à attendre avant d’arrêter une zone de développement une fois la déconnexion détectée. int
status Indique si la fonctionnalité pour arrêter la boîte de développement lors de la déconnexion une fois la période de grâce expirée est activée. 'Disabled'
'Enabled'

StopOnNoConnectConfiguration

Name Description Value
gracePeriodMinutes Heure spécifiée en minutes à attendre avant d’arrêter une zone de développement si aucune connexion n’est établie. int
status Permet à la fonctionnalité d’arrêter une boîte de développement démarrée lorsqu’elle n’a pas été connectée, une fois la période de grâce expirée. 'Disabled'
'Enabled'

TrackedResourceTags

Name Description Value