Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
- Latest
- Zapowiedź 1 listopada 2026
- 2025-10-01-podgląd
- 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
Definicja zasobu Bicep
Typ zasobu devcenters/devboxdefinitions można wdrożyć przy użyciu operacji docelowych:
- grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.DevCenter/devcenters/devboxdefinitions, dodaj następujący kod Bicep do szablonu.
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'
}
}
Wartości właściwości
Microsoft.DevCenter/devcenters/devboxdefinitions
| Name | Description | Value |
|---|---|---|
| lokalizacja | Lokalizacja geograficzna, w której znajduje się zasób | ciąg (wymagany) |
| name | Nazwa zasobu | string Constraints: Minimalna długość = 3 Maksymalna długość = 63 Wzorzec = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (wymagane) |
| nadrzędny | W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym. Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym. |
Nazwa symboliczna zasobu typu: centrów deweloperskich |
| properties | Właściwości definicji usługi Dev Box | DevBoxDefinitionProperties |
| tags | Tagi zasobów | Słownik nazw tagów i wartości. Zobacz tagi w szablonach |
DevBoxDefinitionProperties
| Name | Description | Value |
|---|---|---|
| hibernateSupport | Wskazuje, czy pola deweloperskie utworzone za pomocą tej definicji są w stanie hibernacji. Nie wszystkie obrazy są w stanie obsługiwać hibernacji. Aby dowiedzieć się więcej, zobacz https://aka.ms/devbox/hibernate | 'Disabled' 'Enabled' |
| imageReference | Informacje o dokumentacji obrazu. | ImageReference |
| osStorageType | Typ magazynu używany dla dysku systemu operacyjnego usługi Dev Box utworzony przy użyciu tej definicji. | ciąg |
| sku | Jednostka SKU usługi Dev Box utworzona przy użyciu tej definicji. | Sku |
ImageReference
| Name | Description | Value |
|---|---|---|
| id | Identyfikator obrazu lub identyfikator wersji obrazu. Po podaniu identyfikatora obrazu zostanie użyta jego najnowsza wersja. | ciąg |
Sku
| Name | Description | Value |
|---|---|---|
| dyspozycyjność | Jeśli jednostka SKU obsługuje skalowanie w poziomie/w, należy uwzględnić liczbę całkowitą pojemności. Jeśli skalowanie w poziomie/w nie jest możliwe dla zasobu, może to zostać pominięte. | int |
| family | Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. | ciąg |
| name | Nazwa jednostki SKU. Np. P3. Zazwyczaj jest to kod z literą i cyfrą | ciąg (wymagany) |
| size | Rozmiar jednostki SKU. Gdy pole nazwy jest kombinacją warstwy i innej wartości, będzie to autonomiczny kod. | ciąg |
| warstwa | To pole jest wymagane do zaimplementowania przez dostawcę zasobów, jeśli usługa ma więcej niż jedną warstwę, ale nie jest wymagana w put. | 'Basic' 'Free' 'Premium' 'Standard' |
TrackedResourceTags
| Name | Description | Value |
|---|
Przykłady użycia
Przykłady Bicep
Podstawowy przykład wdrażania definicji pola deweloperskiego Centrum deweloperów.
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'
}
}
}
Przykłady szybkiego startu platformy Azure
Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.
| Plik Bicep | Description |
|---|---|
| Konfigurowanie usługi Dev Box | Ten szablon umożliwia utworzenie wszystkich zasobów administracyjnych usługi Dev Box zgodnie z przewodnikiem Szybki start dotyczącym usługi Dev Box (/azure/dev-box/quickstart-create-dev-box). Możesz wyświetlić wszystkie utworzone zasoby lub bezpośrednio przejść do DevPortal.microsoft.com, aby utworzyć pierwsze rozwiązanie Dev Box. |
| wdrażanie usługi Dev Box Service z wbudowanym obrazem | Ten szablon umożliwia wdrożenie usługi Dev Box z wbudowanym obrazem. |
Definicja zasobu szablonu usługi ARM
Typ zasobu devcenters/devboxdefinitions można wdrożyć przy użyciu operacji docelowych:
- grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.DevCenter/devcenters/devboxdefinitions, dodaj następujący kod JSON do szablonu.
{
"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"
}
}
Wartości właściwości
Microsoft.DevCenter/devcenters/devboxdefinitions
| Name | Description | Value |
|---|---|---|
| apiVersion | Wersja interfejsu API | 'Zapowiedź 2026-01-01' |
| lokalizacja | Lokalizacja geograficzna, w której znajduje się zasób | ciąg (wymagany) |
| name | Nazwa zasobu | string Constraints: Minimalna długość = 3 Maksymalna długość = 63 Wzorzec = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (wymagane) |
| properties | Właściwości definicji usługi Dev Box | DevBoxDefinitionProperties |
| tags | Tagi zasobów | Słownik nazw tagów i wartości. Zobacz tagi w szablonach |
| typ | Typ zasobu | 'Microsoft.DevCenter/devcenters/devboxdefinitions' |
DevBoxDefinitionProperties
| Name | Description | Value |
|---|---|---|
| hibernateSupport | Wskazuje, czy pola deweloperskie utworzone za pomocą tej definicji są w stanie hibernacji. Nie wszystkie obrazy są w stanie obsługiwać hibernacji. Aby dowiedzieć się więcej, zobacz https://aka.ms/devbox/hibernate | 'Disabled' 'Enabled' |
| imageReference | Informacje o dokumentacji obrazu. | ImageReference |
| osStorageType | Typ magazynu używany dla dysku systemu operacyjnego usługi Dev Box utworzony przy użyciu tej definicji. | ciąg |
| sku | Jednostka SKU usługi Dev Box utworzona przy użyciu tej definicji. | Sku |
ImageReference
| Name | Description | Value |
|---|---|---|
| id | Identyfikator obrazu lub identyfikator wersji obrazu. Po podaniu identyfikatora obrazu zostanie użyta jego najnowsza wersja. | ciąg |
Sku
| Name | Description | Value |
|---|---|---|
| dyspozycyjność | Jeśli jednostka SKU obsługuje skalowanie w poziomie/w, należy uwzględnić liczbę całkowitą pojemności. Jeśli skalowanie w poziomie/w nie jest możliwe dla zasobu, może to zostać pominięte. | int |
| family | Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. | ciąg |
| name | Nazwa jednostki SKU. Np. P3. Zazwyczaj jest to kod z literą i cyfrą | ciąg (wymagany) |
| size | Rozmiar jednostki SKU. Gdy pole nazwy jest kombinacją warstwy i innej wartości, będzie to autonomiczny kod. | ciąg |
| warstwa | To pole jest wymagane do zaimplementowania przez dostawcę zasobów, jeśli usługa ma więcej niż jedną warstwę, ale nie jest wymagana w put. | 'Basic' 'Free' 'Premium' 'Standard' |
TrackedResourceTags
| Name | Description | Value |
|---|
Przykłady użycia
Szablony szybkiego startu platformy Azure
Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.
| Template | Description |
|---|---|
|
Konfigurowanie usługi Dev Box wdrażanie  |
Ten szablon umożliwia utworzenie wszystkich zasobów administracyjnych usługi Dev Box zgodnie z przewodnikiem Szybki start dotyczącym usługi Dev Box (/azure/dev-box/quickstart-create-dev-box). Możesz wyświetlić wszystkie utworzone zasoby lub bezpośrednio przejść do DevPortal.microsoft.com, aby utworzyć pierwsze rozwiązanie Dev Box. |
|
wdrażanie usługi Dev Box Service z wbudowanym obrazem wdrażanie |
Ten szablon umożliwia wdrożenie usługi Dev Box z wbudowanym obrazem. |
Definicja zasobu narzędzia Terraform (dostawcy AzAPI)
Typ zasobu devcenters/devboxdefinitions można wdrożyć przy użyciu operacji docelowych:
- Grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.DevCenter/devcenters/devboxdefinitions, dodaj następujący program Terraform do szablonu.
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"
}
}
}
}
Wartości właściwości
Microsoft.DevCenter/devcenters/devboxdefinitions
| Name | Description | Value |
|---|---|---|
| lokalizacja | Lokalizacja geograficzna, w której znajduje się zasób | ciąg (wymagany) |
| name | Nazwa zasobu | string Constraints: Minimalna długość = 3 Maksymalna długość = 63 Wzorzec = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (wymagane) |
| parent_id | Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. | Identyfikator zasobu typu: centrów deweloperskich |
| properties | Właściwości definicji usługi Dev Box | DevBoxDefinitionProperties |
| tags | Tagi zasobów | Słownik nazw tagów i wartości. |
| typ | Typ zasobu | "Microsoft.DevCenter/devcenters/devboxdefinitions@2026-01-01-preview" |
DevBoxDefinitionProperties
| Name | Description | Value |
|---|---|---|
| hibernateSupport | Wskazuje, czy pola deweloperskie utworzone za pomocą tej definicji są w stanie hibernacji. Nie wszystkie obrazy są w stanie obsługiwać hibernacji. Aby dowiedzieć się więcej, zobacz https://aka.ms/devbox/hibernate | 'Disabled' 'Enabled' |
| imageReference | Informacje o dokumentacji obrazu. | ImageReference |
| osStorageType | Typ magazynu używany dla dysku systemu operacyjnego usługi Dev Box utworzony przy użyciu tej definicji. | ciąg |
| sku | Jednostka SKU usługi Dev Box utworzona przy użyciu tej definicji. | Sku |
ImageReference
| Name | Description | Value |
|---|---|---|
| id | Identyfikator obrazu lub identyfikator wersji obrazu. Po podaniu identyfikatora obrazu zostanie użyta jego najnowsza wersja. | ciąg |
Sku
| Name | Description | Value |
|---|---|---|
| dyspozycyjność | Jeśli jednostka SKU obsługuje skalowanie w poziomie/w, należy uwzględnić liczbę całkowitą pojemności. Jeśli skalowanie w poziomie/w nie jest możliwe dla zasobu, może to zostać pominięte. | int |
| family | Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. | ciąg |
| name | Nazwa jednostki SKU. Np. P3. Zazwyczaj jest to kod z literą i cyfrą | ciąg (wymagany) |
| size | Rozmiar jednostki SKU. Gdy pole nazwy jest kombinacją warstwy i innej wartości, będzie to autonomiczny kod. | ciąg |
| warstwa | To pole jest wymagane do zaimplementowania przez dostawcę zasobów, jeśli usługa ma więcej niż jedną warstwę, ale nie jest wymagana w put. | 'Basic' 'Free' 'Premium' 'Standard' |
TrackedResourceTags
| Name | Description | Value |
|---|
Przykłady użycia
Przykłady programu Terraform
Podstawowy przykład wdrażania definicji pola deweloperskiego Centrum deweloperów.
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 = ["*"]
}