Microsoft.DevCenter devcenters/devboxdefinitions

• Latest
• 2026-01-01-プレビュー
• 2025-10-01-プレビュー
• 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

Bicep リソース定義

devcenters/devboxdefinitions リソースの種類は、次をターゲットとする操作と共にデプロイできます。

• リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.DevCenter/devcenters/devboxdefinitions リソースを作成するには、次の Bicep をテンプレートに追加します。

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

プロパティ値

Microsoft.DevCenter/devcenters/devboxdefinitions

Name	Description	Value
位置	リソースが存在する地理的な場所	string (必須)
name	リソース名	string Constraints: 最小長 = 3 最大長 = 63 パターン = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (必須)
親	Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。 詳細については、「親リソースの外部 子リソース」を参照してください。	種類のリソースのシンボリック名: devcenters
properties	Dev Box 定義のプロパティ	DevBoxDefinitionProperties
tags	リソース タグ	タグ名と値のディクショナリ。 テンプレート の タグを参照してください

DevBoxDefinitionProperties

Name	Description	Value
hibernateSupport	この定義で作成された Dev Boxes が休止状態にできるかどうかを示します。 すべてのイメージが休止状態をサポートできるわけではありません。 詳細については、https://aka.ms/devbox/hibernate を参照してください。	'Disabled' 'Enabled'
imageReference	画像参照情報。	ImageReference
osStorageType	この定義を使用して作成された開発ボックスのオペレーティング システム ディスクに使用されるストレージの種類。	文字列
sku	この定義を使用して作成された開発ボックスの SKU。	Sku

ImageReference

Name	Description	Value
id	イメージ ID、またはイメージ バージョン ID。 イメージ ID を指定すると、その最新バージョンが使用されます。	文字列

Sku

Name	Description	Value
キャパシティ	SKU でスケールアウト/インがサポートされている場合は、容量の整数を含める必要があります。 リソースに対してスケールアウト/インができない場合は、これを省略できます。	int
family	同じ SKU に対して、サービスの世代が異なるハードウェアがある場合は、ここでキャプチャできます。	文字列
name	SKU の名前。 例: P3。 通常は文字 + 数字のコードです	string (必須)
size	SKU サイズ。 名前フィールドが層と他の値の組み合わせである場合、これはスタンドアロン コードになります。	文字列
レベル	このフィールドは、サービスに複数のレベルがあるが PUT では必要ない場合に、リソース プロバイダーによって実装される必要があります。	'Basic' 'Free' 'Premium' 'Standard'

TrackedResourceTags

Name	Description	Value

使用例

Bicep サンプル

デベロッパー センター開発ボックス定義のデプロイの基本的な例。

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

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

resource devBoxDefinition 'Microsoft.DevCenter/devcenters/devboxdefinitions@2024-10-01-preview' = {
  parent: devCenter
  name: resourceName
  location: location
  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 クイック スタートのサンプル

次 Azure クイック スタート テンプレート、このリソースの種類をデプロイするための Bicep サンプルが含まれています。

Bicep ファイル	Description
Dev Box サービス の構成	このテンプレートでは、Dev Box クイック スタート ガイド (/azure/dev-box/quickstart-create-dev-box) に従って、すべての Dev Box 管理リソースが作成されます。 作成されたすべてのリソースを表示することも、DevPortal.microsoft.com に直接移動して最初の Dev Box を作成することもできます。
組み込みのイメージ を使用して Dev Box Service をデプロイする	このテンプレートは、組み込みのイメージを使用して Dev Box サービスをデプロイする方法を提供します。

ARM テンプレート リソース定義

devcenters/devboxdefinitions リソースの種類は、次をターゲットとする操作と共にデプロイできます。

• リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.DevCenter/devcenters/devboxdefinitions リソースを作成するには、次の JSON をテンプレートに追加します。

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

プロパティ値

Microsoft.DevCenter/devcenters/devboxdefinitions

Name	Description	Value
apiVersion	API のバージョン	『2026-01-01-プレビュー』
位置	リソースが存在する地理的な場所	string (必須)
name	リソース名	string Constraints: 最小長 = 3 最大長 = 63 パターン = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (必須)
properties	Dev Box 定義のプロパティ	DevBoxDefinitionProperties
tags	リソース タグ	タグ名と値のディクショナリ。 テンプレート の タグを参照してください
型	リソースの種類	'Microsoft.DevCenter/devcenters/devboxdefinitions'

DevBoxDefinitionProperties

Name	Description	Value
hibernateSupport	この定義で作成された Dev Boxes が休止状態にできるかどうかを示します。 すべてのイメージが休止状態をサポートできるわけではありません。 詳細については、https://aka.ms/devbox/hibernate を参照してください。	'Disabled' 'Enabled'
imageReference	画像参照情報。	ImageReference
osStorageType	この定義を使用して作成された開発ボックスのオペレーティング システム ディスクに使用されるストレージの種類。	文字列
sku	この定義を使用して作成された開発ボックスの SKU。	Sku

ImageReference

Name	Description	Value
id	イメージ ID、またはイメージ バージョン ID。 イメージ ID を指定すると、その最新バージョンが使用されます。	文字列

Sku

Name	Description	Value
キャパシティ	SKU でスケールアウト/インがサポートされている場合は、容量の整数を含める必要があります。 リソースに対してスケールアウト/インができない場合は、これを省略できます。	int
family	同じ SKU に対して、サービスの世代が異なるハードウェアがある場合は、ここでキャプチャできます。	文字列
name	SKU の名前。 例: P3。 通常は文字 + 数字のコードです	string (必須)
size	SKU サイズ。 名前フィールドが層と他の値の組み合わせである場合、これはスタンドアロン コードになります。	文字列
レベル	このフィールドは、サービスに複数のレベルがあるが PUT では必要ない場合に、リソース プロバイダーによって実装される必要があります。	'Basic' 'Free' 'Premium' 'Standard'

TrackedResourceTags

Name	Description	Value

使用例

Azure のクイック スタート テンプレート

このリソースの種類 デプロイする Azure クイック スタート テンプレート 次に示します。

Template	Description
Dev Box サービス の構成 Azure にデプロイする	このテンプレートでは、Dev Box クイック スタート ガイド (/azure/dev-box/quickstart-create-dev-box) に従って、すべての Dev Box 管理リソースが作成されます。 作成されたすべてのリソースを表示することも、DevPortal.microsoft.com に直接移動して最初の Dev Box を作成することもできます。
組み込みのイメージ を使用して Dev Box Service をデプロイする Azure にデプロイする	このテンプレートは、組み込みのイメージを使用して Dev Box サービスをデプロイする方法を提供します。

Terraform (AzAPI プロバイダー) リソース定義

devcenters/devboxdefinitions リソースの種類は、次をターゲットとする操作と共にデプロイできます。

• リソース グループ

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.DevCenter/devcenters/devboxdefinitions リソースを作成するには、次の Terraform をテンプレートに追加します。

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

プロパティ値

Microsoft.DevCenter/devcenters/devboxdefinitions

Name	Description	Value
位置	リソースが存在する地理的な場所	string (必須)
name	リソース名	string Constraints: 最小長 = 3 最大長 = 63 パターン = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (必須)
parent_id	このリソースの親であるリソースの ID。	種類のリソースの ID: devcenters
properties	Dev Box 定義のプロパティ	DevBoxDefinitionProperties
tags	リソース タグ	タグ名と値のディクショナリ。
型	リソースの種類	"Microsoft.DevCenter/devcenters/devboxdefinitions@2026-01-01-preview"

DevBoxDefinitionProperties

Name	Description	Value
hibernateSupport	この定義で作成された Dev Boxes が休止状態にできるかどうかを示します。 すべてのイメージが休止状態をサポートできるわけではありません。 詳細については、https://aka.ms/devbox/hibernate を参照してください。	'Disabled' 'Enabled'
imageReference	画像参照情報。	ImageReference
osStorageType	この定義を使用して作成された開発ボックスのオペレーティング システム ディスクに使用されるストレージの種類。	文字列
sku	この定義を使用して作成された開発ボックスの SKU。	Sku

ImageReference

Name	Description	Value
id	イメージ ID、またはイメージ バージョン ID。 イメージ ID を指定すると、その最新バージョンが使用されます。	文字列

Sku

Name	Description	Value
キャパシティ	SKU でスケールアウト/インがサポートされている場合は、容量の整数を含める必要があります。 リソースに対してスケールアウト/インができない場合は、これを省略できます。	int
family	同じ SKU に対して、サービスの世代が異なるハードウェアがある場合は、ここでキャプチャできます。	文字列
name	SKU の名前。 例: P3。 通常は文字 + 数字のコードです	string (必須)
size	SKU サイズ。 名前フィールドが層と他の値の組み合わせである場合、これはスタンドアロン コードになります。	文字列
レベル	このフィールドは、サービスに複数のレベルがあるが PUT では必要ない場合に、リソース プロバイダーによって実装される必要があります。	'Basic' 'Free' 'Premium' 'Standard'

TrackedResourceTags

Name	Description	Value

使用例

Terraformサンプル

デベロッパー センター開発ボックス定義のデプロイの基本的な例。

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