M365Con 2027 – conferencia online gratuita · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Microsoft Graph devuelve 429 Too Many Requests en scripts masivos: qué cambiar

Por ·

Tu script de Graph se ralentiza hasta casi detenerse o falla con 429 incluso con una solicitud cada diez segundos. Aprende por qué importan las propiedades costosas y las cuotas compartidas, y cómo retroceder, dividir las llamadas y usar lotes de forma segura.

Traducido automáticamente con IA a partir de la publicación original. Lee el original en inglés

Un script lee datos de usuario de Microsoft Graph, uno por uno, con un ritmo lento y cuidadoso. Aun así recibe 429 Too Many Requests. Un hilo de preguntas y respuestas de Microsoft de mayo de 2026 describe exactamente esto: una llamada para un usuario, una lista $select larga que incluye signInActivity, un $expand=manager y un cliente configurado para una solicitud cada diez segundos con una sola solicitud en curso.

Puntos clave

  • Una tasa fija de solicitudes no te protege. Los límites dependen del tipo de solicitud, de la aplicación y del inquilino. Learn fija GET signInActivity en 10 solicitudes por minuto.
  • Espera el número de segundos indicado en el encabezado Retry-After y vuelve a intentarlo. Learn indica que Graph sigue registrando el uso mientras estás limitado, así que los reintentos inmediatos empeoran la situación.
  • Sacar las propiedades costosas de las llamadas por usuario, paginar con un $top mayor y usar delta o notificaciones de cambios reducen el número de solicitudes.
  • En una llamada $batch, cada solicitud se evalúa por separado. El lote devuelve 200 mientras que las solicitudes individuales dentro de él fallan con 429, y no se reintentan automáticamente.

Un segundo hilo, de febrero de 2026, preguntaba cómo funciona la limitación cuando se leen en paralelo muchas unidades de SharePoint y OneDrive. Tomados en conjunto, los dos hilos muestran por qué un límite de tasa sencillo en el cliente no basta. Este artículo explica lo que documenta Microsoft Learn y lo que los hilos solo sugirieron. Es una guía de resolución de problemas, no un procedimiento oficial de Microsoft.

Lo que informaron los hilos

Hilo de mayo de 2026 (endpoint de usuarios). Quien preguntó recibió 429 en GET /v1.0/users/{id} con muchas propiedades, incluida signInActivity, más $expand=manager. La paginación y los filtros no ayudaron, porque cada llamada devolvía un solo usuario. Un moderador de Microsoft respondió que las propiedades costosas, y no solo la tasa de solicitudes, provocan la limitación. El moderador sugirió dividir las llamadas (perfil, actividad de inicio de sesión y responsable), respetar Retry-After con retroceso exponencial, usar caché y leer la actividad de inicio de sesión con menos frecuencia. Esa respuesta no se marcó como aceptada. Una respuesta generada por IA, que quien preguntó sí marcó como aceptada, decía algo muy similar. Quien preguntó no indicó si los 429 dejaron de aparecer.

Hilo de febrero de 2026 (driveItems). La persona que preguntaba quería saber si la limitación se aplica por sitio o por unidad, y qué nivel de concurrencia es seguro. Una respuesta anónima, aceptada por quien preguntaba, indicaba que los límites se aplican en capas (inquilino, aplicación y servicio), que las solicitudes a sitios distintos pueden consumir la misma cuota, y que conviene respetar Retry-After, usar $batch y preferir las consultas delta y las notificaciones de cambios frente al sondeo. No ofrecía ningún número de concurrencia. La persona que preguntaba dijo que le había servido.

Paso 1: Lee bien el error 429

Registra tres datos en cada fallo: la URL de la solicitud, el valor de Retry-After y la hora. La página de solución de problemas de Graph PowerShell de Learn sugiere ejecutar un cmdlet con -Debug para ver el método HTTP, el URI y el código de estado, e indica que, si abres un caso de soporte, anotes los encabezados de respuesta request-id y date.

El hilo de mayo de 2026 no citaba ningún valor de Retry-After. Sin él, nadie puede saber qué límite alcanzó el script.

Paso 2: Respeta Retry-After

La página de limitación de Learn es clara al respecto:

  1. Espera el número de segundos indicado en el encabezado Retry-After.
  2. Vuelve a intentar la solicitud.
  3. Si vuelve a fallar con 429, mantén el mismo retardo hasta que la solicitud se complete.

Learn explica el motivo: Microsoft Graph sigue registrando el uso de recursos mientras un cliente está limitado, así que esperar según el encabezado es la forma más rápida de recuperarse. Los reintentos inmediatos aumentan tu consumo. Si la respuesta no incluye el encabezado Retry-After, Learn recomienda usar retroceso exponencial.

Learn indica que los SDK de Microsoft Graph ya gestionan esto. No dice lo mismo de los cmdlets de Graph PowerShell, así que no lo des por supuesto. Si tu script envuelve llamadas directas, como Invoke-MgGraphRequest, implementa tú la espera.

Paso 3: Localiza las llamadas más costosas

La página de límites específicos por servicio de Learn tiene una sección para los informes de identidad y acceso. Enumera estas cifras, que pueden cambiar:

  • Cualquier solicitud de ese grupo: 122 solicitudes cada 10 segundos por aplicación en todos los inquilinos, y 5 solicitudes cada 10 segundos por aplicación y por inquilino.
  • GET signInActivity: 10 solicitudes por minuto.

Tu script, con una llamada cada diez segundos, hace 6 llamadas por minuto, lo que sobre el papel está por debajo de 10. El hilo no dice si otros trabajos del mismo registro de aplicación se ejecutaban al mismo tiempo. Esos trabajos compartirían el presupuesto, porque los límites se aplican por aplicación y por inquilino. Esta es una conclusión de la tabla de límites de Learn, no algo que afirme el hilo.

Learn también indica que $select=signInActivity en List users puede provocar una limitación más estricta que las llamadas estándar. Su recomendación es:

  • Usa $top=500, el tamaño de página máximo cuando seleccionas signInActivity, en lugar del valor predeterminado de 100.
  • Usa $filter sobre createdDateTime para consultar intervalos de tiempo más pequeños. Empieza con unos tres días de datos y reduce el intervalo si te limitan.
  • Según la página List users de Learn, la propiedad signInActivity requiere una licencia de Microsoft Entra ID P1 o P2 y el permiso AuditLog.Read.All.

Si necesitas la actividad de inicio de sesión de muchos usuarios, una llamada de lista como GET /v1.0/users?$select=displayName,userPrincipalName,signInActivity&$top=500 devuelve hasta 500 usuarios por solicitud. Eso supone muchas menos solicitudes que una llamada por usuario. La página List users de Learn documenta esta solicitud con signInActivity. No se indica si también es más ligera para el servicio, así que mídelo.

El moderador del hilo de mayo sugirió leer signInActivity a través del endpoint beta. La referencia actual de v1.0 de Learn documenta signInActivity, así que no deberías necesitar beta para ello. Comprueba la propiedad en el endpoint que utilizas.

Paso 4: Reduce el número de solicitudes

Las mejores prácticas de Learn van en la misma dirección:

  • Reduce el número de operaciones por solicitud y la frecuencia de las llamadas.
  • Evita el sondeo continuo y los análisis periódicos de colecciones grandes. Usa el seguimiento de cambios (consultas delta) y las notificaciones de cambios cuando estén disponibles.
  • Almacena en caché los datos que cambian poco, como las relaciones de responsable. Esto es un consejo del moderador del hilo de mayo, no una afirmación de Learn.

Paso 5: Usa $batch con cuidado

El envío por lotes puede reducir los viajes de ida y vuelta por la red. La página de envío por lotes en JSON de Learn establece un límite de 20 solicitudes individuales por lote. También indica:

  • Cada solicitud de un lote se evalúa de forma independiente frente a los límites de throttling. Si una de ellas los supera, esa solicitud falla con 429, pero el lote en sí devuelve 200. Varias solicitudes de un mismo lote pueden verse limitadas a la vez.
  • Reintenta cada solicitud fallida usando el valor de retry-after que aparece en el cuerpo de la respuesta de esa solicitud. Learn indica que podrías reintentarlas todas en un nuevo lote después del valor de retry-after más alto.
  • Si un SDK reintenta las solicitudes limitadas cuando no van en un lote, las solicitudes limitadas dentro de un lote no se reintentan automáticamente.

Por tanto, el procesamiento por lotes no elimina el límite. Lo que hace es trasladar la lógica de reintentos a tu código.

Paso 6: planifica las lecturas de SharePoint y OneDrive

En cuanto a los análisis de unidades, la página de Learn sobre throttling de SharePoint indica que SharePoint Online devuelve 429 o 503 con una cabecera Retry-After, y que las solicitudes limitadas cuentan para los límites. Describe el throttling a nivel de usuario, de inquilino y de aplicación, y sus únicos límites por sitio son los de los vínculos anónimos y el egreso anónimo. No planifiques en función de una cuota independiente por sitio. Otros puntos de esa página:

  • El tráfico sin ID de aplicación ni cadena User-Agent se considera sin identificar. Learn indica que el tráfico correctamente identificado tiene prioridad sobre el tráfico sin identificar. Los formatos de User-Agent documentados son ISV|CompanyName|AppName/Version y NONISV|CompanyName|AppName/Version.
  • Una consulta de un solo elemento consume 1 unidad de recurso, una consulta de varios elementos o una escritura consume 2, y las operaciones de permisos, incluido $expand=permissions, consumen 5. Evita expandir permisos en análisis masivos.
  • Learn recomienda usar Microsoft Graph en lugar de CSOM y REST siempre que sea posible, porque normalmente consume menos recursos.

El hilo de febrero también abordó el error 410 Gone en las consultas delta. La respuesta indicaba que significa que el token delta ya no se puede usar y que el cliente debe empezar de nuevo con una nueva consulta delta inicial. Tenlo en cuenta en cualquier sincronización incremental.

Verificar

  1. Registra el número de respuestas 429 y los valores de Retry-After de una ejecución, antes y después de tus cambios.
  2. Ejecuta el script por sí solo, sin otros trabajos que usen el mismo registro de aplicación, para ver el efecto de tus propias llamadas.
  3. Si la limitación continúa con un backoff correcto y menos llamadas, recopila las cabeceras request-id y date y abre un caso de soporte.

Límites

  • El hilo de mayo de 2026 no tiene un resultado confirmado, y la respuesta aceptada en él fue generada por IA. Para este artículo, la base es la guía de Learn citada arriba.
  • La pregunta sobre los usuarios sin un bloque signInActivity no obtuvo respuesta en el hilo, y Learn tampoco lo describe, así que trata la ausencia del bloque como un dato desconocido. Learn sí indica que lastSuccessfulSignInDateTime no se rellena retroactivamente antes del 1 de diciembre de 2023, por lo que un valor vacío no demuestra que el usuario nunca haya iniciado sesión.
  • Learn indica que los límites que publica pueden cambiar. Consulta la página actualizada antes de construir una solución basada en una cifra concreta.

Relacionado

Fuentes

Entidades en este artículo

Microsoft Graph Microsoft Graph PowerShell Throttling

Artículos relacionados

RSS