Exclusion templates are sets of rules preventing certain file sizes or file names (defined using glob patterns) from being migrated to your target storage. You can create an exclusion template in the Azure Portal or with the CLI, which you can then apply to a migration as an exclusion. Exclusions are optional: you do not need to create any to create a migration.
Deleting an exclusion template will not cause exclusions based on it to be removed from current migrations.
- Create an exclusion template with the Azure Portal
- Create an exclusion template with the CLI
- In the Azure Portal, navigate to the LiveData Migrator resource page.
- From the LiveData Migrator menu on the left, click Exclusion Templates.
- Click Add.
- Complete the Basic details:
- Exclusion Name The name for the exclusion template.
- Exclusion Type Pick one from the drop down menu:
- File Size Exclusion = Value / Unit - The value and unit for the file size limit (for example: 100 GB).
- Pattern = Pattern - The glob pattern to be used for excluding file names and directory names (for example: /**/test*).
- Date Exclusion = Date - Any files that have been modified before the specified date will be excluded during migrations, in the format YYYY-MM-DD (for example: 2021-04-15).
- Description A brief description of what the exclusion is doing.
- Click Review + create.
- Click Create.
See the Azure CLI LiveData Extension - Exclusion Templates section for help with these parameters.
Create a file size exclusion template that will prevent files being migrated if they exceed a certain size.
Create a date-based exclusion template that checks the 'modified date' of any directory or file on the migration path. If the directory or file has a 'modified date' earlier than the specified date, it will be excluded from the migration.
The date will need to be defined in ISO format.
Create a glob exclusion template that will prevent files and/or directories being migrated if they match the glob pattern.
See our Azure CLI LiveData extension reference guide for commands to show and delete exclusion templates.
Once you have successfully created exclusion templates, you can add them to a new migration as exclusions [through the Portal](/live-data-platform/docs/migration-ldm#migrate-data-with-the-azure-portal or through the CLI), or add them as exclusions to an existing migration through the CLI.
Adding an exclusion to an existing migration through the portal will be possible in the next release.
If you are having trouble creating exclusion templates, you can find solutions in the troubleshooting guide.