Cuando ejecuta un lote de migración grande durante la noche para OneDrive for Business, el proceso puede ralentizarse o detenerse por completo por la mañana. Esto ocurre porque Microsoft 365 aplica limitación del lado del servicio para proteger la estabilidad del sistema cuando las solicitudes de migración superan ciertos umbrales. La limitación restringe el número de llamadas API que su herramienta de migración puede realizar por minuto, lo que provoca que el progreso se detenga. Este artículo explica por qué los lotes nocturnos se limitan y proporciona pasos específicos para reducir el impacto de la limitación y mantener su migración en movimiento.
Conclusiones clave: Reducir la limitación durante migraciones grandes de OneDrive
- Centro de administración de Microsoft 365 > Configuración > Configuración de la organización > Migración: Ajuste la política de limitación de migración para aumentar las solicitudes permitidas por minuto para su inquilino durante las ventanas nocturnas.
- Configuración de reintentos y retroceso de la herramienta de migración: Configure el retroceso exponencial en su herramienta (por ejemplo, ShareGate o Mover) para pausar y reintentar automáticamente cuando se reciban respuestas de limitación.
- Script de PowerShell con intervalos de suspensión: Agregue comandos Start-Sleep entre llamadas API para mantenerse dentro del límite de 150 solicitudes por minuto y evitar desencadenar la limitación.
Por qué los lotes de migración nocturnos se limitan
Microsoft 365 limita el tráfico de migración para evitar que un solo inquilino abrume los recursos compartidos del servicio. El límite de limitación predeterminado para las llamadas API de migración de OneDrive es de 150 solicitudes por minuto por aplicación. Cuando su lote supera esta tasa, el servicio devuelve errores HTTP 429 o retrasa las respuestas. Los lotes nocturnos son especialmente vulnerables porque muchas organizaciones programan migraciones grandes durante ventanas de bajo uso. Sin una sincronización cuidadosa, la ráfaga inicial de solicitudes desencadena inmediatamente la limitación, y la herramienta de migración puede no recuperarse hasta el día siguiente.
El mecanismo de limitación utiliza una ventana deslizante. Si envía 200 solicitudes en un minuto, el servicio registra el exceso y continúa aplicando límites durante los siguientes minutos. Este efecto en cascada puede detener un lote durante horas. Además, algunas herramientas de migración no manejan automáticamente las respuestas de limitación. Siguen reintentando a máxima velocidad, lo que empeora el problema. Comprender esta causa le ayuda a aplicar la solución correcta: reducir la tasa de solicitudes en lugar de aumentarla.
Pasos para solucionar la limitación en lotes de migración grandes de OneDrive
Estos pasos se aplican a cualquier herramienta de migración que utilice la API de SharePoint Online o OneDrive, incluidos scripts nativos de PowerShell, ShareGate, Mover y herramientas de terceros. Realice cada paso en el orden mostrado.
- Compruebe el estado actual de limitación en el Centro de administración de Microsoft 365
Inicie sesión en el Centro de administración de Microsoft 365 en admin.microsoft.com. Vaya a Configuración > Configuración de la organización > Migración. Busque la sección Limitación. Observe el límite predeterminado de 150 solicitudes por minuto. Si su inquilino tiene una solicitud de soporte de migración, es posible que vea un límite temporal más alto. No confíe en esto sin confirmación del Soporte de Microsoft. - Solicite un aumento de límite de migración al Soporte de Microsoft
Abra un ticket de soporte en el Centro de administración de Microsoft 365. Explique que está ejecutando un lote de migración grande de OneDrive durante la noche y necesita un aumento temporal de límite. Solicite un límite de 500 a 1000 solicitudes por minuto para un rango de fechas específico. Proporcione las horas de inicio y fin exactas para su ventana de lote. Microsoft generalmente otorga estos aumentos por 72 horas o menos. Espere la confirmación antes de continuar. - Configure su herramienta de migración para usar retroceso exponencial
En herramientas como ShareGate, abra la configuración de migración. Encuentre la sección Política de reintentos o Retroceso. Habilite Retroceso exponencial con una espera inicial de 5 segundos y una espera máxima de 60 segundos. Esto hace que la herramienta se pause y reintente cuando reciba un error de limitación 429. Para Mover, establezca el Retraso de reintento a 10 segundos y habilite Reintento consciente de limitación. Guarde la configuración. - Ajuste el tamaño del lote y el paralelismo en la herramienta de migración
Reduzca el número de elementos migrados simultáneamente. En ShareGate, establezca Operaciones concurrentes máximas a 10 en lugar del valor predeterminado de 50. En Mover, establezca Transferencias concurrentes máximas a 5. Para scripts de PowerShell, limite el número de trabajos paralelos a 5. Esto reduce directamente la tasa de solicitudes por minuto. - Agregue lógica de ritmo a scripts personalizados de PowerShell
Si usa un script personalizado, inserte un comando Start-Sleep después de cada llamada API. Use un retraso aleatorio entre 200 y 500 milisegundos para evitar ráfagas sincronizadas. Ejemplo:Start-Sleep -Milliseconds (Get-Random -Minimum 200 -Maximum 500). También agregue manejo de errores que capture respuestas 429 y espere 30 segundos antes de reintentar esa solicitud específica. - Ejecute un lote de prueba antes de la ventana nocturna completa
Inicie una pequeña prueba de 50 usuarios 24 horas antes del lote principal. Monitoree los Informes de migración en el Centro de administración. Verifique si hay errores 429 o retrasos. Si la prueba se completa sin limitación, proceda con el lote completo. Si ocurre limitación, reduzca aún más el paralelismo y repita la prueba. - Monitoree la migración en tiempo real
Durante el lote nocturno, abra el Panel de migración en el Centro de administración. Observe el gráfico de Solicitudes por minuto. Si se acerca a 150, pause el lote manualmente durante 10 minutos. Reanude después de que el gráfico baje de 100. Algunas herramientas admiten la pausa automática basada en los tiempos de respuesta de la API. Habilite esa función si está disponible.
Si la limitación persiste después de aplicar las soluciones
Incluso después de seguir los pasos anteriores, algunos lotes de migración aún experimentan limitación. Esta sección cubre patrones de falla adicionales y sus remedios específicos.
La herramienta de migración muestra errores 429 repetidos a pesar de la configuración de retroceso
Si su herramienta aún muestra errores 429, la configuración de retroceso puede no estar activa. Verifique que la política de reintentos se aplique al punto final de migración correcto. Algunas herramientas tienen configuraciones separadas para SharePoint y OneDrive. También confirme que la versión de la herramienta admita retroceso exponencial. Actualice a la última versión si es necesario. Como alternativa, reduzca las operaciones concurrentes máximas a 3 y vuelva a ejecutar el lote.
La limitación ocurre solo para tipos de archivo o tamaños específicos
OneDrive limita de manera diferente para archivos grandes de más de 250 MB. Si su lote incluye muchos archivos grandes, la herramienta de migración puede alcanzar un límite de limitación por archivo. Divida los archivos grandes en lotes separados o use la aplicación de sincronización de OneDrive para esos archivos en lugar de la API de migración. Para archivos de más de 15 GB, use la Herramienta de migración de SharePoint, que maneja archivos grandes de manera más eficiente.
La migración se detiene por completo a cierta hora cada noche
Este patrón indica una ventana de mantenimiento a nivel de inquilino. Microsoft 365 realiza mantenimiento periódico que puede bloquear las llamadas API de migración durante 15 a 30 minutos. Consulte el panel de Salud del servicio en el Centro de administración para ver si hay eventos de mantenimiento programados. Si hay mantenimiento programado, cambie su lote nocturno a una ventana diferente o divídalo en dos lotes más pequeños antes y después del período de mantenimiento.
Aumento de límite de solicitud vs. ritmo basado en herramientas: diferencias clave
| Elemento | Aumento de límite de solicitud de Microsoft | Ritmo basado en herramientas (retroceso y paralelismo) |
|---|---|---|
| Descripción | Un aumento temporal del límite de solicitudes API por minuto otorgado por el Soporte de Microsoft | Cambios de configuración en la herramienta de migración para ralentizar las solicitudes y manejar las respuestas de limitación automáticamente |
| Tiempo para implementar | 4 a 24 horas dependiendo del tiempo de respuesta del soporte | 15 minutos para la mayoría de las herramientas |
| Duración del efecto | Limitado al rango de fechas especificado, generalmente 72 horas | Permanente para la configuración de la herramienta |
| Riesgo de uso excesivo | Bajo si el aumento está dentro de las pautas de Microsoft | Ninguno porque la herramienta se mantiene por debajo del límite predeterminado |
| Mejor para | Lotes grandes únicos que superan los 1000 usuarios | Migraciones recurrentes o lotes más pequeños de menos de 500 usuarios |
Ahora puede ejecutar lotes de migración grandes de OneDrive durante la noche sin detenerse debido a la limitación. Comience solicitando un aumento temporal de límite al Soporte de Microsoft si su lote supera los 1000 usuarios. Luego configure su herramienta de migración con retroceso exponencial y paralelismo reducido. Para scripts personalizados de PowerShell, agregue intervalos de suspensión entre llamadas API. Un consejo avanzado: use el cmdlet Get-SPOMigrationJobProgress para monitorear el estado del trabajo y pausar automáticamente el lote cuando la tasa de solicitudes supere las 120 por minuto.