Microsoft. DevCenter devcenters/devboxdefinitions

Bicep kaynak tanımı

Devcenters/devboxdefinitions kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kullanım Örnekleri

Bicep Örnekleri

Geliştirme Merkezi Geliştirme Kutusu Tanımını dağıtmanın temel bir örneği.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource devCenter 'Microsoft.DevCenter/devcenters@2023-04-01' = {
  name: resourceName
  location: location
  identity: {
    type: 'SystemAssigned'
  }
}

resource devBoxDefinition 'Microsoft.DevCenter/devcenters/devboxdefinitions@2024-10-01-preview' = {
  name: resourceName
  location: location
  parent: devCenter
  properties: {
    hibernateSupport: 'Enabled'
    imageReference: {
      id: '${devCenter.id}/galleries/default/images/microsoftvisualstudio_visualstudioplustools_vs-2022-ent-general-win10-m365-gen2'
    }
    sku: {
      name: 'general_i_8c32gb256ssd_v2'
    }
  }
}

Azure Doğrulanmış Modülleri

Aşağıdaki Azure Doğrulanmış Modüller bu kaynak türünü dağıtmak için kullanılabilir.

Module Description
Dev Center - Devbox tanımı Dev Center için AVM Child Modülü - Devboxdefinition

Azure Hızlı Başlangıç Örnekleri

Aşağıdaki Azure Hızlı Başlangıç şablonları bu kaynak türünü dağıtmak için Bicep örnekleri içerir.

Bicep Dosyası Description
Dev Box hizmetini yapılandırma Bu şablon, Dev Box hızlı başlangıç kılavuzuna (/azure/dev-box/quickstart-create-dev-box) göre tüm Dev Box yönetici kaynaklarını oluşturur. Oluşturulan tüm kaynakları görüntüleyebilir veya doğrudan DevPortal.microsoft.com giderek ilk Geliştirme Kutunuzu oluşturabilirsiniz.
Yerleşik görüntü ile Dev Box Hizmeti Dağıtma Bu şablon, yerleşik görüntüye sahip bir Dev Box hizmeti dağıtmanın bir yolunu sağlar.

Kaynak biçimi

Microsoft.DevCenter/devcenters/devboxdefinitions kaynağı oluşturmak için şablonunuza aşağıdaki Bicep'i ekleyin.

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

Özellik Değerleri

Microsoft.DevCenter/devcenters/devboxdefinitions

Name Description Value
location Kaynağın bulunduğu coğrafi konum dize (gerekli)
name Kaynak adı string

Constraints:
En az uzunluk = 3
Maksimum uzunluk = 63
Desen = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (gerekli)
parent Bicep'te bir alt kaynak için üst kaynak belirtebilirsiniz. Bu özelliği yalnızca alt kaynak üst kaynağın dışında bildirildiğinde eklemeniz gerekir.

Daha fazla bilgi için bkz. Alt kaynaküst kaynak dışında.
Tür kaynağı için sembolik ad: devcenters
properties Dev Box tanım özellikleri DevBoxDefinitionProperties
tags Kaynak etiketleri Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri

DevBoxDefinitionProperties

Name Description Value
hibernateSupport Bu tanım ile oluşturulan Geliştirme Kutularının hazırda bekleme özelliğine sahip olup olmadığını gösterir. Tüm görüntüler hazırda beklemeyi destekleme özelliğine sahip değildir. Daha fazla bilgi edinmek için bkz. https://aka.ms/devbox/hibernate 'Disabled'
'Enabled'
imageReference Görüntü başvuru bilgileri. ImageReference
osStorageType Bu tanım kullanılarak oluşturulan Geliştirme Kutularının İşletim Sistemi diski için kullanılan depolama türü. string
sku Bu tanım kullanılarak oluşturulan Geliştirme Kutuları için SKU. Sku

ImageReference

Name Description Value
id Görüntü Kimliği veya Görüntü sürümü kimliği. Görüntü Kimliği sağlandığında en son sürümü kullanılır. string

Sku

Name Description Value
capacity SKU ölçeği genişletmeyi/genişletmeyi destekliyorsa kapasite tamsayısı dahil edilmelidir. Kaynak için ölçeği genişletme/daraltma mümkün değilse bu atlanabilir. int
family Hizmetin aynı SKU için farklı donanım nesilleri varsa, bu burada yakalanabilir. string
name SKU'nun adı. Örneğin P3. Bu genellikle bir harf+sayı kodudur dize (gerekli)
size SKU boyutu. Ad alanı katman ile başka bir değerin birleşimi olduğunda, bu tek başına kod olacaktır. string
tier Hizmetin birden fazla katmanı varsa, ancak PUT üzerinde gerekli değilse, bu alanın Kaynak Sağlayıcısı tarafından uygulanması gerekir. 'Basic'
'Free'
'Premium'
'Standard'

TrackedResourceTags

Name Description Value

ARM şablonu kaynak tanımı

Devcenters/devboxdefinitions kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

Kullanım Örnekleri

Azure Hızlı Başlangıç Şablonları

Aşağıdaki Azure Hızlı Başlangıç şablonları bu kaynak türünü dağıtmak.

Template Description
Dev Box hizmetini yapılandırma

Azure 'a dağıtma
Bu şablon, Dev Box hızlı başlangıç kılavuzuna (/azure/dev-box/quickstart-create-dev-box) göre tüm Dev Box yönetici kaynaklarını oluşturur. Oluşturulan tüm kaynakları görüntüleyebilir veya doğrudan DevPortal.microsoft.com giderek ilk Geliştirme Kutunuzu oluşturabilirsiniz.
Yerleşik görüntü ile Dev Box Hizmeti Dağıtma

Azure 'a dağıtma
Bu şablon, yerleşik görüntüye sahip bir Dev Box hizmeti dağıtmanın bir yolunu sağlar.

Kaynak biçimi

Microsoft.DevCenter/devcenters/devboxdefinitions kaynağı oluşturmak için şablonunuza aşağıdaki JSON'u ekleyin.

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

Özellik Değerleri

Microsoft.DevCenter/devcenters/devboxdefinitions

Name Description Value
apiVersion API sürümü '2026-01-01-önizleme'
location Kaynağın bulunduğu coğrafi konum dize (gerekli)
name Kaynak adı string

Constraints:
En az uzunluk = 3
Maksimum uzunluk = 63
Desen = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (gerekli)
properties Dev Box tanım özellikleri DevBoxDefinitionProperties
tags Kaynak etiketleri Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri
type Kaynak türü 'Microsoft.DevCenter/devcenters/devboxdefinitions'

DevBoxDefinitionProperties

Name Description Value
hibernateSupport Bu tanım ile oluşturulan Geliştirme Kutularının hazırda bekleme özelliğine sahip olup olmadığını gösterir. Tüm görüntüler hazırda beklemeyi destekleme özelliğine sahip değildir. Daha fazla bilgi edinmek için bkz. https://aka.ms/devbox/hibernate 'Disabled'
'Enabled'
imageReference Görüntü başvuru bilgileri. ImageReference
osStorageType Bu tanım kullanılarak oluşturulan Geliştirme Kutularının İşletim Sistemi diski için kullanılan depolama türü. string
sku Bu tanım kullanılarak oluşturulan Geliştirme Kutuları için SKU. Sku

ImageReference

Name Description Value
id Görüntü Kimliği veya Görüntü sürümü kimliği. Görüntü Kimliği sağlandığında en son sürümü kullanılır. string

Sku

Name Description Value
capacity SKU ölçeği genişletmeyi/genişletmeyi destekliyorsa kapasite tamsayısı dahil edilmelidir. Kaynak için ölçeği genişletme/daraltma mümkün değilse bu atlanabilir. int
family Hizmetin aynı SKU için farklı donanım nesilleri varsa, bu burada yakalanabilir. string
name SKU'nun adı. Örneğin P3. Bu genellikle bir harf+sayı kodudur dize (gerekli)
size SKU boyutu. Ad alanı katman ile başka bir değerin birleşimi olduğunda, bu tek başına kod olacaktır. string
tier Hizmetin birden fazla katmanı varsa, ancak PUT üzerinde gerekli değilse, bu alanın Kaynak Sağlayıcısı tarafından uygulanması gerekir. 'Basic'
'Free'
'Premium'
'Standard'

TrackedResourceTags

Name Description Value

Terraform (AzAPI sağlayıcısı) kaynak tanımı

Devcenters/devboxdefinitions kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

Kullanım Örnekleri

Terraform Örnekleri

Geliştirme Merkezi Geliştirme Kutusu Tanımını dağıtmanın temel bir örneği.

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

Kaynak biçimi

Microsoft.DevCenter/devcenters/devboxdefinitions kaynağı oluşturmak için şablonunuza aşağıdaki Terraform'u ekleyin.

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

Özellik Değerleri

Microsoft.DevCenter/devcenters/devboxdefinitions

Name Description Value
location Kaynağın bulunduğu coğrafi konum dize (gerekli)
name Kaynak adı string

Constraints:
En az uzunluk = 3
Maksimum uzunluk = 63
Desen = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (gerekli)
parent_id Bu kaynağın üst öğesi olan kaynağın kimliği. Tür kaynağı kimliği: devcenters
properties Dev Box tanım özellikleri DevBoxDefinitionProperties
tags Kaynak etiketleri Etiket adları ve değerleri sözlüğü.
type Kaynak türü "Microsoft.DevCenter/devcenters/devboxdefinitions@2026-01-01-preview"

DevBoxDefinitionProperties

Name Description Value
hibernateSupport Bu tanım ile oluşturulan Geliştirme Kutularının hazırda bekleme özelliğine sahip olup olmadığını gösterir. Tüm görüntüler hazırda beklemeyi destekleme özelliğine sahip değildir. Daha fazla bilgi edinmek için bkz. https://aka.ms/devbox/hibernate 'Disabled'
'Enabled'
imageReference Görüntü başvuru bilgileri. ImageReference
osStorageType Bu tanım kullanılarak oluşturulan Geliştirme Kutularının İşletim Sistemi diski için kullanılan depolama türü. string
sku Bu tanım kullanılarak oluşturulan Geliştirme Kutuları için SKU. Sku

ImageReference

Name Description Value
id Görüntü Kimliği veya Görüntü sürümü kimliği. Görüntü Kimliği sağlandığında en son sürümü kullanılır. string

Sku

Name Description Value
capacity SKU ölçeği genişletmeyi/genişletmeyi destekliyorsa kapasite tamsayısı dahil edilmelidir. Kaynak için ölçeği genişletme/daraltma mümkün değilse bu atlanabilir. int
family Hizmetin aynı SKU için farklı donanım nesilleri varsa, bu burada yakalanabilir. string
name SKU'nun adı. Örneğin P3. Bu genellikle bir harf+sayı kodudur dize (gerekli)
size SKU boyutu. Ad alanı katman ile başka bir değerin birleşimi olduğunda, bu tek başına kod olacaktır. string
tier Hizmetin birden fazla katmanı varsa, ancak PUT üzerinde gerekli değilse, bu alanın Kaynak Sağlayıcısı tarafından uygulanması gerekir. 'Basic'
'Free'
'Premium'
'Standard'

TrackedResourceTags

Name Description Value