Download managed data disks to Azure Local
Applies to: Azure Local, version 23H2
This article describes how to download an Azure managed disk from Azure to your Azure Local instance. You can then use the disk to create an image or to attach it to your Arc virtual machines (VMs) as needed.
Prerequisites
Before you begin, make sure to complete the following prerequisites:
- You have access to an Azure Local instance that is deployed and registered.
- There is already a managed disk in Azure.
Download an Azure managed disk
Download an Azure managed disk as follows:
Set parameters for
subscription
,resource-group
,name
, andcustom-location
. Replace the parameters in< >
with the appropriate values:$subscription = "<Subscription ID>" $resource-group = "<Resource group>" $name = "<Data disk name>" $custom-location = "<Custom location resource ID>"
Generate a SAS URL of the disk using Azure CLI:
az disk grant-access --access-level Read --duration-in-seconds 3600 --name $name --resource-group $resource-group
Once the SAS URL is generated, use the following command to download it to your Azure Local:
az stack-hci-vm disk create -resource-group $resource-group --disk-file-format vhd --custom-location $custom-location --download-url $download-url --name $name
The parameters are described in the following table:
Parameter | Description |
---|---|
subscription |
Subscription associated with your Azure Local. |
resource-group |
Resource group for Azure Local that you associate with this image. |
name |
Name of the data disk for Azure Local. |
custom-location |
Resource ID of the custom location for Azure Local. |
disk-file-format |
File format of the data disk. This can be vhd or vhdx . |
download-url |
SAS URL of the Azure managed disk. |
Here is an example output:
Download Uri for VHD is: https://*****
{
"extendedLocation": {
"name": "/subscriptions/resourceGroups/providers/Microsoft.ExtendedLocation/customLocations/",
"type": "CustomLocation"
},
"id": "/subscriptions/resourceGroups/providers/Microsoft.AzureStackHCI/virtualHardDisks/httpvhd02",
"location": "eastus2euap",
"name": "httpvhd02",
"properties": {
"blockSizeBytes": null,
"containerId": "/subscriptions/resourceGroups/providers/Microsoft.AzureStackHCI/storageContainers/UserStorage",
"diskFileFormat": "vhd",
"diskSizeGb": null,
"downloadUrl": null,
"dynamic": null,
"hyperVGeneration": null,
"logicalSectorBytes": null,
"physicalSectorBytes": null,
"provisioningState": "Succeeded",
"status": {
"downloadStatus": null,
"errorCode": "",
"errorMessage": "",
"provisioningStatus": null,
"uploadStatus": null
}
},
"resourceGroup": "myresourcegroup",
"systemData": {
"createdAt": "2024-09-25T20:41:27.685358+00:00",
"createdBy": "mycreatedby",
"createdByType": "Application",
"lastModifiedAt": "2024-09-25T20:41:41.082674+00:00",
"lastModifiedBy": "mylastmodifiedby",
"lastModifiedByType": "Application"
},
"tags": null,
"