Freigeben über


Microsoft.DevCenter devcenters/galeries

Bicep-Ressourcendefinition

Der Ressourcentyp "devcenters/gallerys" 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/gallerys-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Bicep hinzu.

resource symbolicname 'Microsoft.DevCenter/devcenters/galleries@2025-10-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    galleryResourceId: 'string'
  }
}

Eigenschaftswerte

Microsoft.DevCenter/devcenters/galleries

Name Description Value
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 Galerie-Eigenschaften. GalleryProperties

GalleryProperties

Name Description Value
galleryResourceId Die Ressourcen-ID des zugrunde stehenden Azure Compute Gallery. Zeichenfolge (erforderlich)

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.

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "devcenters/gallerys" 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 Ressource "Microsoft.DevCenter/devcenters/gallerys" zu erstellen, fügen Sie Ihrer Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.DevCenter/devcenters/galleries",
  "apiVersion": "2025-10-01-preview",
  "name": "string",
  "properties": {
    "galleryResourceId": "string"
  }
}

Eigenschaftswerte

Microsoft.DevCenter/devcenters/galleries

Name Description Value
apiVersion Die API-Version '2025-10-01-Vorschau'
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 Galerie-Eigenschaften. GalleryProperties
type Der Ressourcentyp 'Microsoft.DevCenter/devcenters/galleries'

GalleryProperties

Name Description Value
galleryResourceId Die Ressourcen-ID des zugrunde stehenden Azure Compute Gallery. Zeichenfolge (erforderlich)

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.

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "devcenters/gallerys" 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 Ressource "Microsoft.DevCenter/devcenters/gallerys" zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/devcenters/galleries@2025-10-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      galleryResourceId = "string"
    }
  }
}

Eigenschaftswerte

Microsoft.DevCenter/devcenters/galleries

Name Description Value
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 Galerie-Eigenschaften. GalleryProperties
type Der Ressourcentyp "Microsoft.DevCenter/devcenters/galleries@2025-10-01-preview"

GalleryProperties

Name Description Value
galleryResourceId Die Ressourcen-ID des zugrunde stehenden Azure Compute Gallery. Zeichenfolge (erforderlich)

Verwendungsbeispiele

Terraform-Beispiele

Ein grundlegendes Beispiel für die Bereitstellung der Dev Center Gallery.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

data "azapi_client_config" "current" {}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westus"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "gallery" {
  type      = "Microsoft.Compute/galleries@2022-03-03"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}sig"
  location  = var.location
  body = {
    properties = {
      description = ""
    }
  }
}

resource "azapi_resource" "userAssignedIdentity" {
  type      = "Microsoft.ManagedIdentity/userAssignedIdentities@2023-01-31"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}uai"
  location  = var.location
}

resource "azapi_resource" "devCenter" {
  type      = "Microsoft.DevCenter/devCenters@2025-02-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}dc"
  location  = var.location
  identity {
    type         = "UserAssigned"
    identity_ids = [azapi_resource.userAssignedIdentity.id]
  }
  body = {
    properties = {}
  }
}

# Assign Reader role on the gallery to the Dev Center's user-assigned identity
locals {
  reader_role_id = "acdd72a7-3385-48ef-bd42-f606fba81ae7"
}

resource "azapi_resource" "roleAssignment" {
  type      = "Microsoft.Authorization/roleAssignments@2022-04-01"
  name      = uuidv5("url", "${azapi_resource.gallery.id}/roleAssignments/${azapi_resource.userAssignedIdentity.output.properties.principalId}")
  parent_id = azapi_resource.gallery.id
  body = {
    properties = {
      roleDefinitionId = "/subscriptions/${data.azapi_client_config.current.subscription_id}/providers/Microsoft.Authorization/roleDefinitions/${local.reader_role_id}"
      principalId      = azapi_resource.userAssignedIdentity.output.properties.principalId
      principalType    = "ServicePrincipal"
    }
  }
  depends_on = [azapi_resource.userAssignedIdentity, azapi_resource.gallery]
}

resource "azapi_resource" "gallery_1" {
  type      = "Microsoft.DevCenter/devCenters/galleries@2025-02-01"
  parent_id = azapi_resource.devCenter.id
  name      = "${var.resource_name}dcg"
  body = {
    properties = {
      galleryResourceId = azapi_resource.gallery.id
    }
  }
  depends_on = [azapi_resource.roleAssignment]
}