Share via

Microsoft.Compute galleries/images/versions 2019-03-01

  • Article

Bicep resource definition

The galleries/images/versions resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

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

resource symbolicname 'Microsoft.Compute/galleries/images/versions@2019-03-01' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    publishingProfile: {
      endOfLifeDate: 'string'
      excludeFromLatest: bool
      replicaCount: int
      source: {
        managedImage: {
          id: 'string'
        }
      }
      storageAccountType: 'string'
      targetRegions: [
        {
          name: 'string'
          regionalReplicaCount: int
          storageAccountType: 'string'
        }
      ]
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Property values

GalleryArtifactSource

Name Description Value
managedImage The managed artifact. ManagedArtifact (required)

GalleryImageVersionProperties

Name Description Value
publishingProfile The publishing profile of a gallery Image Version. GalleryImageVersionPublishingProfile (required)

GalleryImageVersionPublishingProfile

Name Description Value
endOfLifeDate The end of life date of the gallery Image Version. This property can be used for decommissioning purposes. This property is updatable. string
excludeFromLatest If set to true, Virtual Machines deployed from the latest version of the Image Definition won't use this Image Version. bool
replicaCount The number of replicas of the Image Version to be created per region. This property would take effect for a region when regionalReplicaCount is not specified. This property is updatable. int
source The source image from which the Image Version is going to be created. GalleryArtifactSource (required)
storageAccountType Specifies the storage account type to be used to store the image. This property is not updatable. 'Standard_LRS'
'Standard_ZRS'
targetRegions The target regions where the Image Version is going to be replicated to. This property is updatable. TargetRegion[]

ManagedArtifact

Name Description Value
id The managed artifact id. string (required)

Microsoft.Compute/galleries/images/versions

Name Description Value
location Resource location string (required)
name The resource name string (required)
parent In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource.

For more information, see Child resource outside parent resource.		 Symbolic name for resource of type: galleries/images
properties Describes the properties of a gallery Image Version. GalleryImageVersionProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates

ResourceTags

Name Description Value

TargetRegion

Name Description Value
name The name of the region. string (required)
regionalReplicaCount The number of replicas of the Image Version to be created per region. This property is updatable. int
storageAccountType Specifies the storage account type to be used to store the image. This property is not updatable. 'Standard_LRS'
'Standard_ZRS'

ARM template resource definition

The galleries/images/versions resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

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

{
  "type": "Microsoft.Compute/galleries/images/versions",
  "apiVersion": "2019-03-01",
  "name": "string",
  "location": "string",
  "properties": {
    "publishingProfile": {
      "endOfLifeDate": "string",
      "excludeFromLatest": "bool",
      "replicaCount": "int",
      "source": {
        "managedImage": {
          "id": "string"
        }
      },
      "storageAccountType": "string",
      "targetRegions": [
        {
          "name": "string",
          "regionalReplicaCount": "int",
          "storageAccountType": "string"
        }
      ]
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Property values

GalleryArtifactSource

Name Description Value
managedImage The managed artifact. ManagedArtifact (required)

GalleryImageVersionProperties

Name Description Value
publishingProfile The publishing profile of a gallery Image Version. GalleryImageVersionPublishingProfile (required)

GalleryImageVersionPublishingProfile

Name Description Value
endOfLifeDate The end of life date of the gallery Image Version. This property can be used for decommissioning purposes. This property is updatable. string
excludeFromLatest If set to true, Virtual Machines deployed from the latest version of the Image Definition won't use this Image Version. bool
replicaCount The number of replicas of the Image Version to be created per region. This property would take effect for a region when regionalReplicaCount is not specified. This property is updatable. int
source The source image from which the Image Version is going to be created. GalleryArtifactSource (required)
storageAccountType Specifies the storage account type to be used to store the image. This property is not updatable. 'Standard_LRS'
'Standard_ZRS'
targetRegions The target regions where the Image Version is going to be replicated to. This property is updatable. TargetRegion[]

ManagedArtifact

Name Description Value
id The managed artifact id. string (required)

Microsoft.Compute/galleries/images/versions

Name Description Value
apiVersion The api version '2019-03-01'
location Resource location string (required)
name The resource name string (required)
properties Describes the properties of a gallery Image Version. GalleryImageVersionProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates
type The resource type 'Microsoft.Compute/galleries/images/versions'

ResourceTags

Name Description Value

TargetRegion

Name Description Value
name The name of the region. string (required)
regionalReplicaCount The number of replicas of the Image Version to be created per region. This property is updatable. int
storageAccountType Specifies the storage account type to be used to store the image. This property is not updatable. 'Standard_LRS'
'Standard_ZRS'

Quickstart templates

The following quickstart templates deploy this resource type.

Template Description
Create an Image Version in a Azure Compute Gallery

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

Terraform (AzAPI provider) resource definition

The galleries/images/versions resource type can be deployed with operations that target:

  • Resource groups

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Compute/galleries/images/versions resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/galleries/images/versions@2019-03-01"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      publishingProfile = {
        endOfLifeDate = "string"
        excludeFromLatest = bool
        replicaCount = int
        source = {
          managedImage = {
            id = "string"
          }
        }
        storageAccountType = "string"
        targetRegions = [
          {
            name = "string"
            regionalReplicaCount = int
            storageAccountType = "string"
          }
        ]
      }
    }
  })
}

Property values

GalleryArtifactSource

Name Description Value
managedImage The managed artifact. ManagedArtifact (required)

GalleryImageVersionProperties

Name Description Value
publishingProfile The publishing profile of a gallery Image Version. GalleryImageVersionPublishingProfile (required)

GalleryImageVersionPublishingProfile

Name Description Value
endOfLifeDate The end of life date of the gallery Image Version. This property can be used for decommissioning purposes. This property is updatable. string
excludeFromLatest If set to true, Virtual Machines deployed from the latest version of the Image Definition won't use this Image Version. bool
replicaCount The number of replicas of the Image Version to be created per region. This property would take effect for a region when regionalReplicaCount is not specified. This property is updatable. int
source The source image from which the Image Version is going to be created. GalleryArtifactSource (required)
storageAccountType Specifies the storage account type to be used to store the image. This property is not updatable. 'Standard_LRS'
'Standard_ZRS'
targetRegions The target regions where the Image Version is going to be replicated to. This property is updatable. TargetRegion[]

ManagedArtifact

Name Description Value
id The managed artifact id. string (required)

Microsoft.Compute/galleries/images/versions

Name Description Value
location Resource location string (required)
name The resource name string (required)
parent_id The ID of the resource that is the parent for this resource. ID for resource of type: galleries/images
properties Describes the properties of a gallery Image Version. GalleryImageVersionProperties
tags Resource tags Dictionary of tag names and values.
type The resource type "Microsoft.Compute/galleries/images/versions@2019-03-01"

ResourceTags

Name Description Value

TargetRegion

Name Description Value
name The name of the region. string (required)
regionalReplicaCount The number of replicas of the Image Version to be created per region. This property is updatable. int
storageAccountType Specifies the storage account type to be used to store the image. This property is not updatable. 'Standard_LRS'
'Standard_ZRS'