Skip to content

Commit 89d9241

Browse files
committed
Adding GA content new copy mode and portal Learn More html anchors for deep-linking.
1 parent 65d3659 commit 89d9241

File tree

1 file changed

+12
-3
lines changed

1 file changed

+12
-3
lines changed

articles/storage-mover/job-definition-create.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,7 @@ Refer to the [resource naming convention](../azure-resource-manager/management/r
7474

7575
:::image type="content" source="media/job-definition-create/endpoint-source-new-sml.png" alt-text="Screen capture of the Source tab illustrating the location of the New Source Endpoint fields." lightbox="media/job-definition-create/endpoint-source-new-lrg.png":::
7676

77+
<a name="sub-path"></a>
7778
By default, migration jobs will start from the root of your share. However, if your use case involves copying data from a specific path within your source share, you can provide the path in the **Sub-path** field. Supplying this value will start the data migration from the location you've specified. If the sub path you've specified isn't found, no data will be copied.
7879

7980
Prior to creating an endpoint and a job resource, it's important to verify that the path you've provided is correct and that the data is accessible. You're unable to modify endpoints or job resources after they're created. If the specified path is wrong, you'll need to delete the resources and re-create them.
@@ -98,11 +99,18 @@ Refer to the [resource naming convention](../azure-resource-manager/management/r
9899

99100
1. Within the **Settings** tab, take note of the settings associated with the **Copy mode** and **Migration outcomes**. The service's **copy mode** will affect the behavior of the migration engine when files or folders change between copy iterations.
100101

101-
The current release of Azure Storage Mover only supports **merge** mode.
102+
<a name="copy-modes"></a>
103+
**Merge source into target:**
102104

103105
- Files will be kept in the target, even if they don’t exist in the source.
104106
- Files with matching names and paths will be updated to match the source.
105-
- Folder renames between copies may lead to duplicate content in the target.
107+
- File or folder renames between copies lead to duplicate content in the target.
108+
109+
**Mirror source to target:**
110+
111+
- Files in the target will be deleted if they don’t exist in the source.
112+
- Files and folders in the target will be updated to match the source.
113+
- File or folder renames between copies won't lead to duplicate content. A renamed item on the source side leads to the deletion of the item with the original name in the target and a new upload of the renamed item to the target. In case of folders this applies to all files and folders contained in it.
106114

107115
**Migration outcomes** are based upon the specific storage types of the source and target endpoints. For example, because blob storage only supports "virtual" folders, source files in folders will have their paths prepended to their names and placed in a flat list within a blob container. Empty folders will be represented as an empty blob in the target. Source folder metadata will be persisted in the custom metadata field of a blob, as they are with files.
108116

@@ -170,7 +178,8 @@ New-AzStorageMoverAzStorageContainerEndpoint `
170178
$projectName = "Your project name"
171179
$jobDefName = "Your job definition name"
172180
$JobDefDescription = "Optional, up to 1024 characters"
173-
$jobDefCopyMode = "Additive"
181+
$jobDefCopyMode = "Additive" # Merges source into target. See description in portal tab.
182+
#$jobDefCopyMode = "Mirror" # Mirrors source into target. See description in portal tab.
174183
$agentName = "The name of an agent previously registered to the same storage mover resource"
175184
176185

0 commit comments

Comments
 (0)