SharePoint 迁移 API 简介

  • 项目

SharePoint 迁移 API 将内容大规模导入 SharePoint。 它将内容和清单包作为队列中的作业进行处理。 API 提供进程状态和日志，便于监视每个迁移作业的进度。

使用迁移 API 从文件共享、SharePoint Server 和其他基于云的服务迁移内容。

新增功能

2024 年 4 月

我们在事件中添加 JobEnd 了新字段，以指示为文件导入的计数和字节数。 有关详细信息 ，请查看 Azure 队列中的迁移事件 。

2024 年 1 月

我们重新格式化了本文档，以明确并更正错误。

迁移步骤概述

通过三个步骤启动迁移作业。 查看本部分中每个步骤中的指南。

预配目标容器和队列

使用 ProvisionMigrationContainers 方法预配容器。 有关详细信息，请参阅将Azure Blob 存储容器和 Azure 队列与迁移 API 配合使用。 如果需要，还可以使用自己的容器和队列。

准备内容

以定义的格式打包内容，并将其作为内容包上传到Azure Blob 存储容器。

检查 内容包 以查看详细要求。

Create清单文件

根据内容，创建 XML 格式的清单文件，并将其作为清单包上传到 Azure Blob 存储 容器。

检查 清单文件 以查看详细要求。

使用迁移 API 开始迁移并获取状态

CreateMigrationJob 方法创建迁移作业，该作业排队等待处理。 迁移 API 管理队列并返回状态和日志。 使用 CreateMigrationEncrypted 方法迁移加密的内容。 有关详细信息，请查看 SharePoint 迁移 API 参考 。

创建新的迁移作业后，迁移 API 将返回作业 ID。 根据需要，使用 GetMigrationJobStatus 方法跟踪导入的状态，并提供 Azure 队列。

迁移 API 在清单容器中生成日志。 检查日志条目以获取迁移结果。

最佳做法

使用基于应用的身份验证

迁移到 SPO 后端的工作负荷与最终用户生成的流量不同。 若要使用弹性功能正确分配资源，请在迁移解决方案中仅使用基于应用的身份验证。

请勿在迁移解决方案中使用用户模式。 在用户模式下运行迁移会触发增加限制，从而导致性能不佳。

若要详细了解如何注册应用 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 不会影响性能或限制。

使目标 SPO 站点保持未激活状态

若要避免迁移问题，请在迁移完成之前停用用户的目标站点。 源可以保持活动状态，允许读取和写入以保持工作效率。 迁移完成后，将用户切换到新的 SPO 目标站点。

性能

迁移 API 通过具有预配置的工作负荷管理设置的队列机制处理作业。 迁移 API 会尽最大努力处理作业，无需服务级别协议 (SLA) 或有保证的性能。

优化迁移性能

为了确保迁移项目的最佳性能，请务必仔细规划，尤其是在处理大规模迁移时。 有关如何估计时间跨度和优化性能的详细信息，请参阅我们的 性能指南。

我看到限制消息

为了确保所有 Microsoft 365 客户都能获得良好的用户体验，SharePoint 使用限制来保护 SharePoint Online 基础结构。 按照限制指南避免受到 限制。

专题

迁移文件和文件夹的共享事件

有关使用文件和文件夹迁移共享事件元数据的说明，请参阅 共享 事件一文。

Web 部件

使用 SPMT 的 Web 部件序列化程序 DLL 将 Web 部件迁移到 SharePoint。 有关说明，请查看 迁移 Web 部件 。