Migration Settings
Configure global migration settings including performance limits, retry policies, notification preferences, and default migration options. These settings apply to all new migration jobs unless overridden at the job level.
Performance Settings
Concurrency Limits
| Setting | Options | Default |
|---|---|---|
| Concurrent Migrations | 1, 2, 3, 5 | 3 migrations |
| Concurrent Mailboxes per Job | 5, 10, 20, 50 | 10 mailboxes |
| Items per Batch | 50, 100, 200, 500 | 100 items |
Bandwidth and Throttling
| Setting | Options | Default |
|---|---|---|
| Bandwidth Limit | No limit, 100 Mbps, 500 Mbps, 1 Gbps | 500 Mbps |
| Auto-throttle on errors | Reduce speed when API errors occur | Enabled |
| Respect source quotas | Honor API rate limits from source | Enabled |
Retry and Error Handling
| Setting | Options | Default |
|---|---|---|
| Retry Attempts | 1, 2, 3, 5 | 3 retries |
| Retry Delay | 30 seconds, 1 minute, 5 minutes, 15 minutes | 1 minute |
| Error Threshold | 1%, 5%, 10%, No limit | 5% (pause if exceeded) |
Error Actions
| Scenario | Options | Default |
|---|---|---|
| On permanent failure | Skip and continue, Pause migration, Stop migration | Skip and continue |
| On authentication error | Skip and continue, Pause migration, Stop migration | Pause migration |
| On size limit exceeded | Skip and log, Truncate and migrate, Pause for review | Skip and log |
Default Migration Options
Email Migration
- Migrate all folders — Include all mailbox folders (Enabled)
- Include deleted items — Migrate recoverable deleted items (Disabled)
- Include junk/spam — Migrate spam folder contents (Disabled)
- Preserve read status — Keep read/unread state (Enabled)
File Migration
- Convert Google formats — Convert Docs to Office formats (Enabled)
- Preserve sharing permissions — Recreate sharing links in target (Enabled)
- Include version history — Migrate file versions, limit 500 (Disabled)
- Include trashed files — Migrate items in trash (Disabled)
Scheduling
Default Schedule
| Setting | Options | Default |
|---|---|---|
| Start Time Preference | Immediately, Off-peak (10 PM - 6 AM), Weekends only, Custom | Off-peak hours |
| Timezone | Source tenant, Target tenant, UTC | Target tenant timezone |
Blackout Periods
Migrations will not run during these periods:
- Mon-Fri 8 AM - 6 PM
- 1st of Month (all day)
Notifications
| Notification | Default |
|---|---|
| Migration started | Enabled |
| Migration completed | Enabled |
| Migration failed | Enabled |
| Daily progress report | Disabled |
Configure notification recipients by entering email addresses for migration alerts.
API Reference
GET /api/migration/settings— Get migration settingsPUT /api/migration/settings— Update migration settings
Last updated on