Skip to content

Commit f869c04

Browse files
committed
Updates.
1 parent 2d2b75b commit f869c04

File tree

1 file changed

+13
-7
lines changed

1 file changed

+13
-7
lines changed

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

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ az snapshot create -g $resourceGroupName -n $snapshotName --source $yourDiskID -
4141
```
4242

4343
> [!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.
44+
> When taking a snapshot of an Ultra Disk, you must wait for the snapshot to complete before you can use it. See the [Check status of snapshots or disks](#check-status-of-snapshots-or-disks) section for details.
4545
4646
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.
4747

@@ -87,7 +87,7 @@ New-AzSnapshot -ResourceGroupName $resourceGroupName -SnapshotName $snapshotName
8787
```
8888

8989
> [!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.
90+
> When taking a snapshot of an Ultra Disk, you must wait for the snapshot to complete before you can use it. See the [Check status of snapshots or disks](#check-status-of-snapshots-or-disks) section for details.
9191
9292
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.
9393

@@ -113,6 +113,9 @@ $incrementalSnapshots
113113
# [Portal](#tab/azure-portal)
114114
[!INCLUDE [virtual-machines-disks-incremental-snapshots-portal](../../includes/virtual-machines-disks-incremental-snapshots-portal.md)]
115115

116+
> [!IMPORTANT]
117+
> When taking a snapshot of an Ultra Disk, you must wait for the snapshot to complete before you can use it. See the [Check status of snapshots or disks](#check-status-of-snapshots-or-disks) section for details.
118+
116119
# [Resource Manager Template](#tab/azure-resource-manager)
117120

118121
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:
@@ -148,13 +151,16 @@ You can also use Azure Resource Manager templates to create an incremental snaps
148151
]
149152
}
150153
```
154+
> [!IMPORTANT]
155+
> When taking a snapshot of an Ultra Disk, you must wait for the snapshot to complete before you can use it. See the [Check status of snapshots or disks](#check-status-of-snapshots-or-disks) section for details.
156+
151157
---
152158

153-
## Check snapshot status
159+
## Check status of snapshots or disks
154160

155161
Incremental snapshots of Ultra Disks (preview) can't be used to create new disks until the background process copying the data into the snapshot has completed. Similarly, Ultra Disks created from incremental snapshots can't be attached to a VM until the background process copying the data into the disk has completed.
156162

157-
You can check the status of this copy process with the scripts in the following sections.
163+
You can use either the [CLI](#cli) or [PowerShell](#powershell) sections to check the status of the background copy from a disk to a snapshot and you can use the [Check disk creation status](#check-disk-creation-status) section to check the status of a background copy from a snapshot to a disk.
158164

159165
### CLI
160166

@@ -174,7 +180,7 @@ diskId=$(az disk show -n $diskName -g $resourceGroupName --query [id] -o tsv)
174180
az snapshot list --query "[?creationData.sourceResourceId=='$diskId' && incremental]" -g $resourceGroupName --output table
175181
```
176182

177-
Now that you have a list of snapshots, you can check the `CompletionPercent` property of a snapshot to get its status. Replace `$sourceSnapshotName` with the name of your snapshot. The value of the property must be 100 before you can use the snapshot for restoring disk or generate a SAS URI for downloading the underlying data.
183+
Now that you have a list of snapshots, you can check the `CompletionPercent` property of an individual snapshot to get its status. Replace `$sourceSnapshotName` with the name of your snapshot. The value of the property must be 100 before you can use the snapshot for restoring disk or generate a SAS URI for downloading the underlying data.
178184

179185
```azurecli
180186
az snapshot show -n $sourceSnapshotName -g $resourceGroupName --query [completionPercent] -o tsv
@@ -210,7 +216,7 @@ foreach ($snapshot in $snapshots)
210216
$incrementalSnapshots
211217
```
212218

213-
Use the following script to get the `CompletionPercent` of an individual snapshot.
219+
Now that you have a list of snapshots, you can check the `CompletionPercent` property of an individual snapshot to get its status. Replace `yourResourceGroupNameHere` and `yourSnapshotName` then run the script. The value of the property must be 100 before you can use the snapshot for restoring disk or generate a SAS URI for downloading the underlying data.
214220

215221
```azurepowershell
216222
$resourceGroupName = "yourResourceGroupNameHere"
@@ -221,7 +227,7 @@ $targetSnapshot=Get-AzSnapshot -ResourceGroupName $resourceGroupName -SnapshotNa
221227
$targetSnapshot.CompletionPercent
222228
```
223229

224-
## Check disk creation status
230+
### Check disk creation status
225231

226232
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.
227233

0 commit comments

Comments
 (0)