Merge pull request #229914 from roygara/faqClean

Disk FAQ cleanup

Author: American-Dipper

articles/virtual-machines/disk-encryption.md

@@ -31,7 +31,7 @@ The following sections describe each of the options for key management in greate
 
 ### Platform-managed keys
 
-By default, managed disks use platform-managed encryption keys. All managed disks, snapshots, images, and data written to existing managed disks are automatically encrypted-at-rest with platform-managed keys.
+By default, managed disks use platform-managed encryption keys. All managed disks, snapshots, images, and data written to existing managed disks are automatically encrypted-at-rest with platform-managed keys. Platform-managed keys are managed by Microsoft.
 
 ### Customer-managed keys
 

articles/virtual-machines/disks-copy-incremental-snapshot-across-regions.md

@@ -4,7 +4,7 @@ description: Learn how to copy an incremental snapshot of a managed disk to a di
 author: roygara
 ms.service: storage
 ms.topic: how-to
-ms.date: 01/25/2023
+ms.date: 04/10/2023
 ms.author: rogarana
 ms.subservice: disks
 ms.custom: devx-track-azurepowershell, devx-track-azurecli 
@@ -25,6 +25,8 @@ This article covers copying an incremental snapshot from one region to another.
 
 - You can copy 100 incremental snapshots in parallel at the same time per subscription per region.
 - If you use the REST API, you must use version 2020-12-01 or newer of the Azure Compute REST API.
+- You can only copy one incremental snapshot of a particular disk at a time.
+- Snapshots must be copied in the order they were created.
 
 ## Managed copy
 
@@ -44,7 +46,13 @@ targetRegion=<validRegion>
 sourceSnapshotId=$(az snapshot show -n $sourceSnapshotName -g $resourceGroupName --query [id] -o tsv)
 
 az snapshot create -g $resourceGroupName -n $targetSnapshotName -l $targetRegion --source $sourceSnapshotId --incremental --copy-start
+```
+
+### Check copy status
+
+You can check the status of an individual snapshot by checking the `CompletionPercent` property. Replace `$sourceSnapshotName` with the name of your snapshot then run the following command. 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.
 
+```azurecli
 az snapshot show -n $sourceSnapshotName -g $resourceGroupName --query [completionPercent] -o tsv
 ```
 
@@ -74,12 +82,22 @@ $sourceSnapshot=Get-AzSnapshot -ResourceGroupName $resourceGroupName -SnapshotNa
 $snapshotconfig = New-AzSnapshotConfig -Location $targetRegion -CreateOption CopyStart -Incremental -SourceResourceId $sourceSnapshot.Id
 
 New-AzSnapshot -ResourceGroupName $resourceGroupName -SnapshotName $targetSnapshotName -Snapshot $snapshotconfig
+```
+
+### Check copy status
 
-$targetSnapshot=Get-AzSnapshot -ResourceGroupName $resourceGroupName -SnapshotName $targetSnapshotName
+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.
+
+```azurepowershell
+$resourceGroupName = "yourResourceGroupNameHere"
+$snapshotName = "yourSnapshotName"
+
+$targetSnapshot=Get-AzSnapshot -ResourceGroupName $resourceGroupName -SnapshotName $snapshotName
 
 $targetSnapshot.CompletionPercent
 ```
 
+
 # [Portal](#tab/azure-portal)
 
 You can also copy an incremental snapshot across regions in the Azure portal. However, you must use this specific link to access the portal, for now: https://aka.ms/incrementalsnapshot 
@@ -158,3 +176,5 @@ Incremental snapshots offer a differential capability. They enable you to get th
 ## Next steps
 
 If you'd like to see sample code demonstrating the differential capability of incremental snapshots, using .NET, see [Copy Azure Managed Disks backups to another region with differential capability of incremental snapshots](https://github.com/Azure-Samples/managed-disks-dotnet-backup-with-incremental-snapshots).
+
+If you have additional questions on snapshots, see the [snapshots](faq-for-disks.yml#snapshots) section of the FAQ.

articles/virtual-machines/disks-enable-private-links-for-import-export-portal.md

@@ -4,7 +4,7 @@ description: Enable Private Link for your managed disks with Azure portal. This
 author: roygara
 ms.service: storage
 ms.topic: how-to
-ms.date: 09/03/2021
+ms.date: 03/31/2023
 ms.author: rogarana
 ms.subservice: disks
 ---
@@ -88,5 +88,5 @@ You've now configured a private link that you can use to import and export your
 
 - Upload a VHD to Azure or copy a managed disk to another region - [Azure CLI](linux/disks-upload-vhd-to-managed-disk-cli.md) or [Azure PowerShell module](windows/disks-upload-vhd-to-managed-disk-powershell.md)
 - Download a VHD - [Windows](windows/download-vhd.md) or [Linux](linux/download-vhd.md)
-- [FAQ for private links and managed disks](./faq-for-disks.yml)
+- [FAQ for private links and managed disks](./faq-for-disks.yml#private-links-for-managed-disks)
 - [Export/Copy managed snapshots as VHD to a storage account in different region with PowerShell](/previous-versions/azure/virtual-machines/scripts/virtual-machines-powershell-sample-copy-snapshot-to-storage-account)

articles/virtual-machines/disks-enable-ultra-ssd.md

@@ -482,3 +482,4 @@ Update-AzDisk -ResourceGroupName $resourceGroup -DiskName $diskName -DiskUpdate
 
 - [Use Azure ultra disks on Azure Kubernetes Service (preview)](../aks/use-ultra-disks.md).
 - [Migrate log disk to an ultra disk](/azure/azure-sql/virtual-machines/windows/storage-migrate-to-ultradisk).
+- For additional questions on Ultra Disks, see the [Ultra Disks](faq-for-disks.yml#ultra-disks) section of the FAQ.

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

@@ -4,7 +4,7 @@ description: Learn about incremental snapshots for managed disks, including how
 author: roygara
 ms.service: storage
 ms.topic: how-to
-ms.date: 02/22/2023
+ms.date: 03/31/2023
 ms.author: rogarana
 ms.subservice: disks
 ms.custom: devx-track-azurepowershell, ignite-fall-2021, devx-track-azurecli, ignite-2022, references_regions, devx-track-arm-template
@@ -270,4 +270,6 @@ az snapshot show -g resourcegroupname -n snapshotname --query [creationData.logi
 
 See [Copy an incremental snapshot to a new region](disks-copy-incremental-snapshot-across-regions.md) to learn how to copy an incremental snapshot across regions.
 
+If you have additional questions on snapshots, see the [snapshots](faq-for-disks.yml#snapshots) section of the FAQ.
+
 If you'd like to see sample code demonstrating the differential capability of incremental snapshots, using .NET, see [Copy Azure Managed Disks backups to another region with differential capability of incremental snapshots](https://github.com/Azure-Samples/managed-disks-dotnet-backup-with-incremental-snapshots).

articles/virtual-machines/disks-reserved-capacity.md

@@ -91,7 +91,7 @@ You can cancel, exchange, or refund reservations within certain limitations. For
 
 ## Expiration of a reservation
 
-When a reservation expires, any Azure Disk Storage capacity that you use under that reservation is billed at the pay-as-you-go rate. Reservations don't renew automatically.
+When a reservation expires, any Azure Disk Storage capacity that you use under that reservation is billed at the [pay-as-you-go rate](https://azure.microsoft.com/pricing/details/managed-disks/). Reservations don't renew automatically.
 
 You'll receive an email notification 30 days before the expiration of the reservation and again on the expiration date. To continue taking advantage of the cost savings that a reservation provides, renew it no later than the expiration date.
 

articles/virtual-machines/disks-shared-enable.md

@@ -370,3 +370,5 @@ If you prefer to use Azure Resource Manager templates to deploy your disk, the f
 - [Premium SSD](https://aka.ms/SharedPremiumDiskARMtemplate)
 - [Regional ultra disks](https://aka.ms/SharedUltraDiskARMtemplateRegional)
 - [Zonal ultra disks](https://aka.ms/SharedUltraDiskARMtemplateZonal)
+
+If you've additional questions, see the [shared disks](faq-for-disks.yml#azure-shared-disks) section of the FAQ.

articles/virtual-machines/disks-shared.md

@@ -171,3 +171,5 @@ Both shared Ultra Disks and shared Premium SSD v2 managed disks are priced based
 ## Next steps
 
 If you're interested in enabling and using shared disks for your managed disks, proceed to our article [Enable shared disk](disks-shared-enable.md)
+
+If you've additional questions, see the [shared disks](faq-for-disks.yml#azure-shared-disks) section of the FAQ.