Microsoft.Compute snapshots 2020-09-30

Article
12/09/2024

Bicep resource definition

The snapshots resource type can be deployed with operations that target:

Resource groups - See resource group deployment commands

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

Resource format

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

resource symbolicname 'Microsoft.Compute/snapshots@2020-09-30' = {
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    creationData: {
      createOption: 'string'
      galleryImageReference: {
        id: 'string'
        lun: int
      }
      imageReference: {
        id: 'string'
        lun: int
      }
      logicalSectorSize: int
      sourceResourceId: 'string'
      sourceUri: 'string'
      storageAccountId: 'string'
      uploadSizeBytes: int
    }
    diskAccessId: 'string'
    diskSizeGB: int
    encryption: {
      diskEncryptionSetId: 'string'
      type: 'string'
    }
    encryptionSettingsCollection: {
      enabled: bool
      encryptionSettings: [
        {
          diskEncryptionKey: {
            secretUrl: 'string'
            sourceVault: {
              id: 'string'
            }
          }
          keyEncryptionKey: {
            keyUrl: 'string'
            sourceVault: {
              id: 'string'
            }
          }
        }
      ]
      encryptionSettingsVersion: 'string'
    }
    hyperVGeneration: 'string'
    incremental: bool
    networkAccessPolicy: 'string'
    osType: 'string'
    purchasePlan: {
      name: 'string'
      product: 'string'
      promotionCode: 'string'
      publisher: 'string'
    }
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Property values

CreationData

Name	Description	Value
createOption	This enumerates the possible sources of a disk's creation.	'Attach' 'Copy' 'Empty' 'FromImage' 'Import' 'Restore' 'Upload' (required)
galleryImageReference	Required if creating from a Gallery Image. The id of the ImageDiskReference will be the ARM id of the shared galley image version from which to create a disk.	ImageDiskReference
imageReference	Disk source information.	ImageDiskReference
logicalSectorSize	Logical sector size in bytes for Ultra disks. Supported values are 512 ad 4096. 4096 is the default.	int
sourceResourceId	If createOption is Copy, this is the ARM id of the source snapshot or disk.	string
sourceUri	If createOption is Import, this is the URI of a blob to be imported into a managed disk.	string
storageAccountId	Required if createOption is Import. The Azure Resource Manager identifier of the storage account containing the blob to import as a disk.	string
uploadSizeBytes	If createOption is Upload, this is the size of the contents of the upload including the VHD footer. This value should be between 20972032 (20 MiB + 512 bytes for the VHD footer) and 35183298347520 bytes (32 TiB + 512 bytes for the VHD footer).	int

Encryption

Name	Description	Value
diskEncryptionSetId	ResourceId of the disk encryption set to use for enabling encryption at rest.	string
type	The type of key used to encrypt the data of the disk.	'EncryptionAtRestWithCustomerKey' 'EncryptionAtRestWithPlatformAndCustomerKeys' 'EncryptionAtRestWithPlatformKey'

EncryptionSettingsCollection

Name	Description	Value
enabled	Set this flag to true and provide DiskEncryptionKey and optional KeyEncryptionKey to enable encryption. Set this flag to false and remove DiskEncryptionKey and KeyEncryptionKey to disable encryption. If EncryptionSettings is null in the request object, the existing settings remain unchanged.	bool (required)
encryptionSettings	A collection of encryption settings, one for each disk volume.	EncryptionSettingsElement[]
encryptionSettingsVersion	Describes what type of encryption is used for the disks. Once this field is set, it cannot be overwritten. '1.0' corresponds to Azure Disk Encryption with AAD app.'1.1' corresponds to Azure Disk Encryption.	string

EncryptionSettingsElement

Name	Description	Value
diskEncryptionKey	Key Vault Secret Url and vault id of the disk encryption key	KeyVaultAndSecretReference
keyEncryptionKey	Key Vault Key Url and vault id of the key encryption key. KeyEncryptionKey is optional and when provided is used to unwrap the disk encryption key.	KeyVaultAndKeyReference

ExtendedLocation

Name	Description	Value
name	The name of the extended location.	string
type	The type of the extended location.	'EdgeZone'

ImageDiskReference

Name	Description	Value
id	A relative uri containing either a Platform Image Repository or user image reference.	string (required)
lun	If the disk is created from an image's data disk, this is an index that indicates which of the data disks in the image to use. For OS disks, this field is null.	int

KeyVaultAndKeyReference

Name	Description	Value
keyUrl	Url pointing to a key or secret in KeyVault	string (required)
sourceVault	Resource id of the KeyVault containing the key or secret	SourceVault (required)

KeyVaultAndSecretReference

Name	Description	Value
secretUrl	Url pointing to a key or secret in KeyVault	string (required)
sourceVault	Resource id of the KeyVault containing the key or secret	SourceVault (required)

Microsoft.Compute/snapshots

Name	Description	Value
extendedLocation	The extended location where the snapshot will be created. Extended location cannot be changed.	ExtendedLocation
location	Resource location	string (required)
name	The resource name	string (required)
properties	Snapshot resource properties.	SnapshotProperties
sku	The snapshots sku name. Can be Standard_LRS, Premium_LRS, or Standard_ZRS. This is an optional parameter for incremental snapshot and the default behavior is the SKU will be set to the same sku as the previous snapshot	SnapshotSku
tags	Resource tags	Dictionary of tag names and values. See Tags in templates

PurchasePlan

Name	Description	Value
name	The plan ID.	string (required)
product	Specifies the product of the image from the marketplace. This is the same value as Offer under the imageReference element.	string (required)
promotionCode	The Offer Promotion Code.	string
publisher	The publisher ID.	string (required)

ResourceTags

Name	Description	Value

SnapshotProperties

Name	Description	Value
creationData	Disk source information. CreationData information cannot be changed after the disk has been created.	CreationData (required)
diskAccessId	ARM id of the DiskAccess resource for using private endpoints on disks.	string
diskSizeGB	If creationData.createOption is Empty, this field is mandatory and it indicates the size of the disk to create. If this field is present for updates or creation with other options, it indicates a resize. Resizes are only allowed if the disk is not attached to a running VM, and can only increase the disk's size.	int
encryption	Encryption property can be used to encrypt data at rest with customer managed keys or platform managed keys.	Encryption
encryptionSettingsCollection	Encryption settings collection used be Azure Disk Encryption, can contain multiple encryption settings per disk or snapshot.	EncryptionSettingsCollection
hyperVGeneration	The hypervisor generation of the Virtual Machine. Applicable to OS disks only.	'V1' 'V2'
incremental	Whether a snapshot is incremental. Incremental snapshots on the same disk occupy less space than full snapshots and can be diffed.	bool
networkAccessPolicy	Policy for accessing the disk via network.	'AllowAll' 'AllowPrivate' 'DenyAll'
osType	The Operating System type.	'Linux' 'Windows'
purchasePlan	Purchase plan information for the image from which the source disk for the snapshot was originally created.	PurchasePlan

SnapshotSku

Name	Description	Value
name	The sku name.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'

SourceVault

Name	Description	Value
id	Resource Id	string

ARM template resource definition

The snapshots resource type can be deployed with operations that target:

Resource groups - See resource group deployment commands

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

Resource format

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

{
  "type": "Microsoft.Compute/snapshots",
  "apiVersion": "2020-09-30",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "location": "string",
  "properties": {
    "creationData": {
      "createOption": "string",
      "galleryImageReference": {
        "id": "string",
        "lun": "int"
      },
      "imageReference": {
        "id": "string",
        "lun": "int"
      },
      "logicalSectorSize": "int",
      "sourceResourceId": "string",
      "sourceUri": "string",
      "storageAccountId": "string",
      "uploadSizeBytes": "int"
    },
    "diskAccessId": "string",
    "diskSizeGB": "int",
    "encryption": {
      "diskEncryptionSetId": "string",
      "type": "string"
    },
    "encryptionSettingsCollection": {
      "enabled": "bool",
      "encryptionSettings": [
        {
          "diskEncryptionKey": {
            "secretUrl": "string",
            "sourceVault": {
              "id": "string"
            }
          },
          "keyEncryptionKey": {
            "keyUrl": "string",
            "sourceVault": {
              "id": "string"
            }
          }
        }
      ],
      "encryptionSettingsVersion": "string"
    },
    "hyperVGeneration": "string",
    "incremental": "bool",
    "networkAccessPolicy": "string",
    "osType": "string",
    "purchasePlan": {
      "name": "string",
      "product": "string",
      "promotionCode": "string",
      "publisher": "string"
    }
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Property values

CreationData

Name	Description	Value
createOption	This enumerates the possible sources of a disk's creation.	'Attach' 'Copy' 'Empty' 'FromImage' 'Import' 'Restore' 'Upload' (required)
galleryImageReference	Required if creating from a Gallery Image. The id of the ImageDiskReference will be the ARM id of the shared galley image version from which to create a disk.	ImageDiskReference
imageReference	Disk source information.	ImageDiskReference
logicalSectorSize	Logical sector size in bytes for Ultra disks. Supported values are 512 ad 4096. 4096 is the default.	int
sourceResourceId	If createOption is Copy, this is the ARM id of the source snapshot or disk.	string
sourceUri	If createOption is Import, this is the URI of a blob to be imported into a managed disk.	string
storageAccountId	Required if createOption is Import. The Azure Resource Manager identifier of the storage account containing the blob to import as a disk.	string
uploadSizeBytes	If createOption is Upload, this is the size of the contents of the upload including the VHD footer. This value should be between 20972032 (20 MiB + 512 bytes for the VHD footer) and 35183298347520 bytes (32 TiB + 512 bytes for the VHD footer).	int

Encryption

Name	Description	Value
diskEncryptionSetId	ResourceId of the disk encryption set to use for enabling encryption at rest.	string
type	The type of key used to encrypt the data of the disk.	'EncryptionAtRestWithCustomerKey' 'EncryptionAtRestWithPlatformAndCustomerKeys' 'EncryptionAtRestWithPlatformKey'

EncryptionSettingsCollection

Name	Description	Value
enabled	Set this flag to true and provide DiskEncryptionKey and optional KeyEncryptionKey to enable encryption. Set this flag to false and remove DiskEncryptionKey and KeyEncryptionKey to disable encryption. If EncryptionSettings is null in the request object, the existing settings remain unchanged.	bool (required)
encryptionSettings	A collection of encryption settings, one for each disk volume.	EncryptionSettingsElement[]
encryptionSettingsVersion	Describes what type of encryption is used for the disks. Once this field is set, it cannot be overwritten. '1.0' corresponds to Azure Disk Encryption with AAD app.'1.1' corresponds to Azure Disk Encryption.	string

EncryptionSettingsElement

Name	Description	Value
diskEncryptionKey	Key Vault Secret Url and vault id of the disk encryption key	KeyVaultAndSecretReference
keyEncryptionKey	Key Vault Key Url and vault id of the key encryption key. KeyEncryptionKey is optional and when provided is used to unwrap the disk encryption key.	KeyVaultAndKeyReference

ExtendedLocation

Name	Description	Value
name	The name of the extended location.	string
type	The type of the extended location.	'EdgeZone'

ImageDiskReference

Name	Description	Value
id	A relative uri containing either a Platform Image Repository or user image reference.	string (required)
lun	If the disk is created from an image's data disk, this is an index that indicates which of the data disks in the image to use. For OS disks, this field is null.	int

KeyVaultAndKeyReference

Name	Description	Value
keyUrl	Url pointing to a key or secret in KeyVault	string (required)
sourceVault	Resource id of the KeyVault containing the key or secret	SourceVault (required)

KeyVaultAndSecretReference

Name	Description	Value
secretUrl	Url pointing to a key or secret in KeyVault	string (required)
sourceVault	Resource id of the KeyVault containing the key or secret	SourceVault (required)

Microsoft.Compute/snapshots

Name	Description	Value
apiVersion	The api version	'2020-09-30'
extendedLocation	The extended location where the snapshot will be created. Extended location cannot be changed.	ExtendedLocation
location	Resource location	string (required)
name	The resource name	string (required)
properties	Snapshot resource properties.	SnapshotProperties
sku	The snapshots sku name. Can be Standard_LRS, Premium_LRS, or Standard_ZRS. This is an optional parameter for incremental snapshot and the default behavior is the SKU will be set to the same sku as the previous snapshot	SnapshotSku
tags	Resource tags	Dictionary of tag names and values. See Tags in templates
type	The resource type	'Microsoft.Compute/snapshots'

PurchasePlan

Name	Description	Value
name	The plan ID.	string (required)
product	Specifies the product of the image from the marketplace. This is the same value as Offer under the imageReference element.	string (required)
promotionCode	The Offer Promotion Code.	string
publisher	The publisher ID.	string (required)

ResourceTags

Name	Description	Value

SnapshotProperties

Name	Description	Value
creationData	Disk source information. CreationData information cannot be changed after the disk has been created.	CreationData (required)
diskAccessId	ARM id of the DiskAccess resource for using private endpoints on disks.	string
diskSizeGB	If creationData.createOption is Empty, this field is mandatory and it indicates the size of the disk to create. If this field is present for updates or creation with other options, it indicates a resize. Resizes are only allowed if the disk is not attached to a running VM, and can only increase the disk's size.	int
encryption	Encryption property can be used to encrypt data at rest with customer managed keys or platform managed keys.	Encryption
encryptionSettingsCollection	Encryption settings collection used be Azure Disk Encryption, can contain multiple encryption settings per disk or snapshot.	EncryptionSettingsCollection
hyperVGeneration	The hypervisor generation of the Virtual Machine. Applicable to OS disks only.	'V1' 'V2'
incremental	Whether a snapshot is incremental. Incremental snapshots on the same disk occupy less space than full snapshots and can be diffed.	bool
networkAccessPolicy	Policy for accessing the disk via network.	'AllowAll' 'AllowPrivate' 'DenyAll'
osType	The Operating System type.	'Linux' 'Windows'
purchasePlan	Purchase plan information for the image from which the source disk for the snapshot was originally created.	PurchasePlan

SnapshotSku

Name	Description	Value
name	The sku name.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'

SourceVault

Name	Description	Value
id	Resource Id	string

Terraform (AzAPI provider) resource definition

The snapshots 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/snapshots resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/snapshots@2020-09-30"
  name = "string"
  location = "string"
  sku = {
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      creationData = {
        createOption = "string"
        galleryImageReference = {
          id = "string"
          lun = int
        }
        imageReference = {
          id = "string"
          lun = int
        }
        logicalSectorSize = int
        sourceResourceId = "string"
        sourceUri = "string"
        storageAccountId = "string"
        uploadSizeBytes = int
      }
      diskAccessId = "string"
      diskSizeGB = int
      encryption = {
        diskEncryptionSetId = "string"
        type = "string"
      }
      encryptionSettingsCollection = {
        enabled = bool
        encryptionSettings = [
          {
            diskEncryptionKey = {
              secretUrl = "string"
              sourceVault = {
                id = "string"
              }
            }
            keyEncryptionKey = {
              keyUrl = "string"
              sourceVault = {
                id = "string"
              }
            }
          }
        ]
        encryptionSettingsVersion = "string"
      }
      hyperVGeneration = "string"
      incremental = bool
      networkAccessPolicy = "string"
      osType = "string"
      purchasePlan = {
        name = "string"
        product = "string"
        promotionCode = "string"
        publisher = "string"
      }
    }
  })
}

Property values

CreationData

Name	Description	Value
createOption	This enumerates the possible sources of a disk's creation.	'Attach' 'Copy' 'Empty' 'FromImage' 'Import' 'Restore' 'Upload' (required)
galleryImageReference	Required if creating from a Gallery Image. The id of the ImageDiskReference will be the ARM id of the shared galley image version from which to create a disk.	ImageDiskReference
imageReference	Disk source information.	ImageDiskReference
logicalSectorSize	Logical sector size in bytes for Ultra disks. Supported values are 512 ad 4096. 4096 is the default.	int
sourceResourceId	If createOption is Copy, this is the ARM id of the source snapshot or disk.	string
sourceUri	If createOption is Import, this is the URI of a blob to be imported into a managed disk.	string
storageAccountId	Required if createOption is Import. The Azure Resource Manager identifier of the storage account containing the blob to import as a disk.	string
uploadSizeBytes	If createOption is Upload, this is the size of the contents of the upload including the VHD footer. This value should be between 20972032 (20 MiB + 512 bytes for the VHD footer) and 35183298347520 bytes (32 TiB + 512 bytes for the VHD footer).	int

Encryption

Name	Description	Value
diskEncryptionSetId	ResourceId of the disk encryption set to use for enabling encryption at rest.	string
type	The type of key used to encrypt the data of the disk.	'EncryptionAtRestWithCustomerKey' 'EncryptionAtRestWithPlatformAndCustomerKeys' 'EncryptionAtRestWithPlatformKey'

EncryptionSettingsCollection

Name	Description	Value
enabled	Set this flag to true and provide DiskEncryptionKey and optional KeyEncryptionKey to enable encryption. Set this flag to false and remove DiskEncryptionKey and KeyEncryptionKey to disable encryption. If EncryptionSettings is null in the request object, the existing settings remain unchanged.	bool (required)
encryptionSettings	A collection of encryption settings, one for each disk volume.	EncryptionSettingsElement[]
encryptionSettingsVersion	Describes what type of encryption is used for the disks. Once this field is set, it cannot be overwritten. '1.0' corresponds to Azure Disk Encryption with AAD app.'1.1' corresponds to Azure Disk Encryption.	string

EncryptionSettingsElement

Name	Description	Value
diskEncryptionKey	Key Vault Secret Url and vault id of the disk encryption key	KeyVaultAndSecretReference
keyEncryptionKey	Key Vault Key Url and vault id of the key encryption key. KeyEncryptionKey is optional and when provided is used to unwrap the disk encryption key.	KeyVaultAndKeyReference

ExtendedLocation

Name	Description	Value
name	The name of the extended location.	string
type	The type of the extended location.	'EdgeZone'

ImageDiskReference

Name	Description	Value
id	A relative uri containing either a Platform Image Repository or user image reference.	string (required)
lun	If the disk is created from an image's data disk, this is an index that indicates which of the data disks in the image to use. For OS disks, this field is null.	int

KeyVaultAndKeyReference

Name	Description	Value
keyUrl	Url pointing to a key or secret in KeyVault	string (required)
sourceVault	Resource id of the KeyVault containing the key or secret	SourceVault (required)

KeyVaultAndSecretReference

Name	Description	Value
secretUrl	Url pointing to a key or secret in KeyVault	string (required)
sourceVault	Resource id of the KeyVault containing the key or secret	SourceVault (required)

Microsoft.Compute/snapshots

Name	Description	Value
extendedLocation	The extended location where the snapshot will be created. Extended location cannot be changed.	ExtendedLocation
location	Resource location	string (required)
name	The resource name	string (required)
properties	Snapshot resource properties.	SnapshotProperties
sku	The snapshots sku name. Can be Standard_LRS, Premium_LRS, or Standard_ZRS. This is an optional parameter for incremental snapshot and the default behavior is the SKU will be set to the same sku as the previous snapshot	SnapshotSku
tags	Resource tags	Dictionary of tag names and values.
type	The resource type	"Microsoft.Compute/snapshots@2020-09-30"

PurchasePlan

Name	Description	Value
name	The plan ID.	string (required)
product	Specifies the product of the image from the marketplace. This is the same value as Offer under the imageReference element.	string (required)
promotionCode	The Offer Promotion Code.	string
publisher	The publisher ID.	string (required)

ResourceTags

Name	Description	Value

SnapshotProperties

Name	Description	Value
creationData	Disk source information. CreationData information cannot be changed after the disk has been created.	CreationData (required)
diskAccessId	ARM id of the DiskAccess resource for using private endpoints on disks.	string
diskSizeGB	If creationData.createOption is Empty, this field is mandatory and it indicates the size of the disk to create. If this field is present for updates or creation with other options, it indicates a resize. Resizes are only allowed if the disk is not attached to a running VM, and can only increase the disk's size.	int
encryption	Encryption property can be used to encrypt data at rest with customer managed keys or platform managed keys.	Encryption
encryptionSettingsCollection	Encryption settings collection used be Azure Disk Encryption, can contain multiple encryption settings per disk or snapshot.	EncryptionSettingsCollection
hyperVGeneration	The hypervisor generation of the Virtual Machine. Applicable to OS disks only.	'V1' 'V2'
incremental	Whether a snapshot is incremental. Incremental snapshots on the same disk occupy less space than full snapshots and can be diffed.	bool
networkAccessPolicy	Policy for accessing the disk via network.	'AllowAll' 'AllowPrivate' 'DenyAll'
osType	The Operating System type.	'Linux' 'Windows'
purchasePlan	Purchase plan information for the image from which the source disk for the snapshot was originally created.	PurchasePlan

SnapshotSku

Name	Description	Value
name	The sku name.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'

SourceVault

Name	Description	Value
id	Resource Id	string

Share via

Microsoft.Compute snapshots 2020-09-30

Bicep resource definition

Resource format

Property values

CreationData

Encryption

EncryptionSettingsCollection

EncryptionSettingsElement

ExtendedLocation

ImageDiskReference

KeyVaultAndKeyReference

KeyVaultAndSecretReference

Microsoft.Compute/snapshots

PurchasePlan

ResourceTags

SnapshotProperties

SnapshotSku

SourceVault

ARM template resource definition

Resource format

Property values

CreationData

Encryption

EncryptionSettingsCollection

EncryptionSettingsElement

ExtendedLocation

ImageDiskReference

KeyVaultAndKeyReference

KeyVaultAndSecretReference

Microsoft.Compute/snapshots

PurchasePlan

ResourceTags

SnapshotProperties

SnapshotSku

SourceVault

Terraform (AzAPI provider) resource definition

Resource format

Property values

CreationData

Encryption

EncryptionSettingsCollection

EncryptionSettingsElement

ExtendedLocation

ImageDiskReference

KeyVaultAndKeyReference

KeyVaultAndSecretReference

Microsoft.Compute/snapshots

PurchasePlan

ResourceTags

SnapshotProperties

SnapshotSku

SourceVault

Feedback

Additional resources