Présentation de l’API de migration SharePoint

L’API de migration SharePoint importe le contenu dans SharePoint à grande échelle. Il traite les packages de contenu et de manifeste en tant que travaux dans une file d’attente. L’API fournit des status de processus et des journaux, ce qui facilite la surveillance de la progression de chaque travail de migration.

Utilisez l’API de migration pour migrer du contenu à partir de partages de fichiers, de SharePoint Server et d’autres services cloud.

Nouveautés

Décembre 2024

Nous avons appliqué un quota sur les éléments Partager avec moi par utilisateur. Pour plus d’informations, consultez Quota d’événements ShareWithMe .

Novembre 2024

Nous avons activé la journalisation de tous les événements au niveau du fichier pendant la migration, tels que la suppression de fichiers, pour prendre en charge l’audit.

Juillet 2024

Nous avons commencé à appliquer des connexions HTTPS aux conteneurs Stockage Blob Azure fournis par SharePoint en ajoutant un spr=https champ dans les jetons SAP. Cette application prendra effet le 21 juillet 2024. Pour plus d’informations, consultez Utiliser des conteneurs Stockage Blob Azure et Azure Files d’attente avec l’API de migration SharePoint.

Avril 2024

Nous avons ajouté de nouveaux champs dans JobEnd les événements pour indiquer le nombre et les octets importés pour les fichiers. Pour plus d’informations, consultez Événements de migration dans la file d’attente Azure .

Janvier 2024

Nous avons reformaté ce document pour apporter de la clarté et corriger les erreurs.

Vue d’ensemble des étapes de migration

Démarrez une tâche de migration en trois étapes. Consultez les instructions de chacune des étapes de cette section.

Provisionner les conteneurs de destination et la file d’attente

Utilisez la ProvisionMigrationContainers méthode pour provisionner les conteneurs. Pour plus d’informations, consultez Utiliser des conteneurs Stockage Blob Azure et Azure Files d’attente avec l’API de migration. Vous pouvez également utiliser vos propres conteneurs et files d’attente si nécessaire.

Préparer le contenu

Empaquetez le contenu dans le format défini et chargez-le dans Stockage Blob Azure Conteneurs en tant que package de contenu.

Consultez Package de contenu pour voir les exigences détaillées.

Créer les fichiers manifestes

En fonction du contenu, créez des fichiers manifeste au format XML et chargez-les dans Stockage Blob Azure Conteneurs en tant que package de manifeste.

Vérifiez les fichiers manifeste pour afficher les exigences détaillées.

Utiliser l’API de migration pour démarrer la migration et obtenir status

La CreateMigrationJob méthode crée un travail de migration, qui est mis en file d’attente pour traitement. L’API de migration gère la file d’attente et retourne status et les journaux. Utilisez la CreateMigrationEncrypted méthode pour migrer du contenu chiffré. Pour plus d’informations, consultez Référence de l’API de migration SharePoint .

Lors de la création d’un travail de migration, l’API de migration retourne l’ID de travail. Suivez les status de l’importation avec l’API GetMigrationJobProgress.

L’API de migration génère des journaux dans le conteneur de manifeste. Vérifiez les entrées du journal pour obtenir les résultats de la migration.

L’API de migration génère également des journaux d’activité au niveau du fichier effectuées par la migration. Les activités prises en charge au niveau du fichier incluent FileUploaded, FileDeleted, FileRenamed, FileMoved. Si nécessaire, consultez le Centre Administration M365 pour plus d’informations sur l’activité.

Meilleures pratiques

Utiliser l’authentification basée sur l’application

La migration génère une charge de travail vers le serveur principal SharePoint différemment du trafic généré par l’utilisateur final. Pour allouer correctement des ressources avec notre fonctionnalité élastique, utilisez uniquement l’authentification basée sur l’application dans votre solution de migration.

N’utilisez pas le mode utilisateur dans votre solution de migration. L’exécution de la migration en mode utilisateur déclenche une limitation accrue, ce qui entraîne des performances médiocres.

Pour en savoir plus sur l’inscription d’un ID d’application et sur l’implémentation de l’authentification basée sur l’application, case activée Guide pratique pour inscrire un ID d’application et conseils d’authentification Microsoft Graph.

autorisations Microsoft Entra ID

Microsoft Entra ID fournit deux types d’autorisations : autorisation déléguée et autorisations d’application. Pour plus d’informations, consultez Autorisations et consentement dans le point de terminaison Azure Active Directory v1.0 .

Pour les scénarios de migration SharePoint et OneDrive, suivez la spécification d’autorisation Microsoft Entra ID.

Pour les outils de migration qui s’appuient sur la présence et la connexion de l’utilisateur final, utilisez l’autorisation déléguée.

Pour les outils de migration basés sur les services qui s’exécutent sans utilisateur connecté présent, comme les applications qui s’exécutent en tant que services en arrière-plan, utilisez l’autorisation Application.

ID d’application

Vous pouvez choisir de partager un ID d’application unique pour couvrir plusieurs solutions de migration créées ou créer un ID d’application individuel pour chacun des produits. Veillez à inscrire les ID d’application. Le partage d’ID d’application n’affecte pas les performances ou la limitation.

Conserver le site SharePoint de destination non activé

Pour éviter les problèmes de migration, désactivez le site cible pour les utilisateurs jusqu’à la fin de la migration. La source peut rester active, ce qui permet un accès en lecture et en écriture pour maintenir la productivité. Basculer les utilisateurs vers les nouveaux sites de destination SharePoint une fois la migration terminée.

Performances

L’API de migration traite les travaux via un mécanisme de file d’attente avec des paramètres de gestion des charges de travail préconfigurés. L’API de migration traite les travaux au mieux, sans contrat de niveau de service (SLA) ni garantie de performances.

Optimiser les performances de migration

Afin de garantir des performances optimales pour vos projets de migration, il est important de planifier soigneusement, en particulier lorsque vous traitez des migrations à grande échelle. Pour plus d’informations sur l’estimation des intervalles de temps et l’optimisation des performances, consultez notre guide des performances.

Je vois des messages de limitation

Pour garantir de bonnes expériences utilisateur pour tous les clients Microsoft 365, SharePoint utilise la limitation pour protéger l’infrastructure SharePoint. Évitez d’être limité en suivant les instructions de limitation.

Articles spéciaux

Migration des événements de partage de fichiers et de dossiers

Consultez l’article Événements de partage pour obtenir des instructions sur la migration des métadonnées d’événements partagés avec des fichiers et des dossiers.

Composants WebPart

Utilisez la DLL de sérialiseur de composants WebPart de l’outil de migration SharePoint (SPMT) pour migrer des composants WebPart vers SharePoint. Consultez Migrer des composants WebPart pour obtenir des instructions.