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 l’état du processus et les 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

Juillet 2024

Nous avons commencé à appliquer une connexion HTTPS aux conteneurs de stockage Blob Azure fournis par SharePoint en ajoutant un spr=https champ dans les jetons SAP. Cette application entre en vigueur le 21 juillet 2024. Pour plus d’informations, consultez Utiliser des conteneurs de stockage Blob Azure et des files d’attente Azure 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 ProvisionMigrationContainers la méthode pour provisionner les conteneurs. Pour plus d’informations, consultez Utiliser des conteneurs de stockage Blob Azure et des files d’attente Azure 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 des conteneurs de stockage Blob Azure 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 des conteneurs de stockage Blob Azure 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 l’état

CreateMigrationJob 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 l’état 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 l’état de l’importation avec GetMigrationJobStatus la méthode si nécessaire, avec la file d’attente Azure fournie.

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.

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, consultez Guide pratique pour inscrire un ID d’application et conseils sur l’authentification Microsoft Graph.

Autorisations d’ID Microsoft Entra

L’ID Microsoft Entra fournit deux types d’autorisation : 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 d’ID Microsoft Entra.

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 de conserver la productivité en lecture et en écriture. 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.