SharePoint 迁移 API 将内容大规模导入 SharePoint。 它将内容和清单包作为队列中的作业进行处理。 API 提供进程状态和日志，便于监视每个迁移作业的进度。
使用迁移 API 从文件共享、SharePoint Server 和其他基于云的服务迁移内容。
新增功能
2024 年 12 月
我们对每个用户 的“与我共享 ”项目应用了配额。 有关更多详细信息，请查看 ShareWithMe 事件配额 。
2024 年 11 月
我们启用了在迁移期间记录所有文件级事件（例如文件删除）以支持审核。
2024 年 7 月
我们开始通过在 SAS 令牌中添加字段spr=https来强制建立与 SharePoint 提供的Azure Blob 存储容器的 HTTPS 连接。 此强制措施将于 2024 年 7 月 21 日完全生效。 有关详细信息，请参阅将Azure Blob 存储容器和 Azure 队列与 SharePoint 迁移 API 配合使用。
2024 年 4 月
我们在事件中添加 JobEnd 了新字段，以指示为文件导入的计数和字节数。 有关详细信息 ，请查看 Azure 队列中的迁移事件 。
2024 年 1 月
我们重新格式化了本文档，以明确并更正错误。
迁移步骤概述
通过三个步骤启动迁移作业。 查看本部分中每个步骤中的指南。
预配目标容器和队列
重要
使用 GetMigrationJobProgress API 检索迁移作业状态。
不再需要为迁移作业状态跟踪预配 Azure 队列。 计划于 2026 年下半年弃用。 在此之前，Azure 队列仍可用于状态检索。
ProvisionMigrationContainers使用 方法预配容器。 有关详细信息，请参阅将Azure Blob 存储容器和 Azure 队列与迁移 API 配合使用。 如果需要，还可以使用自己的容器和队列。
准备内容
以定义的格式打包内容，并将其作为内容包上传到Azure Blob 存储容器。
检查 内容包 以查看详细要求。
创建清单文件
根据内容，创建 XML 格式的清单文件，并将其作为清单包上传到 Azure Blob 存储 容器。
检查 清单文件 以查看详细要求。
使用迁移 API 开始迁移并获取状态
方法 CreateMigrationJob 创建迁移作业，该作业排队等待处理。 迁移 API 管理队列并返回状态和日志。
CreateMigrationEncrypted使用 方法迁移加密的内容。 有关详细信息，请查看 SharePoint 迁移 API 参考 。
重要
使用 GetMigrationJobProgress API 跟踪迁移作业状态。
创建新的迁移作业后，迁移 API 将返回作业 ID。 使用 GetMigrationJobProgress API 跟踪导入状态。
迁移 API 在清单容器中生成日志。 检查日志条目以获取迁移结果。
迁移 API 还会生成迁移执行的文件级活动的日志。 支持的文件级活动包括 FileUploaded、FileDeleted、FileRenamed、FileMoved。 如果需要，请查看 M365 管理员中心以获取活动详细信息。
最佳做法
使用基于应用的身份验证
迁移到 SharePoint 后端的工作负荷与最终用户生成的流量不同。 若要使用弹性功能正确分配资源，请在迁移解决方案中仅使用基于应用的身份验证。
请勿在迁移解决方案中使用用户模式。 在用户模式下运行迁移会触发增加限制，从而导致性能不佳。
若要详细了解如何注册应用 ID 以及如何实现基于应用的身份验证，检查如何注册应用 ID 和 Microsoft Graph 身份验证指南。
Microsoft Entra ID权限
Microsoft Entra ID提供两种类型的权限：委托权限和应用程序权限。 有关详细信息 ，请查看 Azure Active Directory v1.0 终结点中的权限和同意 。
对于 SharePoint 和 OneDrive 迁移方案，请遵循Microsoft Entra ID权限规范。
对于依赖于最终用户登录和状态的迁移工具，请使用委托权限。
对于在没有登录用户的情况下运行的基于服务的迁移工具（例如作为后台服务运行的应用程序），请使用应用程序权限。
应用 ID
可以选择共享单个应用 ID，以涵盖创建的多个迁移解决方案，或为每个产品创建单独的应用 ID。 请确保注册应用 ID。 共享应用 ID 不会影响性能或限制。
使目标 SharePoint 网站保持未激活状态
若要避免迁移问题，请在迁移完成之前停用用户的目标站点。 源可以保持活动状态，允许读取和写入访问，以保持工作效率。 迁移完成后，将用户切换到新的 SharePoint 目标网站。
性能
迁移 API 通过具有预配置的工作负载管理设置的队列机制处理作业。 迁移 API 会尽最大努力处理作业，无需服务级别协议 (SLA) 或有保证的性能。
优化迁移性能
为了确保迁移项目的最佳性能，请务必仔细规划，尤其是在处理大规模迁移时。 有关如何估计时间跨度和优化性能的详细信息，请参阅我们的 性能指南。
我看到限制消息
为了确保所有 Microsoft 365 客户的良好用户体验，SharePoint 使用限制来保护 SharePoint 基础结构。 按照限制指南避免受到 限制。
特殊文章
迁移文件和文件夹的共享事件
有关使用文件和文件夹迁移共享事件元数据的说明，请参阅 共享 事件一文。
Web 部件
使用 SharePoint 迁移工具 (SPMT) 的 Web 部件序列化程序 DLL 将 Web 部件迁移到 SharePoint。 有关说明，请查看 迁移 Web 部件 。