Introducción a la API de migración de SharePoint
La API de migración de SharePoint importa contenido a SharePoint a escala. Procesa paquetes de contenido y manifiesto como trabajos en una cola. La API proporciona el estado del proceso y los registros, lo que facilita la supervisión del progreso de cada trabajo de migración.
Use Migration API para migrar contenido de recursos compartidos de archivos, SharePoint Server y otros servicios basados en la nube.
Novedades
Julio de 2024
Comenzamos a aplicar la conexión HTTPS a Los contenedores de Azure Blob Storage proporcionados por SharePoint agregando un spr=https campo en tokens de SAS. Esta aplicación es plenamente efectiva el 21 de julio de 2024. Consulte Uso de contenedores de Azure Blob Storage y colas de Azure con La API de migración de SharePoint para obtener más información.
Abril de 2024
Hemos agregado nuevos campos en JobEnd eventos para indicar el recuento y los bytes importados para los archivos. Consulte Eventos de migración en la cola de Azure para obtener más información.
Enero de 2024
Reformateamos este documento para aportar claridad y corregir errores.
Introducción a los pasos de migración
Inicie un trabajo de migración con tres pasos. Consulte las instrucciones de cada uno de los pasos de esta sección.
Aprovisionamiento de los contenedores de destino y la cola
Use ProvisionMigrationContainers el método para aprovisionar los contenedores. Consulte Uso de contenedores de Azure Blob Storage y colas de Azure con Migration API para obtener más información. También puede usar sus propios contenedores y colas si es necesario.
Preparación del contenido
Empaquete el contenido en el formato definido y cárguelo en contenedores de Azure Blob Storage como paquete de contenido.
Compruebe Paquete de contenido para ver los requisitos detallados.
Creación de los archivos de manifiesto
En función del contenido, cree archivos de manifiesto en formato XML y cárguelos en contenedores de Azure Blob Storage como paquete de manifiesto.
Compruebe Archivos de manifiesto para ver los requisitos detallados.
Uso de Migration API para iniciar la migración y obtener el estado
CreateMigrationJob el método crea un trabajo de migración, que se pone en cola para su procesamiento. Migration API administra la cola y devuelve el estado y los registros. Use CreateMigrationEncrypted el método para migrar contenido cifrado. Consulte Referencia de la API de migración de SharePoint para obtener más información.
Tras la creación de un nuevo trabajo de migración, Migration API devuelve el identificador de trabajo. Realice un seguimiento del estado de la importación con GetMigrationJobStatus el método si es necesario, con la cola de Azure proporcionada.
La API de migración genera registros en el contenedor de manifiestos. Compruebe las entradas de registro para ver los resultados de la migración.
Procedimiento recomendado
Usar autenticación basada en aplicaciones
La migración genera carga de trabajo al back-end de SharePoint de forma diferente al tráfico generado por el usuario final. Para asignar recursos correctamente con nuestra funcionalidad elástica, use solo la autenticación basada en aplicaciones en la solución de migración.
No use el modo de usuario en la solución de migración. La ejecución de la migración en modo de usuario desencadena una mayor limitación, lo que da lugar a un rendimiento deficiente.
Para obtener más información sobre cómo registrar un identificador de aplicación y cómo implementar la autenticación basada en aplicaciones, consulte How to register an app ID and Microsoft Graph Auth guidance (Cómo registrar un identificador de aplicación y la guía de autenticación de Microsoft Graph).
Permisos de id. de microsoft entra
Microsoft Entra ID proporciona dos tipos de permisos: Permisos delegados y Permisos de aplicación. Consulte Permisos y consentimiento en el punto de conexión de Azure Active Directory v1.0 para obtener más información.
Para escenarios de migración de SharePoint y OneDrive, siga la especificación del permiso Microsoft Entra ID.
Para las herramientas de migración que se basan en la presencia y el inicio de sesión del usuario final, use el permiso delegado.
Para las herramientas de migración basadas en servicios que se ejecutan sin un usuario que ha iniciado sesión, como las aplicaciones que se ejecutan como servicios en segundo plano, use el permiso De aplicación.
Identificadores de aplicación
Puede elegir compartir un único identificador de aplicación para cubrir varias soluciones de migración creadas o crear un identificador de aplicación individual para cada uno de los productos. Asegúrese de registrar los identificadores de aplicación. El uso compartido de identificadores de aplicación no afecta al rendimiento ni a la limitación.
Mantener el sitio de SharePoint de destino sin activar
Para evitar problemas de migración, desactive el sitio de destino para los usuarios hasta la finalización de la migración. El origen podría permanecer activo, lo que permite leer y escribir para mantener la productividad. Cambie los usuarios a los nuevos sitios de destino de SharePoint después de la finalización de la migración.
Rendimiento
La API de migración procesa trabajos a través de un mecanismo de cola con la configuración preconfigurada de administración de cargas de trabajo. Migration API procesa los trabajos de la mejor manera posible, sin contrato de nivel de servicio (SLA) ni rendimiento garantizado.
Optimización del rendimiento de la migración
Con el fin de garantizar un rendimiento óptimo para los proyectos de migración, es importante planear cuidadosamente, especialmente cuando se trata de migraciones a gran escala. Para obtener más información sobre cómo calcular intervalos de tiempo y optimizar el rendimiento, consulte nuestra guía de rendimiento.
Veo mensajes de limitación
Para garantizar una buena experiencia de usuario para todos los clientes de Microsoft 365, SharePoint usa la limitación para proteger la infraestructura de SharePoint. Evite limitarse siguiendo las instrucciones de limitación.
Artículos especiales
Migración de eventos de uso compartido de archivos y carpetas
Consulte el artículo Eventos de uso compartido para obtener instrucciones al migrar metadatos de eventos compartidos con archivos y carpetas.
Elementos web
Use el archivo DLL del serializador de elementos web de la Herramienta de migración de SharePoint (SPMT) para migrar elementos web a SharePoint. Consulte Migración de elementos web para obtener instrucciones.