Resolving Migration Throttling with the SharePoint Migration API
Performance degradation during a Microsoft 365 migration can often be improved by enabling the SharePoint Migration API. This API is designed to provide better performance and is enabled by default. It leverages Microsoft Azure for temporary data storage, streamlining the migration process.
Supported Platforms: The SharePoint Migration API can be used for migrations to and from Microsoft 365 and the following platforms:
- Google Workspace (Google Drive / Shared Drives)
- Box
- DropBox
- File System
- Another Microsoft 365 instance (OneDrive / Team Sites / Microsoft 365 Groups / Microsoft Teams)
- Google Cloud Storage
- Microsoft Azure Storage
How to Enable the SharePoint Migration API in CloudM Migrate
- Login to CloudM Migrate: Access your CloudM Migrate instance.
- Select Batch Configuration: Choose the relevant batch configuration or create a new one.
- Select Configuration page: In your batch configuration, navigate to the Configuration page.
- Select Source or Destination tab: Select the Source or Destination tab depending on which connection you would like to enable the SharePoint Migration API for.
- Enable API: Set the SharePoint Migration API option to enabled.
Configuring API Settings
Enabling the API will reveal several mandatory settings that require configuration.
| Setting | Description |
|---|---|
| SharePoint Migration API |
Source: Off by default Destination: On by default |
| SharePoint Storage |
Determines where the temporary migration data is stored. Note: This option only appears if SharePoint Migration API is enabled. Source: Uses Azure Storage and requires creating an Azure Storage Account and Key (see below). Destination: Offers two options: • Office 365: Uses a temporary storage container provided by Microsoft. No additional information is required in CloudM Migrate. This is typically recommended in small/medium scale migrations. • Azure Hosted: Allows you to use your own Azure storage container. This is typically recommended for large scale migrations. |
| Storage Account Name | Required when SharePoint Storage is Azure Hosted. The name of your source/destination Azure storage account. |
| Storage Account Key | Required when SharePoint Storage is Azure Hosted. The access key for your source/destination Azure storage account. |
| Retry Backoff (seconds) | The time in seconds CloudM Migrate waits between repeated attempts after a failure. |
| Retry Count | The maximum number of times an operation will be re-attempted before it is marked as failed. |
| SharePoint Admin Url |
Required if migrating files. The URL for your SharePoint admin center (e.g., https://yourtenant-admin.sharepoint.com). For more information see How to find the SharePoint Admin Url. |
Creating an Azure Storage Account and Key
To get the required 'Storage Account Name' and 'Storage Account Key', you must create a storage account in Microsoft Azure.
- Navigate to Azure Portal: Go to https://portal.azure.com/.
- Open Storage Accounts: From the main menu, select Storage accounts.
- Create New Account: Click Add to start the process of creating a new Azure storage account. Follow the on-screen instructions.
- Find Access Keys: Once the account is created, navigate to it and find the Access keys page. This page contains the Storage account name and the corresponding key required for the CloudM Migrate configuration.
Mapping Group Permissions to OneDrive
When migrating to OneDrive and mapping document permissions from a source group, the destination group in Microsoft 365 must be one of the following types:
- Microsoft 365 Group
- Mail-enabled security group
- Security group
Important: CloudM Migrate cannot map permissions to standard distribution groups.
Mapping Examples:
| Source Group | Destination Mapping Format |
|---|---|
| Microsoft 365 Group |
"examplem365groupsource@test.thecloudmigrator.com" > "ExampleM365Group@M365x91111111.onmicrosoft.com"
|
| Mail-Enabled Security Group |
"examplemailenabledsource@test.thecloudmigrator.com" > `"ExampleMailEnabled@M365x91111111.onmicrosoft.com |
| Security Group |
"examplesecuritysource@test.thecloudmigrator.com" > `"ExampleSecurity |