Tutorial: Export data from Azure Blob storage with Azure Import/Export

Perform the following steps to order an import job in Azure Import/Export. The Azure Import/Export service creates a job of the type "Data Box."

1. Use your Azure credentials to sign in at this URL: https://portal.azure.cn.

2. Select + Create a resource and search for Azure Data Box. Select Azure Data Box.

   

3. Select Create.

   

4. To get started with the import order, select the following options:

   1. Select the Export from Azure transfer type.
   2. Select the subscription to use for the Import/Export job.
   3. Select a resource group.
   4. Select the Source Azure region for the job.
   5. Select the Destination country/region for the job.
   6. Then select Apply.

   

5. Choose the Select button for Import/Export Job.

   

6. In Basics:

   • Enter a descriptive name for the job. Use the name to track the progress of your job.
     • The name must have from 3 to 24 characters.
     • The name must include only letters, numbers, and hyphens.
     • The name must start and end with a letter or number.

   

   Select Next: Job details > to proceed.

7. In Job Details:

   1. Select the Source Azure region where your data currently is.

   2. Select the storage account from which you want to export data. Use a storage account close to your location.

      The drop-off location is automatically populated based on the region of the storage account that you select.

   3. Specify the blob data to export from your storage account to your blank drive or drives. For Blobs to export, choose one of the three following methods.

      • Choose to export All objects in the storage account.

        

      • Choose Selected containers and blobs, and specify containers and blobs to export. You can use more than one of the selection methods. Selecting an Add option opens a panel on the right where you can add your selection strings.

        Option	Description
        Add containers	Export all blobs in a container. Select Add containers, and enter each container name.
        Add blobs	Specify individual blobs to export. Select Add blobs. Then specify the relative path to the blob, beginning with the container name. Use $root to specify the root container. You must provide the blob paths in valid format, as shown in this screenshot, to avoid errors during processing. For more information, see Examples of valid blob paths.
        Add prefixes	Use a prefix to select a set of similarly named containers or similarly named blobs in a container. The prefix may be the prefix of the container name, the complete container name, or a complete container name followed by the prefix of the blob name.

        

   • Choose Export from blob list file (XML format), and select an XML file that contains a list of paths and prefixes for the blobs to be exported from the storage account. You must construct the XML file and store it in a container for the storage account. The file can't be empty.

     Important

     If you use an XML file to select the blobs to export, make sure that the XML contains valid paths and/or prefixes. If the file is invalid or no data matches the paths specified, the order terminates with partial data or no data exported.

     

   Note

   If a blob to be exported is in use during data copy, the Azure Import/Export service takes a snapshot of the blob and copies the snapshot.

   Select Next: Return shipping > to proceed.

8. In Return shipping:

   1. Select a shipping carrier from the drop-down list for Carrier. The location of the Azure datacenter for the selected region determines which carriers are available.

   2. Enter a Carrier account number. The account number for a valid carrier account is required.

   3. In the Return address area, use + Add Address to add the address to ship to.

      

      On the Add Address blade, you can add an address or use an existing one. When you finish entering address information, select Add shipping address.

      

   4. In the Notification area, enter email addresses for the people you want to notify of the job's progress.

      Tip

      Instead of specifying an email address for a single user, provide a group email to ensure that you receive notifications even if an admin leaves.

   

   Select Review + Create to proceed.

9. In Review + Create:

   1. Review the Terms, and then select "I acknowledge that all the information provided is correct and agree to the terms and conditions above." Validation is then performed.
   2. Review the job information. Make a note of the job name and the Azure datacenter shipping address to ship disks back to. This information is used later on the shipping label.
   3. Select Create.

   

10. After the job is created, you'll see the following message.

    

    You can select Go to resource to open the Overview of the job.

    

Use the following steps to create an export job in the Azure portal. Azure CLI and Azure PowerShell create jobs in the classic Azure Import/Export service and hence create an Azure resource of the type "Import/Export job."

If you prefer to run CLI reference commands locally, install the Azure CLI. If you're running on Windows or macOS, consider running Azure CLI in a Docker container. For more information, see How to run the Azure CLI in a Docker container.

• If you're using a local installation, sign in to the Azure CLI by using the az login command. To finish the authentication process, follow the steps displayed in your terminal. For other sign-in options, see Sign in with the Azure CLI.

• When you're prompted, install the Azure CLI extension on first use. For more information about extensions, see Use extensions with the Azure CLI.

• Run az version to find the version and dependent libraries that are installed. To upgrade to the latest version, run az upgrade.

Create a job

1. Use the az extension add command to add the az import-export extension:

   az extension add --name import-export
   

2. To get a list of the locations from which you can receive disks, use the az import-export location list command:

   az import-export location list
   

3. Run the following az import-export create command to create an export job that uses your existing storage account:

   az import-export create \
       --resource-group myierg \
       --name Myexportjob1 \
       --location "China East" \
       --backup-drive-manifest true \
       --diagnostics-path waimportexport \
       --export blob-path=/ \
       --type Export \
       --log-level Verbose \
       --shipping-information recipient-name="Microsoft Azure Import/Export Service" \
           street-address1="XXXX XXXX" city="XXXX XXXX" state-or-province=CA postal-code=XXXXXX \
           country-or-region=China phone=XXXXXXXX \
       --return-address recipient-name="XXXX XXXX" street-address1="XXXX XXXXXX XXXX" \
           city=XXXX country-or-region=China state-or-province=CA postal-code=XXXXXX \
           email=gus@contoso.com phone=XXXXXXXX" \
       --storage-account myssdocsstorage
   

   Tip

   Instead of specifying an email address for a single user, provide a group email to ensure that you receive notifications even if an admin leaves.

   This job exports all the blobs in your storage account. You can specify a blob for export by replacing this value for --export:

   --export blob-path=$root/logo.bmp
   

   This parameter value exports the blob named logo.bmp in the root container.

   You also have the option of selecting all the blobs in a container by using a prefix. Replace this value for --export:

   blob-path-prefix=/myiecontainer
   

   For more information, see Examples of valid blob paths.

   Note

   If the blob to be exported is in use during data copy, Azure Import/Export service takes a snapshot of the blob and copies the snapshot.

4. Use the az import-export list command to see all the jobs for the resource group myierg:

   az import-export list --resource-group myierg
   

5. To update your job or cancel your job, run the az import-export update command:

   az import-export update --resource-group myierg --name MyIEjob1 --cancel-requested true
   

Use the following steps to create an export job in Azure PowerShell. Azure CLI and Azure PowerShell create jobs in the classic Azure Import/Export service and hence create an Azure resource of the type "Import/Export job."

Prerequisites

• If you choose to use Azure PowerShell locally:
  • Install the latest version of the Az PowerShell module.
  • Connect to your Azure account using the Connect-AzAccount -Environment AzureChinaCloud cmdlet.

Install-Module -Name Az.ImportExport

Create a job

1. To get a list of the locations from which you can receive disks, use the Get-AzImportExportLocation cmdlet:

   Get-AzImportExportLocation
   

2. Run the following New-AzImportExport example to create an export job that uses your existing storage account:

   $Params = @{
      ResourceGroupName = 'myierg'
      Name = 'Myexportjob1'
      Location = 'chinaeast'
      BackupDriveManifest = $true
      DiagnosticsPath = 'waimportexport'
      ExportBlobListblobPath = '\'
      JobType = 'Export'
      LogLevel = 'Verbose'
      ShippingInformationRecipientName = 'Microsoft Azure Import/Export Service'
      ShippingInformationStreetAddress1 = 'XXXX XXXX'
      ShippingInformationCity = 'XXXX XXXX'
      ShippingInformationStateOrProvince = 'CA'
      ShippingInformationPostalCode = 'XXXXXX'
      ShippingInformationCountryOrRegion = 'China'
      ShippingInformationPhone = '1234567890'
      ReturnAddressRecipientName = 'XXXX XXXX'
      ReturnAddressStreetAddress1 = 'XXXX XXXX'
      ReturnAddressCity = 'XXXX'
      ReturnAddressStateOrProvince = 'CA'
      ReturnAddressPostalCode = '94089'
      ReturnAddressCountryOrRegion = 'China'
      ReturnAddressPhone = '1234567890'
      ReturnAddressEmail = 'gus@contoso.com'
      StorageAccountId = '/subscriptions/<SubscriptionId>/resourceGroups/myierg/providers/Microsoft.Storage/storageAccounts/myssdocsstorage'
   }
   New-AzImportExport @Params
   

   Tip

   Instead of specifying an email address for a single user, provide a group email to ensure that you receive notifications even if an admin leaves.

   This job exports all the blobs in your storage account. You can specify a blob for export by replacing this value for -ExportBlobListblobPath:

   -ExportBlobListblobPath $root\logo.bmp
   

   This parameter value exports the blob named logo.bmp in the root container.

   You also have the option of selecting all the blobs in a container by using a prefix. Replace this value for -ExportBlobListblobPath:

   -ExportBlobListblobPath '/myiecontainer'
   

   For more information, see Examples of valid blob paths.

   Note

   If the blob to be exported is in use during data copy, Azure Import/Export service takes a snapshot of the blob and copies the snapshot.

3. Use the Get-AzImportExport cmdlet to see all the jobs for the resource group myierg:

   Get-AzImportExport -ResourceGroupName myierg
   

4. To update your job or cancel your job, run the Update-AzImportExport cmdlet:

   Update-AzImportExport -Name MyIEjob1 -ResourceGroupName myierg -CancelRequested
   

To complete the tracking information for a job that you created in the portal, do these steps:

1. Open the job in the Azure portal/.

2. On the Overview pane, scroll down to Tracking information and complete the entries:

   1. Provide the Carrier and Tracking number (e.g.ID:000000000000000000;SN:00000000000000).
      • For tracking numbers:
      • If ship by courier, please type valid courier numbers + Device serial numbers.
      • If ship by yourself, please type ID numbers + Device serial numbers.
   2. Make sure the Ship to address is correct.
   3. Select the checkbox by "Drives have been shipped to the above mentioned address."
   4. When you finish, select Update.

   

You can track the job progress on the Overview pane. For a description of each job state, go to View your job status.

If you created your Azure Import/Export job using Azure CLI, open the job in the Azure portal to update tracking information. Azure CLI and Azure PowerShell create jobs in the classic Azure Import/Export service and hence create an Azure resource of the type "Import/Export job."

If you created your Azure Import/Export job using Azure PowerShell, open the job in the Azure portal to update tracking information. Azure CLI and Azure PowerShell create jobs in the classic Azure Import/Export service and hence create an Azure resource of the type "Import/Export job."