Skip to content

Commit 2d2b75b

Browse files
committed
Updates.
1 parent ae68f1c commit 2d2b75b

File tree

2 files changed

+38
-5
lines changed

2 files changed

+38
-5
lines changed

articles/virtual-machines/disks-incremental-snapshots.md

Lines changed: 35 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,9 @@ yourDiskID=$(az disk show -n $diskName -g $resourceGroupName --query "id" --outp
4040
az snapshot create -g $resourceGroupName -n $snapshotName --source $yourDiskID --incremental true
4141
```
4242

43+
> [!IMPORTANT]
44+
> When taking a snapshot of an Ultra Disk, you must wait for the snapshot to complete before you can use it. See the [CLI](#cli) section of the Check status section for details.
45+
4346
You can identify incremental snapshots from the same disk with the `SourceResourceId` property of snapshots. `SourceResourceId` is the Azure Resource Manager resource ID of the parent disk.
4447

4548
You can use `SourceResourceId` to create a list of all snapshots associated with a particular disk. Replace `yourResourceGroupNameHere` with your value and then you can use the following example to list your existing incremental snapshots:
@@ -83,6 +86,9 @@ $snapshotConfig=New-AzSnapshotConfig -SourceUri $yourDisk.Id -Location $yourDisk
8386
New-AzSnapshot -ResourceGroupName $resourceGroupName -SnapshotName $snapshotName -Snapshot $snapshotConfig
8487
```
8588

89+
> [!IMPORTANT]
90+
> When taking a snapshot of an Ultra Disk, you must wait for the snapshot to complete before you can use it. See the [PowerShell](#powershell) section of the Check status section for details.
91+
8692
You can identify incremental snapshots from the same disk with the `SourceResourceId` and the `SourceUniqueId` properties of snapshots. `SourceResourceId` is the Azure Resource Manager resource ID of the parent disk. `SourceUniqueId` is the value inherited from the `UniqueId` property of the disk. If you delete a disk and then create a new disk with the same name, the value of the `UniqueId` property changes.
8793

8894
You can use `SourceResourceId` and `SourceUniqueId` to create a list of all snapshots associated with a particular disk. Replace `yourResourceGroupNameHere` with your value and then you can use the following example to list your existing incremental snapshots:
@@ -109,7 +115,7 @@ $incrementalSnapshots
109115

110116
# [Resource Manager Template](#tab/azure-resource-manager)
111117

112-
You can also use Azure Resource Manager templates to create an incremental snapshot. You'll need to make sure the apiVersion is set to **2019-03-01** and that the incremental property is also set to true. The following snippet is an example of how to create an incremental snapshot with Resource Manager templates:
118+
You can also use Azure Resource Manager templates to create an incremental snapshot. You'll need to make sure the apiVersion is set to **2022-03-22** and that the incremental property is also set to true. The following snippet is an example of how to create an incremental snapshot with Resource Manager templates:
113119

114120
```json
115121
{
@@ -130,7 +136,7 @@ You can also use Azure Resource Manager templates to create an incremental snaps
130136
"type": "Microsoft.Compute/snapshots",
131137
"name": "[concat( parameters('diskName'),'_snapshot1')]",
132138
"location": "[resourceGroup().location]",
133-
"apiVersion": "2019-03-01",
139+
"apiVersion": "2022-03-22",
134140
"properties": {
135141
"creationData": {
136142
"createOption": "Copy",
@@ -204,6 +210,33 @@ foreach ($snapshot in $snapshots)
204210
$incrementalSnapshots
205211
```
206212

213+
Use the following script to get the `CompletionPercent` of an individual snapshot.
214+
215+
```azurepowershell
216+
$resourceGroupName = "yourResourceGroupNameHere"
217+
$snapshotName = "yourSnapshotName"
218+
219+
$targetSnapshot=Get-AzSnapshot -ResourceGroupName $resourceGroupName -SnapshotName $snapshotName
220+
221+
$targetSnapshot.CompletionPercent
222+
```
223+
224+
## Check disk creation status
225+
226+
When creating a disk from an Ultra Disk snapshot, you must wait for the background copy process to complete before you can attach it. Currently, you must use the Azure CLI to check the progress of the copy process.
227+
228+
The following script gives you the status:
229+
230+
```azurecli
231+
subscriptionId=yourSubscriptionID
232+
resourceGroupName=yourResourceGroupName
233+
diskName=yourDiskName
234+
235+
az account set --subscription $subscriptionId
236+
237+
az disk show –n $diskName -g $resourceGroupName --query [completionPercent] -o tsv
238+
```
239+
207240
## Check sector size
208241

209242
Snapshots with a 4096 logical sector size can only be used to create Ultra Disks. They can't be used to create other disk types. Snapshots of disks with 4096 logical sector size are stored as VHDX, whereas snapshots of disks with 512 logical sector size are stored as VHD. Snapshots inherit the logical sector size from the parent disk.

includes/virtual-machines-disks-incremental-snapshots-restrictions.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
author: roygara
66
ms.service: virtual-machines
77
ms.topic: include
8-
ms.date: 01/23/2023
8+
ms.date: 01/25/2023
99
ms.author: rogarana
1010
ms.custom: include file
1111
---
@@ -23,7 +23,7 @@
2323

2424
- You must request and receive access to the preview from the following link: [https://aka.ms/UltraPremiumv2SnapshotPreview](https://aka.ms/UltraPremiumv2SnapshotPreview)
2525
- Currently only available in Sweden Central and US West 3.
26-
- Snapshots with a 4096 logical sector size can only be used to create Ultra Disks. They can't be used to create other disk types. To determine what sector size your snapshot has, see [check sector size](#check-sector-size).
26+
- Snapshots with a 4096 logical sector size are stored as VHDX and can only be used to create Ultra Disks. They can't be used to create other disk types. To determine what sector size your snapshot has, see [check sector size](#check-sector-size).
2727
- When an incremental snapshot of an Ultra Disk is created, a background copy process for that disk is started. While a background copy is ongoing, you can have up to three total snapshots pending. The process must complete before any additional snapshots of that disk can be created.
2828
- Incremental snapshots of an Ultra disk can't be used immediately after they're created. The background copy must complete before you can create a disk from the snapshot. See [check snapshot status](#check-snapshot-status) for details.
29-
- Disks created from an incremental snapshot of an Ultra Disk can't be immediately attached to a VM once it's created. The background copy must complete before it can be attached. See [check snapshot status](#check-snapshot-status) for details.
29+
- Disks created from an incremental snapshot of an Ultra Disk can't be immediately attached to a VM once it's created. The background copy must complete before it can be attached. See [Check disk creation status](#-check-disk-creation-status) for details.

0 commit comments

Comments
 (0)