Skip to content

Commit d72028d

Browse files
authored
Merge pull request #226009 from sipastak/ie-portal
import export portal updates
2 parents cd77580 + 881bc69 commit d72028d

5 files changed

+34
-146
lines changed

articles/import-export/storage-import-export-data-from-blobs.md

Lines changed: 16 additions & 102 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: alkohli
55
services: storage
66
ms.service: azure-import-export
77
ms.topic: tutorial
8-
ms.date: 03/14/2022
8+
ms.date: 02/13/2023
99
ms.author: alkohli
1010
ms.custom: "tutorial, devx-track-azurepowershell, devx-track-azurecli, contperf-fy21q3"
1111
---
@@ -40,9 +40,9 @@ You must:
4040
## Step 1: Create an export job
4141

4242

43-
# [Portal (Preview)](#tab/azure-portal-preview)
43+
# [Portal](#tab/azure-portal-preview)
4444

45-
Perform the following steps to order an import job in Azure Import/Export via the Preview portal. The Azure Import/Export service in preview will create a job of the type "Data Box."
45+
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."
4646

4747
1. Use your Microsoft Azure credentials to sign in at this URL: [https://portal.azure.com](https://portal.azure.com).
4848
1. Select **+ Create a resource** and search for *Azure Data Box*. Select **Azure Data Box**.
@@ -62,7 +62,7 @@ Perform the following steps to order an import job in Azure Import/Export via th
6262
1. Select the **Destination country/region** for the job.
6363
1. Then select **Apply**.
6464

65-
[![Screenshot of Get Started options for a new export order in Azure Import/Export's Preview portal. The Export From Azure transfer type and the Apply button are highlighted.](./media/storage-import-export-data-from-blobs/import-export-order-preview-03-export-job.png)](./media/storage-import-export-data-from-blobs/import-export-order-preview-03-export-job.png#lightbox)
65+
[![Screenshot of Get Started options for a new export order in Azure Import/Export's portal. The Export From Azure transfer type and the Apply button are highlighted.](./media/storage-import-export-data-from-blobs/import-export-order-preview-03-export-job.png)](./media/storage-import-export-data-from-blobs/import-export-order-preview-03-export-job.png#lightbox)
6666

6767
1. Choose the **Select** button for **Import/Export Job**.
6868

@@ -90,7 +90,7 @@ Perform the following steps to order an import job in Azure Import/Export via th
9090

9191
- Choose to export **All objects** in the storage account.
9292

93-
![Screenshot of the Job Details tab for a new export job in the Azure Import Export Jobs Preview portal. Export All is highlighted beside Blobs To Export.](./media/storage-import-export-data-from-blobs/import-export-order-preview-06-a-export-job.png)
93+
![Screenshot of the Job Details tab for a new export job in the Azure Import Export Jobs portal. Export All is highlighted beside Blobs To Export.](./media/storage-import-export-data-from-blobs/import-export-order-preview-06-a-export-job.png)
9494

9595
- 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.
9696

@@ -100,11 +100,11 @@ Perform the following steps to order an import job in Azure Import/Export via th
100100
|**Add blobs**|Specify individual blobs to export.<br>Select **Add blobs**. Then specify the relative path to the blob, beginning with the container name. Use *$root* to specify the root container.<br>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](storage-import-export-determine-drives-for-export.md#examples-of-valid-blob-paths).|
101101
|**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. |
102102

103-
:::image type="complex" source="./media/storage-import-export-data-from-blobs/import-export-order-preview-06-b-export-job.png" alt-text="Screenshot showing selected containers and blobs for a new Azure Import/Export export job in the Preview portal.":::
103+
:::image type="complex" source="./media/storage-import-export-data-from-blobs/import-export-order-preview-06-b-export-job.png" alt-text="Screenshot showing selected containers and blobs for a new Azure Import/Export export job in the portal.":::
104104
<Blob selections include a container, a blob, and blob prefixes that work like wildcards. The Add Prefixes pane on the right is used to add prefixes that select blobs based on common text in the blob path or name.>
105105
:::image-end:::
106106

107-
- 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 cannot be empty.
107+
- 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.
108108

109109
> [!IMPORTANT]
110110
> 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.
@@ -121,14 +121,14 @@ Perform the following steps to order an import job in Azure Import/Export via th
121121
1. In **Return shipping**:
122122

123123
1. Select a shipping carrier from the drop-down list for **Carrier**. The location of the Microsoft datacenter for the selected region determines which carriers are available.
124-
1. Enter a **Carrier account number**. The account number for an valid carrier account is required.
124+
1. Enter a **Carrier account number**. The account number for a valid carrier account is required.
125125
1. In the **Return address** area, use **+ Add Address** to add the address to ship to.
126126

127127
![Screenshot of the Return Shipping tab for an import job in Azure Data Box. The Return Shipping tab and the Plus Add Address button are highlighted.](./media/storage-import-export-data-from-blobs/import-export-order-preview-07-export-job.png)
128128

129129
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**.
130130

131-
![Screenshot showing an address on the Add Address blade for an import job in Azure Import Export Preview portal. The Add Shipping Address button is highlighted.](../../includes/media/storage-import-export-preview-import-steps/import-export-order-preview-08.png)
131+
![Screenshot showing an address on the Add Address blade for an import job in Azure Import Export portal. The Add Shipping Address button is highlighted.](../../includes/media/storage-import-export-preview-import-steps/import-export-order-preview-08.png)
132132

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

@@ -145,101 +145,15 @@ Perform the following steps to order an import job in Azure Import/Export via th
145145
1. 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.
146146
1. Select **Create**.
147147

148-
![Screenshot showing the Review Plus Create tab for an Azure Import/Export job in the Preview portal. The validation status, Terms, and Create button are highlighted.](./media/storage-import-export-data-from-blobs/import-export-order-preview-10-export-job.png)
148+
![Screenshot showing the Review Plus Create tab for an Azure Import/Export job in the portal. The validation status, Terms, and Create button are highlighted.](./media/storage-import-export-data-from-blobs/import-export-order-preview-10-export-job.png)
149149

150150
1. After the job is created, you'll see the following message.
151151

152-
![Screenshot of the status message for a completed order for an Azure Import Export job in the Preview portal. The status and the Go To Resource button are highlighted.](./media/storage-import-export-data-from-blobs/import-export-order-preview-11-export-job.png)
152+
![Screenshot of the status message for a completed order for an Azure Import Export job in the portal. The status and the Go To Resource button are highlighted.](./media/storage-import-export-data-from-blobs/import-export-order-preview-11-export-job.png)
153153

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

156-
[![Screenshot showing the Overview pane for an Azure Import Export job in Created state in the Preview portal.](./media/storage-import-export-data-from-blobs/import-export-order-preview-12-export-job.png)](./media/storage-import-export-data-from-blobs/import-export-order-preview-12-export-job.png#lightbox)
157-
158-
159-
# [Portal (Classic)](#tab/azure-portal-classic)
160-
161-
Perform the following steps to create an export job in the Azure portal using the classic Azure Import/Export service.
162-
163-
1. Sign in to the [Azure portal](https://portal.azure.com).
164-
2. Search for **import/export jobs**.
165-
166-
![Screenshot of the Search box at the top of the Azure Portal home page. A search key for the Import Export Jobs Service is entered in the Search box.](../../includes/media/storage-import-export-classic-import-steps/import-to-blob-1.png)
167-
168-
3. Select **+ Create**.
169-
170-
![Screenshot of the command menu at the top of the Azure Import Export Jobs home page in the Azure portal. The Plus Create command is highlighted.](../../includes/media/storage-import-export-classic-import-steps/import-to-blob-2.png)
171-
172-
4. In **Basics**:
173-
174-
1. Select a subscription.
175-
1. Select a resource group, or select **Create new** and create a new one.
176-
1. Enter a descriptive name for the import job. Use the name to track the progress of your jobs.
177-
* The name may contain only lowercase letters, numbers, and hyphens.
178-
* The name must start with a letter, and may not contain spaces.
179-
180-
1. Select **Export from Azure**.
181-
1. Select a **Source Azure region**.
182-
183-
If the new import/export experience is available in the selected region, you'll see a note inviting you to try the new experience. Select **Try now**, and follow the steps on the **Portal (Preview)** tab of this section to try the new experience with this order.
184-
185-
![Screenshot of the Basics tab for an Azure Import Export job. Export From Azure is selected. The Try Now link for the new import/export experience is highlighted.](./media/storage-import-export-data-from-blobs/export-from-blob-3.png)
186-
187-
Select **Next: Job Details >** to proceed.
188-
189-
5. In **Job details**:
190-
191-
1. Select the Azure region where your data currently is.
192-
1. Select the storage account from which you want to export data. Use a storage account close to your location.
193-
194-
The drop-off location is automatically populated based on the region of the storage account selected.
195-
196-
1. Specify the blob data to export from your storage account to your blank drive or drives. Choose one of the three following methods.
197-
198-
- Choose to **Export all** blob data in the storage account.
199-
200-
![Screenshot of the Job Details tab for a new export job in Azure Import Export Jobs. Export All is highlighted beside Blobs To Export.](./media/storage-import-export-data-from-blobs/export-from-blob-4.png)
201-
202-
- 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.
203-
204-
|Option|Description|
205-
|------|-----------|
206-
|**Add containers**|Export all blobs in a container.<br>Select **Add containers**, and enter each container name.|
207-
|**Add blobs**|Specify individual blobs to export.<br>Select **Add blobs**. Then specify the relative path to the blob, beginning with the container name. Use *$root* to specify the root container.<br>You must provide the blob paths in valid format to avoid errors during processing, as shown in this screenshot. For more information, see [Examples of valid blob paths](storage-import-export-determine-drives-for-export.md#examples-of-valid-blob-paths).|
208-
|**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. |
209-
210-
:::image type="complex" source="./media/storage-import-export-data-from-blobs/export-from-blob-5.png" alt-text="Screenshot showing selected containers and blobs for a new Azure Import/Export export job.":::
211-
<Blob selections include a container, a blob, and blob prefixes that work like wildcards. The Add Prefixes pane on the right is used to add prefixes that select blobs based on common text in the blob path or name.>
212-
:::image-end:::
213-
214-
- 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 cannot be empty.
215-
216-
> [!IMPORTANT]
217-
> 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.
218-
219-
To see how to add an XML file to a container, see [Export order using XML file](../databox/data-box-deploy-export-ordered.md#export-order-using-xml-file).
220-
221-
![Screenshot of Job Details for Azure Import/Export job that selects blobs using a blob list file. Blob list file option and selected file are highlighted.](./media/storage-import-export-data-from-blobs/export-from-blob-6.png)
222-
223-
> [!NOTE]
224-
> 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.
225-
226-
Select **Next: Shipping >** to proceed.
227-
228-
6. [!INCLUDE [storage-import-export-shipping-step.md](../../includes/storage-import-export-shipping-step.md)]
229-
230-
7. In **Review + create**:
231-
232-
1. Review the details of the job.
233-
1. Make a note of the job name and provided Azure datacenter shipping address for shipping disks to Azure.
234-
235-
> [!NOTE]
236-
> Always send the disks to the datacenter noted in the Azure portal. If the disks are shipped to the wrong datacenter, the job will not be processed.
237-
238-
1. Review the **Terms** for your order for privacy and source data deletion. If you agree to the terms, select the check box beneath the terms. Validation of the order begins.
239-
240-
![Screenshot showing the Review Plus Create tab for an Azure Import/Export job. The validation status, Terms, and Create button are highlighted.](./media/storage-import-export-data-from-blobs/export-from-blob-6-a.png)
241-
242-
8. After validation passes, select **Create**.
156+
[![Screenshot showing the Overview pane for an Azure Import Export job in Created state in the portal.](./media/storage-import-export-data-from-blobs/import-export-order-preview-12-export-job.png)](./media/storage-import-export-data-from-blobs/import-export-order-preview-12-export-job.png#lightbox)
243157

244158
# [Azure CLI](#tab/azure-cli)
245159

@@ -410,7 +324,7 @@ Install-Module -Name Az.ImportExport
410324

411325
## Step 2: Ship the drives
412326

413-
If you do not know the number of drives you need, see [Determine how many drives you need](storage-import-export-determine-drives-for-export.md#determine-how-many-drives-you-need). If you know the number of drives, proceed to ship the drives.
327+
If you don't know the number of drives you need, see [Determine how many drives you need](storage-import-export-determine-drives-for-export.md#determine-how-many-drives-you-need). If you know the number of drives, proceed to ship the drives.
414328

415329
[!INCLUDE [storage-import-export-ship-drives](../../includes/storage-import-export-ship-drives.md)]
416330

@@ -422,8 +336,8 @@ If you do not know the number of drives you need, see [Determine how many drives
422336

423337
When the dashboard reports the job is complete, the disks are shipped to you and the tracking number for the shipment is available in the portal.
424338

425-
1. After you receive the drives with exported data, you need to get the BitLocker keys to unlock the drives. Go to the export job in the Azure portal. Click **Import/Export** tab.
426-
2. Select and click your export job from the list. Go to **Encryption** and copy the keys.
339+
1. After you receive the drives with exported data, you need to get the BitLocker keys to unlock the drives. Go to the export job in the Azure portal. Select **Import/Export** tab.
340+
2. Select your export job from the list. Go to **Encryption** and copy the keys.
427341

428342
![Screenshot of the Encryption blade for an export job in Azure Import Export Jobs. The Encryption menu item and Copy button for the key are highlighted.](./media/storage-import-export-data-from-blobs/export-from-blob-7.png)
429343

@@ -437,7 +351,7 @@ Use the following command to unlock the drive:
437351

438352
`WAImportExport Unlock /bk:<BitLocker key (base 64 string) copied from Encryption blade in Azure portal> /driveLetter:<Drive letter>`
439353

440-
Here is an example of the sample input.
354+
Here's an example of the sample input.
441355

442356
`WAImportExport.exe Unlock /bk:CAAcwBoAG8AdQBsAGQAIABiAGUAIABoAGkAZABkAGUAbgA= /driveLetter:e`
443357

0 commit comments

Comments
 (0)