Microsoft.Compute galleries/images 2019-12-01

The galleries/images resource type can be deployed to: Resource groups.

To learn about resource group deployments, see Bicep or ARM template.

Template format

To create a Microsoft.Compute/galleries/images resource, add the following Bicep or JSON to your template.

resource symbolicname 'Microsoft.Compute/galleries/images@2019-12-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  properties: {
    description: 'string'
    disallowed: {
      diskTypes: [ 'string' ]
    endOfLifeDate: 'string'
    eula: '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'

Property values


Name Description Value
type The resource type

For Bicep, set this value in the resource declaration.
apiVersion The resource api version

For Bicep, set this value in the resource declaration.
name The resource name

See how to set names and types for child resources in Bicep or JSON ARM templates.
string (required)
location Resource location string (required)
tags Resource tags Dictionary of tag names and values. See Tags in templates
properties Describes the properties of a gallery Image Definition. GalleryImageProperties


Name Description Value
description The description of this gallery Image Definition resource. This property is updatable. string
disallowed Describes the disallowed disk types. Disallowed
endOfLifeDate The end of life date of the gallery Image Definition. This property can be used for decommissioning purposes. This property is updatable. string
eula The Eula agreement for the gallery Image Definition. string
hyperVGeneration The hypervisor generation of the Virtual Machine. Applicable to OS disks only. 'V1'
identifier This is the gallery Image Definition identifier. GalleryImageIdentifier (required)
osState This property allows the user to specify whether the virtual machines created under this image are 'Generalized' or 'Specialized'. 'Generalized'
osType This property allows you to specify the supported type of the OS that application is built for.

Possible values are:


privacyStatementUri The privacy statement uri. string
purchasePlan Describes the gallery Image Definition purchase plan. This is used by marketplace images. ImagePurchasePlan
recommended The properties describe the recommended machine configuration for this Image Definition. These properties are updatable. RecommendedMachineConfiguration
releaseNoteUri The release note uri. string


Name Description Value
diskTypes A list of disk types. string[]


Name Description Value
offer The name of the gallery Image Definition offer. string (required)
publisher The name of the gallery Image Definition publisher. string (required)
sku The name of the gallery Image Definition SKU. string (required)


Name Description Value
name The plan ID. string
product The product ID. string
publisher The publisher ID. string


Name Description Value
memory Describes the resource range. ResourceRange
vCPUs Describes the resource range. ResourceRange


Name Description Value
max The maximum number of the resource. int
min The minimum number of the resource. int

Quickstart templates

The following quickstart templates deploy this resource type.

Template Description
Create an Image Definition in a Shared Image Gallery

Deploy to Azure
This template allows you to create a simple Image Definition in a Shared Image Gallery. Please ensure that you have run the Shared Image Gallery 101 Template before you deploy this.