Общие сведения об API миграции SharePoint
API миграции SharePoint импортирует содержимое в SharePoint в большом масштабе. Он обрабатывает пакеты содержимого и манифеста как задания в очереди. API предоставляет состояние процесса и журналы, упрощая мониторинг хода выполнения каждого задания миграции.
Используйте API миграции для переноса содержимого из общих папок, SharePoint Server и других облачных служб.
Новые возможности
Июль 2024 г.
Мы начали принудительно применять HTTPS-подключение к контейнерам хранилища BLOB-объектов Azure в SharePoint, добавив spr=https поле в маркеры SAS. Это принудительное применение вступает в силу 21 июля 2024 г. Дополнительные сведения см. в статье Использование контейнеров хранилища BLOB-объектов Azure и очередей Azure с API миграции SharePoint .
Апрель 2024 г.
Мы добавили новые поля в JobEnd события для указания количества и байтов, импортированных для файлов. Дополнительные сведения см. в статье События миграции в очереди Azure .
Январь 2024 г.
Мы переформатировали этот документ, чтобы внести ясность и исправить ошибки.
Общие сведения о шагах миграции
Запустите задание миграции с помощью трех шагов. Ознакомьтесь с рекомендациями в каждом из шагов в этом разделе.
Подготовка целевых контейнеров и очереди
Используйте ProvisionMigrationContainers метод для подготовки контейнеров. Дополнительные сведения см. в статье Использование контейнеров хранилища BLOB-объектов Azure и очередей Azure с API миграции . При необходимости можно также использовать собственные контейнеры и очереди.
Подготовка содержимого
Упаковайте содержимое в определенном формате и отправьте его в контейнеры хранилища BLOB-объектов Azure в качестве пакета содержимого.
Ознакомьтесь с пакетом содержимого , чтобы просмотреть подробные требования.
Создание файлов манифеста
На основе содержимого создайте файлы манифеста в формате XML и отправьте их в контейнеры хранилища BLOB-объектов Azure в качестве пакета манифеста.
Проверьте файлы манифеста , чтобы просмотреть подробные требования.
Использование API миграции для запуска миграции и получения состояния
CreateMigrationJob метод создает задание миграции, которое помещается в очередь для обработки. API миграции управляет очередью и возвращает состояние и журналы. Используйте CreateMigrationEncrypted метод для переноса зашифрованного содержимого. Дополнительные сведения см. в справочнике по API миграции SharePoint .
После создания нового задания миграции API миграции возвращает идентификатор задания. При необходимости отслеживайте состояние импорта с помощью GetMigrationJobStatus метода с помощью указанной очереди Azure.
API миграции создает журналы в контейнере манифеста. Проверьте результаты миграции в записях журнала.
Рекомендация
Использование проверки подлинности на основе приложения
Миграция создает рабочую нагрузку в серверную часть SharePoint иначе, чем трафик, созданный конечным пользователем. Чтобы правильно распределить ресурсы с помощью нашей эластичной возможности, используйте только проверку подлинности на основе приложений в решении для миграции.
Не используйте пользовательский режим в решении для миграции. Выполнение миграции в пользовательском режиме приводит к увеличению регулирования, что приводит к снижению производительности.
Дополнительные сведения о регистрации идентификатора приложения и реализации проверки подлинности на основе приложения см. в статье Регистрация идентификатора приложения и руководство по проверке подлинности Microsoft Graph.
Разрешения Microsoft Entra ID
Идентификатор Microsoft Entra предоставляет два типа разрешений: делегированное разрешение и разрешения приложения. Дополнительные сведения см . в разделе Разрешения и согласие в конечной точке Azure Active Directory версии 1.0 .
Для сценариев миграции SharePoint и OneDrive следуйте спецификации разрешений Microsoft Entra ID.
Для средств миграции, основанных на входе и присутствии конечных пользователей, используйте делегированное разрешение.
Для средств миграции на основе служб, которые выполняются без вошедшего пользователя, например приложений, выполняющихся в качестве фоновых служб, используйте разрешение приложения.
Идентификаторы приложений
Вы можете предоставить общий доступ к одному идентификатору приложения, чтобы охватить несколько решений миграции, созданных или создав отдельный идентификатор приложения для каждого из продуктов. Обязательно зарегистрируйте идентификаторы приложений. Общий доступ к идентификаторам приложений не влияет на производительность или регулирование.
Не активируйте конечный сайт SharePoint
Чтобы избежать проблем с миграцией, деактивируйте целевой сайт для пользователей до завершения миграции. Источник может оставаться активным, что позволяет выполнять чтение и запись для повышения производительности. Переключение пользователей на новые целевые сайты SharePoint после завершения миграции.
Производительность
API миграции обрабатывает задания с помощью механизма очереди с предварительно настроенными параметрами управления рабочей нагрузкой. API миграции обрабатывает задания наилучшим образом, без соглашения об уровне обслуживания (SLA) или гарантированной производительности.
Оптимизация производительности миграции
Чтобы обеспечить оптимальную производительность проектов миграции, важно тщательно планировать, особенно при работе с крупномасштабными миграциями. Дополнительные сведения о том, как оценить интервалы времени и оптимизировать производительность, см. в нашем руководстве по производительности.
Отображаются сообщения о регулировании
Чтобы обеспечить хороший пользовательский интерфейс для всех клиентов Microsoft 365, SharePoint использует регулирование для защиты инфраструктуры SharePoint. Избегайте регулирования, следуя рекомендациям по регулированию.
Специальные статьи
Перенос событий общего доступа к файлам и папкам
Инструкции по переносу метаданных общих событий с файлами и папками см. в статье Общий доступ к событиям .
Веб-части
Используйте библиотеку DLL сериализатора веб-частей SharePoint (SPMT) для переноса веб-частей в SharePoint. Инструкции см. в разделе Миграция веб-частей .