Raccolte/immagini Microsoft.Compute

Definizione di risorsa Bicep

Il tipo di risorsa raccolte/immagini 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 di un'immagine condivisa all'interno di una raccolta di immagini condivise.

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

resource gallery 'Microsoft.Compute/galleries@2022-03-03' = {
  name: resourceName
  location: location
  properties: {
    description: ''
  }
}

resource image 'Microsoft.Compute/galleries/images@2022-03-03' = {
  name: resourceName
  location: location
  parent: gallery
  properties: {
    architecture: 'x64'
    description: ''
    disallowed: {
      diskTypes: []
    }
    hyperVGeneration: 'V1'
    identifier: {
      offer: 'AccTesOffer230630032848825313'
      publisher: 'AccTesPublisher230630032848825313'
      sku: 'AccTesSku230630032848825313'
    }
    osState: 'Generalized'
    osType: 'Linux'
    privacyStatementUri: ''
    recommended: {
      memory: {}
      vCPUs: {}
    }
    releaseNoteUri: ''
  }
}

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.

Formato risorsa

Per creare una risorsa Microsoft.Compute/galleries/images, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.Compute/galleries/images@2025-12-03' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    allowUpdateImage: bool
    architecture: 'string'
    description: 'string'
    disallowed: {
      diskTypes: [
        'string'
      ]
    }
    endOfLifeDate: 'string'
    eula: 'string'
    features: [
      {
        name: 'string'
        startsAtVersion: 'string'
        value: 'string'
      }
    ]
    hyperVGeneration: 'string'
    identifier: {
      offer: 'string'
      publisher: 'string'
      sku: 'string'
    }
    osState: 'string'
    osType: 'string'
    privacyStatementUri: 'string'
    purchasePlan: {
      name: 'string'
      product: 'string'
      publisher: 'string'
    }
    recommended: {
      memory: {
        max: int
        min: int
      }
      vCPUs: {
        max: int
        min: int
      }
    }
    releaseNoteUri: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valori delle proprietà

Microsoft.Compute/galleries/images

Consentita

GalleryImageFeature

GalleryImageIdentifier

Galleria ImageProperties

ImagePurchasePlan

Configurazione macchina consigliata

Gamma di risorse

TrackedResourceTags

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa raccolte/immagini può essere distribuito con operazioni destinate a:

• Gruppi di risorse - Vedi comandi di distribuzione dei gruppi di risorse Per un elenco delle proprietà modificate in ciascuna versione API, vedi registro delle modifiche.

Esempi di utilizzo

Modelli di avvio rapido di Azure

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

Sagoma	Descrizione
Generatore immagini di Azure con baseline di Windows di Azure	Crea un ambiente di Image Builder di Azure e compila un'immagine di Windows Server con gli aggiornamenti di Windows più recenti e la baseline di Windows di Azure applicata.
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.
Creare una definizione di immagine in una raccolta di calcolo di Azure	Questo modello consente di creare una semplice definizione di immagine in una raccolta di calcolo di Azure. Assicurarsi di aver eseguito il modello raccolta immagini condivise 101 prima di distribuirlo.

Formato risorsa

Per creare una risorsa Microsoft.Compute/galleries/images, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.Compute/galleries/images",
  "apiVersion": "2025-12-03",
  "name": "string",
  "location": "string",
  "properties": {
    "allowUpdateImage": "bool",
    "architecture": "string",
    "description": "string",
    "disallowed": {
      "diskTypes": [ "string" ]
    },
    "endOfLifeDate": "string",
    "eula": "string",
    "features": [
      {
        "name": "string",
        "startsAtVersion": "string",
        "value": "string"
      }
    ],
    "hyperVGeneration": "string",
    "identifier": {
      "offer": "string",
      "publisher": "string",
      "sku": "string"
    },
    "osState": "string",
    "osType": "string",
    "privacyStatementUri": "string",
    "purchasePlan": {
      "name": "string",
      "product": "string",
      "publisher": "string"
    },
    "recommended": {
      "memory": {
        "max": "int",
        "min": "int"
      },
      "vCPUs": {
        "max": "int",
        "min": "int"
      }
    },
    "releaseNoteUri": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valori delle proprietà

Microsoft.Compute/galleries/images

Consentita

GalleryImageFeature

GalleryImageIdentifier

Galleria ImageProperties

ImagePurchasePlan

Configurazione macchina consigliata

Gamma di risorse

TrackedResourceTags

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa raccolte/immagini 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 di un'immagine condivisa all'interno di una raccolta di immagini condivise.

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

provider "azapi" {
  skip_provider_registration = false
}

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" "gallery" {
  type      = "Microsoft.Compute/galleries@2022-03-03"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      description = ""
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "image" {
  type      = "Microsoft.Compute/galleries/images@2022-03-03"
  parent_id = azapi_resource.gallery.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      architecture = "x64"
      description  = ""
      disallowed = {
        diskTypes = [
        ]
      }
      features         = null
      hyperVGeneration = "V1"
      identifier = {
        offer     = "AccTesOffer230630032848825313"
        publisher = "AccTesPublisher230630032848825313"
        sku       = "AccTesSku230630032848825313"
      }
      osState             = "Generalized"
      osType              = "Linux"
      privacyStatementUri = ""
      recommended = {
        memory = {
        }
        vCPUs = {
        }
      }
      releaseNoteUri = ""
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Formato risorsa

Per creare una risorsa Microsoft.Compute/galleries/images, aggiungere il modello terraform seguente.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/galleries/images@2025-12-03"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      allowUpdateImage = bool
      architecture = "string"
      description = "string"
      disallowed = {
        diskTypes = [
          "string"
        ]
      }
      endOfLifeDate = "string"
      eula = "string"
      features = [
        {
          name = "string"
          startsAtVersion = "string"
          value = "string"
        }
      ]
      hyperVGeneration = "string"
      identifier = {
        offer = "string"
        publisher = "string"
        sku = "string"
      }
      osState = "string"
      osType = "string"
      privacyStatementUri = "string"
      purchasePlan = {
        name = "string"
        product = "string"
        publisher = "string"
      }
      recommended = {
        memory = {
          max = int
          min = int
        }
        vCPUs = {
          max = int
          min = int
        }
      }
      releaseNoteUri = "string"
    }
  }
}

Valori delle proprietà

Microsoft.Compute/galleries/images

Consentita

GalleryImageFeature

GalleryImageIdentifier

Galleria ImageProperties

ImagePurchasePlan

Configurazione macchina consigliata

Gamma di risorse

TrackedResourceTags