Freigeben über


Microsoft.DevCenter devcenters/devboxdefinitions

Bicep-Ressourcendefinition

Der Ressourcentyp devcenters/devboxdefinitions kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.DevCenter/devcenters/devboxdefinitions-Ressource zu erstellen, fügen Sie ihrer Vorlage die folgende Bicep hinzu.

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

Eigenschaftswerte

Microsoft.DevCenter/devcenters/devboxdefinitions

Name Description Value
location Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
name Der Ressourcenname string

Constraints:
Min. Länge = 3
Max. Länge = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (erforderlich)
parent In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.

Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.
Symbolischer Name für Ressource des Typs: devcenters
properties Dev Box-Definitionseigenschaften DevBoxDefinitionProperties
tags Ressourcenetiketten Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

DevBoxDefinitionProperties

Name Description Value
hibernateSupport Gibt an, ob dev Boxes, die mit dieser Definition erstellt wurden, in der Lage sind, ruhen zu können. Nicht alle Bilder sind in der Lage, den Ruhezustand zu unterstützen. Weitere Informationen finden Sie unter https://aka.ms/devbox/hibernate 'Disabled'
'Enabled'
imageReference Bildreferenzinformationen. ImageReference
osStorageType Der Speichertyp, der für den Betriebssystemdatenträger von Dev Boxes verwendet wird, der mit dieser Definition erstellt wurde. string
sku Die mit dieser Definition erstellte SKU für Dev-Felder. Sku

ImageReference

Name Description Value
id Bild-ID oder Bildversions-ID. Wenn Bild-ID bereitgestellt wird, wird die neueste Version verwendet. string

Sku

Name Description Value
capacity Wenn die SKU skalierungs-/in unterstützt, sollte die Ganze Kapazität eingeschlossen werden. Wenn eine Skalierung für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen. int
family Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden. string
name Der Name der SKU. Z.B. P3. Es handelt sich in der Regel um einen Buchstaben+Zahlencode. Zeichenfolge (erforderlich)
size Die SKU-Größe. Wenn das Namensfeld die Kombination aus Ebene und einem anderen Wert ist, wäre dies der eigenständige Code. string
tier Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst mehr als eine Ebene aufweist, für einen PUT jedoch nicht erforderlich ist. 'Basic'
'Free'
'Premium'
'Standard'

TrackedResourceTags

Name Description Value

Verwendungsbeispiele

Azure-Schnellstartbeispiele

Die folgenden Azure-Schnellstartvorlagen Bicep-Beispiele für die Bereitstellung dieses Ressourcentyps enthalten.

Bicep-Datei Description
Konfigurieren des Dev Box-Diensts Diese Vorlage würde alle Dev Box-Administratorressourcen gemäß dev Box-Schnellstarthandbuch (/azure/dev-box/quickstart-create-dev-box) erstellen. Sie können alle erstellten Ressourcen anzeigen oder direkt zu DevPortal.microsoft.com wechseln, um Ihr erstes Dev Box zu erstellen.
Bereitstellen des Dev Box-Diensts Diese Vorlage bietet eine Möglichkeit, alle Ressourcen zu konfigurieren, die zum Erstellen einer Dev Box erforderlich sind.
Bereitstellen von Dev Box Service mit integriertem Image- Diese Vorlage bietet eine Möglichkeit, einen Dev Box-Dienst mit integriertem Image bereitzustellen.

ARM-Vorlagenressourcendefinition

Der Ressourcentyp devcenters/devboxdefinitions kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.DevCenter/devcenters/devboxdefinitions-Ressource zu erstellen, fügen Sie Ihrer Vorlage den folgenden JSON-Code hinzu.

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

Eigenschaftswerte

Microsoft.DevCenter/devcenters/devboxdefinitions

Name Description Value
apiVersion Die API-Version '2025-10-01-Vorschau'
location Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
name Der Ressourcenname string

Constraints:
Min. Länge = 3
Max. Länge = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (erforderlich)
properties Dev Box-Definitionseigenschaften DevBoxDefinitionProperties
tags Ressourcenetiketten Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
type Der Ressourcentyp 'Microsoft.DevCenter/devcenters/devboxdefinitions'

DevBoxDefinitionProperties

Name Description Value
hibernateSupport Gibt an, ob dev Boxes, die mit dieser Definition erstellt wurden, in der Lage sind, ruhen zu können. Nicht alle Bilder sind in der Lage, den Ruhezustand zu unterstützen. Weitere Informationen finden Sie unter https://aka.ms/devbox/hibernate 'Disabled'
'Enabled'
imageReference Bildreferenzinformationen. ImageReference
osStorageType Der Speichertyp, der für den Betriebssystemdatenträger von Dev Boxes verwendet wird, der mit dieser Definition erstellt wurde. string
sku Die mit dieser Definition erstellte SKU für Dev-Felder. Sku

ImageReference

Name Description Value
id Bild-ID oder Bildversions-ID. Wenn Bild-ID bereitgestellt wird, wird die neueste Version verwendet. string

Sku

Name Description Value
capacity Wenn die SKU skalierungs-/in unterstützt, sollte die Ganze Kapazität eingeschlossen werden. Wenn eine Skalierung für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen. int
family Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden. string
name Der Name der SKU. Z.B. P3. Es handelt sich in der Regel um einen Buchstaben+Zahlencode. Zeichenfolge (erforderlich)
size Die SKU-Größe. Wenn das Namensfeld die Kombination aus Ebene und einem anderen Wert ist, wäre dies der eigenständige Code. string
tier Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst mehr als eine Ebene aufweist, für einen PUT jedoch nicht erforderlich ist. 'Basic'
'Free'
'Premium'
'Standard'

TrackedResourceTags

Name Description Value

Verwendungsbeispiele

Azure-Schnellstartvorlagen

Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.

Template Description
Konfigurieren des Dev Box-Diensts

Bereitstellen in Azure
Diese Vorlage würde alle Dev Box-Administratorressourcen gemäß dev Box-Schnellstarthandbuch (/azure/dev-box/quickstart-create-dev-box) erstellen. Sie können alle erstellten Ressourcen anzeigen oder direkt zu DevPortal.microsoft.com wechseln, um Ihr erstes Dev Box zu erstellen.
Bereitstellen des Dev Box-Diensts

Bereitstellen in Azure
Diese Vorlage bietet eine Möglichkeit, alle Ressourcen zu konfigurieren, die zum Erstellen einer Dev Box erforderlich sind.
Bereitstellen von Dev Box Service mit integriertem Image-

Bereitstellen in Azure
Diese Vorlage bietet eine Möglichkeit, einen Dev Box-Dienst mit integriertem Image bereitzustellen.

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp devcenters/devboxdefinitions kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.DevCenter/devcenters/devboxdefinitions-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

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

Eigenschaftswerte

Microsoft.DevCenter/devcenters/devboxdefinitions

Name Description Value
location Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
name Der Ressourcenname string

Constraints:
Min. Länge = 3
Max. Länge = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (erforderlich)
parent_id Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource des Typs: devcenters
properties Dev Box-Definitionseigenschaften DevBoxDefinitionProperties
tags Ressourcenetiketten Wörterbuch der Tagnamen und -werte.
type Der Ressourcentyp "Microsoft.DevCenter/devcenters/devboxdefinitions@2025-10-01-preview"

DevBoxDefinitionProperties

Name Description Value
hibernateSupport Gibt an, ob dev Boxes, die mit dieser Definition erstellt wurden, in der Lage sind, ruhen zu können. Nicht alle Bilder sind in der Lage, den Ruhezustand zu unterstützen. Weitere Informationen finden Sie unter https://aka.ms/devbox/hibernate 'Disabled'
'Enabled'
imageReference Bildreferenzinformationen. ImageReference
osStorageType Der Speichertyp, der für den Betriebssystemdatenträger von Dev Boxes verwendet wird, der mit dieser Definition erstellt wurde. string
sku Die mit dieser Definition erstellte SKU für Dev-Felder. Sku

ImageReference

Name Description Value
id Bild-ID oder Bildversions-ID. Wenn Bild-ID bereitgestellt wird, wird die neueste Version verwendet. string

Sku

Name Description Value
capacity Wenn die SKU skalierungs-/in unterstützt, sollte die Ganze Kapazität eingeschlossen werden. Wenn eine Skalierung für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen. int
family Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden. string
name Der Name der SKU. Z.B. P3. Es handelt sich in der Regel um einen Buchstaben+Zahlencode. Zeichenfolge (erforderlich)
size Die SKU-Größe. Wenn das Namensfeld die Kombination aus Ebene und einem anderen Wert ist, wäre dies der eigenständige Code. string
tier Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst mehr als eine Ebene aufweist, für einen PUT jedoch nicht erforderlich ist. 'Basic'
'Free'
'Premium'
'Standard'

TrackedResourceTags

Name Description Value

Verwendungsbeispiele

Terraform-Beispiele

Ein grundlegendes Beispiel für die Bereitstellung der Dev Center Dev Box-Definition.

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    = ["*"]
}