Microsoft. DevCenter devcenters/devboxdefinitions 2023-10-01-preview

Definizione di risorsa Bicep

Il tipo di risorsa devcenters/devboxdefinitions può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Esempi di utilizzo

Esempi bicep

Un esempio di base di distribuzione della definizione Dev Box di Dev Center.

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

Esempi di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti contengono esempi Bicep per la distribuzione di questo tipo di risorsa.

File bicipite Description
Configurare il servizio Dev Box Questo modello crea tutte le risorse di amministrazione di Dev Box in base alla guida introduttiva di Dev Box (/azure/dev-box/quickstart-create-dev-box). È possibile visualizzare tutte le risorse create oppure passare direttamente a DevPortal.microsoft.com per creare il primo Dev Box.
Distribuire Dev Box Service con un'immagine predefinita Questo modello consente di distribuire un servizio Dev Box con un'immagine predefinita.

Formato risorsa

Per creare una risorsa Microsoft.DevCenter/devcenters/devboxdefinitions, aggiungere il bicep seguente al modello.

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

Valori delle proprietà

Microsoft.DevCenter/devcenters/devboxdefinitions

Name Description Value
location Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
name Nome della risorsa string

Constraints:
Lunghezza minima = 3
Lunghezza massima = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obbligatorio)
parent In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.		 Nome simbolico per la risorsa di tipo: devcenters
properties Proprietà della definizione di Dev Box DevBoxDefinitionProperties
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

DevBoxDefinitionProperties

Name Description Value
hibernateSupport Indica se Dev Boxes creato con questa definizione è in grado di ibernare. Non tutte le immagini sono in grado di supportare l'ibernazione. Per altre informazioni, vedere https://aka.ms/devbox/hibernate 'Disabled'
'Enabled'
imageReference Informazioni di riferimento sulle immagini. ImageReference
osStorageType Tipo di archiviazione usato per il disco del sistema operativo di Dev Boxes creato usando questa definizione. string
sku SKU per Dev Boxes creato usando questa definizione. Sku

ImageReference

Name Description Value
id ID immagine o ID versione immagine. Quando viene specificato l'ID immagine, verrà usata la versione più recente. string

Sku

Name Description Value
capacity Se lo SKU supporta l'aumento o l'aumento del numero di istanze, è necessario includere l'intero della capacità. Se non è possibile aumentare o ridurre il numero di istanze per la risorsa, potrebbe essere omesso. int
family Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. string
name Nome dello SKU. Ad esempio - P3. Si tratta in genere di un codice lettera+numero stringa (obbligatorio)
size Dimensioni dello SKU. Quando il campo nome è la combinazione di livello e un altro valore, si tratta del codice autonomo. string
tier Questo campo deve essere implementato dal provider di risorse se il servizio ha più di un livello, ma non è necessario in un PUT. 'Basic'
'Free'
'Premium'
'Standard'

TrackedResourceTags

Name Description Value

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa devcenters/devboxdefinitions può essere distribuito con operazioni destinate a:

Esempi di utilizzo

Modelli di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.

Template Description
Configurare il servizio Dev Box

Distribuire in Azure 		Questo modello crea tutte le risorse di amministrazione di Dev Box in base alla guida introduttiva di Dev Box (/azure/dev-box/quickstart-create-dev-box). È possibile visualizzare tutte le risorse create oppure passare direttamente a DevPortal.microsoft.com per creare il primo Dev Box.
Distribuire Dev Box Service con un'immagine predefinita

Distribuire in Azure 		Questo modello consente di distribuire un servizio Dev Box con un'immagine predefinita.

Formato risorsa

Per creare una risorsa Microsoft.DevCenter/devcenters/devboxdefinitions, aggiungere il codice JSON seguente al modello.

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

Valori delle proprietà

Microsoft.DevCenter/devcenters/devboxdefinitions

Name Description Value
apiVersion Versione dell'API '2023-10-01-preview'
location Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
name Nome della risorsa string

Constraints:
Lunghezza minima = 3
Lunghezza massima = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obbligatorio)
properties Proprietà della definizione di Dev Box DevBoxDefinitionProperties
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
type Tipo di risorsa 'Microsoft.DevCenter/devcenters/devboxdefinitions'

DevBoxDefinitionProperties

Name Description Value
hibernateSupport Indica se Dev Boxes creato con questa definizione è in grado di ibernare. Non tutte le immagini sono in grado di supportare l'ibernazione. Per altre informazioni, vedere https://aka.ms/devbox/hibernate 'Disabled'
'Enabled'
imageReference Informazioni di riferimento sulle immagini. ImageReference
osStorageType Tipo di archiviazione usato per il disco del sistema operativo di Dev Boxes creato usando questa definizione. string
sku SKU per Dev Boxes creato usando questa definizione. Sku

ImageReference

Name Description Value
id ID immagine o ID versione immagine. Quando viene specificato l'ID immagine, verrà usata la versione più recente. string

Sku

Name Description Value
capacity Se lo SKU supporta l'aumento o l'aumento del numero di istanze, è necessario includere l'intero della capacità. Se non è possibile aumentare o ridurre il numero di istanze per la risorsa, potrebbe essere omesso. int
family Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. string
name Nome dello SKU. Ad esempio - P3. Si tratta in genere di un codice lettera+numero stringa (obbligatorio)
size Dimensioni dello SKU. Quando il campo nome è la combinazione di livello e un altro valore, si tratta del codice autonomo. string
tier Questo campo deve essere implementato dal provider di risorse se il servizio ha più di un livello, ma non è necessario in un PUT. 'Basic'
'Free'
'Premium'
'Standard'

TrackedResourceTags

Name Description Value

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa devcenters/devboxdefinitions può essere distribuito con operazioni destinate a:

  • Gruppi di risorse Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.

Esempi di utilizzo

Esempi di Terraform

Un esempio di base di distribuzione della definizione Dev Box di Dev Center.

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

Formato risorsa

Per creare una risorsa Microsoft.DevCenter/devcenters/devboxdefinitions, aggiungere il codice Terraform seguente al modello.

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

Valori delle proprietà

Microsoft.DevCenter/devcenters/devboxdefinitions

Name Description Value
location Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
name Nome della risorsa string

Constraints:
Lunghezza minima = 3
Lunghezza massima = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: devcenters
properties Proprietà della definizione di Dev Box DevBoxDefinitionProperties
tags Tag delle risorse Dizionario di nomi e valori di tag.
type Tipo di risorsa "Microsoft.DevCenter/devcenters/devboxdefinitions@2023-10-01-preview"

DevBoxDefinitionProperties

Name Description Value
hibernateSupport Indica se Dev Boxes creato con questa definizione è in grado di ibernare. Non tutte le immagini sono in grado di supportare l'ibernazione. Per altre informazioni, vedere https://aka.ms/devbox/hibernate 'Disabled'
'Enabled'
imageReference Informazioni di riferimento sulle immagini. ImageReference
osStorageType Tipo di archiviazione usato per il disco del sistema operativo di Dev Boxes creato usando questa definizione. string
sku SKU per Dev Boxes creato usando questa definizione. Sku

ImageReference

Name Description Value
id ID immagine o ID versione immagine. Quando viene specificato l'ID immagine, verrà usata la versione più recente. string

Sku

Name Description Value
capacity Se lo SKU supporta l'aumento o l'aumento del numero di istanze, è necessario includere l'intero della capacità. Se non è possibile aumentare o ridurre il numero di istanze per la risorsa, potrebbe essere omesso. int
family Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. string
name Nome dello SKU. Ad esempio - P3. Si tratta in genere di un codice lettera+numero stringa (obbligatorio)
size Dimensioni dello SKU. Quando il campo nome è la combinazione di livello e un altro valore, si tratta del codice autonomo. string
tier Questo campo deve essere implementato dal provider di risorse se il servizio ha più di un livello, ma non è necessario in un PUT. 'Basic'
'Free'
'Premium'
'Standard'

TrackedResourceTags

Name Description Value
  • Last updated on