M365Con 2027 – conférence en ligne gratuite · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Microsoft Graph renvoie 429 Too Many Requests dans les scripts en masse : que modifier

Par ·

Votre script Graph ralentit fortement ou échoue avec une erreur 429, même à raison d’une requête toutes les dix secondes. Découvrez pourquoi les propriétés coûteuses et les quotas partagés comptent, et comment temporiser, fractionner les appels et regrouper les requêtes en toute sécurité.

Traduit automatiquement par IA à partir de l'article original. Lire l'original en anglais

Un script lit les données utilisateur dans Microsoft Graph, un utilisateur à la fois, à un rythme lent et prudent. Il reçoit tout de même 429 Too Many Requests. Un fil Q&A Microsoft de mai 2026 décrit exactement ce cas : un appel pour un seul utilisateur, une longue liste $select incluant signInActivity, un $expand=manager, et un client configuré pour une requête toutes les dix secondes, avec une seule requête en cours.

Points clés

  • Un débit de requêtes fixe ne vous protège pas. Les limites dépendent du type de requête, de l’application et du locataire. Learn indique que GET signInActivity est plafonné à 10 requêtes par minute.
  • Attendez le nombre de secondes indiqué dans l’en-tête Retry-After, puis réessayez. Learn précise que Graph continue de comptabiliser l’utilisation pendant que vous êtes limité : des tentatives immédiates aggravent donc la situation.
  • Sortir les propriétés coûteuses des appels par utilisateur, paginer avec un $top plus élevé et utiliser delta ou les notifications de changement réduisent le nombre de requêtes.
  • Dans un appel $batch, chaque requête est évaluée individuellement. Le lot renvoie 200 alors que certaines requêtes qu’il contient échouent avec 429, et ces requêtes ne sont pas réessayées automatiquement.

Un second fil, de février 2026, demandait comment fonctionne la limitation lorsque de nombreux lecteurs SharePoint et OneDrive sont lus en parallèle. Pris ensemble, ces deux fils montrent qu’une simple limite de débit côté client ne suffit pas. Cet article explique ce que Microsoft Learn documente et ce que les fils ne faisaient que suggérer. Il s’agit d’un guide de dépannage, et non d’une procédure officielle de Microsoft.

Ce que rapportent les fils

Fil de mai 2026 (point de terminaison users). L’auteur de la question a reçu un 429 sur GET /v1.0/users/{id} avec de nombreuses propriétés, dont signInActivity, ainsi qu’un $expand=manager. La pagination et les filtres n’ont pas aidé, car chaque appel renvoyait un seul utilisateur. Un modérateur Microsoft a répondu que ce sont les propriétés coûteuses, et pas seulement le débit des requêtes, qui déclenchent la limitation. Il a suggéré de fractionner les appels (profil, activité de connexion, responsable), de respecter Retry-After avec un backoff exponentiel, de mettre en cache et de lire l’activité de connexion moins souvent. Cette réponse n’a pas été marquée comme acceptée. Une réponse générée par une IA, que l’auteur de la question a marquée comme acceptée, disait à peu près la même chose. L’auteur n’a pas indiqué si les erreurs 429 ont cessé.

Fil de février 2026 (driveItems). La personne qui posait la question voulait savoir si la limitation s’applique par site ou par lecteur, et quel niveau de concurrence reste sûr. Une réponse anonyme, acceptée par l’auteur de la question, indiquait que les limites sont superposées à l’échelle du locataire, de l’application et du service, que les requêtes adressées à différents sites peuvent puiser dans le même quota, et qu’il faut respecter Retry-After, utiliser $batch et privilégier les requêtes delta ainsi que les notifications de changement plutôt que l’interrogation répétée. Elle ne donnait aucun chiffre de concurrence. L’auteur de la question a indiqué que cela avait été utile.

Étape 1 : lire correctement l’erreur 429

Consignez trois éléments à chaque échec : l’URL de la requête, la valeur de Retry-After et l’heure. La page de dépannage de Graph PowerShell sur Learn suggère d’exécuter une cmdlet avec -Debug pour voir la méthode HTTP, l’URI et le code d’état, et indique de noter les en-têtes de réponse request-id et date si vous ouvrez un ticket de support.

Le fil de mai 2026 ne citait aucune valeur de Retry-After. Sans elle, personne ne peut dire quelle limite le script a atteinte.

Étape 2 : respecter Retry-After

La page Learn sur la limitation est claire sur ce point :

  1. Attendez le nombre de secondes indiqué dans l’en-tête Retry-After.
  2. Renvoyez la requête.
  3. Si la requête échoue de nouveau avec une erreur 429, conservez le même délai jusqu’à ce qu’elle aboutisse.

Learn explique pourquoi : Microsoft Graph continue de journaliser l’utilisation des ressources pendant qu’un client est limité, et temporiser selon l’en-tête est donc le moyen le plus rapide de rétablir la situation. Les nouvelles tentatives immédiates augmentent votre consommation. Si la réponse ne contient pas d’en-tête Retry-After, Learn recommande un backoff exponentiel.

Learn indique que les SDK Microsoft Graph gèrent déjà ce mécanisme. Il ne dit pas la même chose pour les cmdlets Graph PowerShell, donc ne le supposez pas. Si votre script encapsule des appels bruts, comme Invoke-MgGraphRequest, implémentez vous-même l’attente.

Étape 3 : identifier les appels coûteux

La page Learn des limites propres à chaque service comporte une section consacrée aux rapports d’identité et d’accès. Elle répertorie les valeurs suivantes, susceptibles d’évoluer :

  • Toute requête de ce groupe : 122 requêtes par tranche de 10 secondes et par application, tous locataires confondus, et 5 requêtes par tranche de 10 secondes et par application et par locataire.
  • GET signInActivity : 10 requêtes par minute.

Votre script qui effectue un appel toutes les dix secondes génère 6 appels par minute, soit en théorie moins de 10. Le fil ne précise pas si d’autres tâches issues du même enregistrement d’application s’exécutaient en même temps. Ces tâches partageraient le budget, puisque les limites s’appliquent par application et par locataire. Il s’agit d’une conclusion tirée du tableau des limites de Learn, et non d’une information donnée dans le fil.

Learn indique également que $select=signInActivity dans une requête List users peut entraîner une limitation plus stricte que les appels standard. Son conseil :

  • Utilisez $top=500, la taille maximale de page lorsque vous sélectionnez signInActivity, au lieu de la valeur par défaut de 100.
  • Utilisez $filter sur createdDateTime pour interroger des plages de temps plus courtes. Commencez par environ trois jours de données et réduisez la plage si vous êtes limité.
  • La propriété signInActivity nécessite une licence Microsoft Entra ID P1 ou P2 et l’autorisation AuditLog.Read.All, selon la page List users de Learn.

Si vous avez besoin de l’activité de connexion de nombreux utilisateurs, un appel de liste tel que GET /v1.0/users?$select=displayName,userPrincipalName,signInActivity&$top=500 renvoie jusqu’à 500 utilisateurs par requête. Cela représente nettement moins de requêtes qu’un appel par utilisateur. La page List users de Learn documente cette requête avec signInActivity. Learn ne précise pas si elle est également moins lourde côté service, il faut donc la mesurer.

Le modérateur du fil de mai a suggéré de lire signInActivity via le point de terminaison bêta. La référence v1.0 actuelle de Learn documente signInActivity, vous ne devriez donc pas avoir besoin de la version bêta pour cela. Vérifiez la propriété sur le point de terminaison que vous utilisez.

Étape 4 : réduire le nombre de requêtes

Les bonnes pratiques de Learn vont dans le même sens :

  • Réduisez le nombre d’opérations par requête et la fréquence des appels.
  • Évitez l’interrogation continue et les analyses régulières de grandes collections. Utilisez le suivi des modifications (requêtes delta) et les notifications de changement lorsqu’elles existent.
  • Mettez en cache les données qui changent peu souvent, comme les relations hiérarchiques entre responsables. Il s’agit d’un conseil du modérateur du fil de mai, et non d’une recommandation de Learn.

Étape 5 : utiliser $batch avec discernement

Le regroupement de requêtes peut réduire les allers-retours réseau. La page Learn sur le traitement par lots JSON fixe une limite de 20 requêtes individuelles par lot. Elle précise également :

  • Chaque requête d’un lot est évaluée individuellement au regard des limites de limitation. Si l’une d’elles les dépasse, cette requête échoue avec 429, alors que le lot lui-même renvoie 200. Plusieurs requêtes d’un même lot peuvent être limitées.
  • Relancez chaque requête en échec en utilisant la valeur retry-after figurant dans le corps de la réponse pour cette requête. Learn indique que vous pouvez les relancer toutes dans un nouveau lot, après la plus longue valeur retry-after.
  • Si un SDK relance les requêtes limitées lorsqu’elles ne sont pas regroupées en lot, les requêtes limitées à l’intérieur d’un lot ne sont pas relancées automatiquement.

Le regroupement en lot ne supprime donc pas la limite. Il déplace la logique de nouvelle tentative dans votre code.

Étape 6 : planifier les lectures SharePoint et OneDrive

Pour les analyses de lecteurs, la page de Learn consacrée à la limitation de SharePoint indique que SharePoint Online renvoie 429 ou 503 avec un en-tête Retry-After, et que les requêtes limitées comptent dans les quotas. Elle décrit la limitation aux niveaux utilisateur, locataire et application, et ses seules limites par site concernent les liens anonymes et le trafic sortant anonyme. Ne basez donc pas votre planification sur un quota distinct par site. Autres points de cette page :

  • Le trafic sans identifiant d’application ni chaîne User-Agent est considéré comme non qualifié. Learn indique que le trafic correctement qualifié est traité en priorité par rapport au trafic non qualifié. Les formats User-Agent documentés sont ISV|CompanyName|AppName/Version et NONISV|CompanyName|AppName/Version.
  • Une requête portant sur un seul élément coûte 1 unité de ressource, une requête portant sur plusieurs éléments ou une écriture coûte 2, et les opérations sur les autorisations, y compris $expand=permissions, coûtent 5. Évitez l’expansion des autorisations dans les analyses en masse.
  • Learn recommande d’utiliser Microsoft Graph plutôt que CSOM et REST lorsque c’est possible, car il consomme généralement moins de ressources.

Le fil de février abordait aussi le code 410 Gone pour les requêtes delta. La réponse indiquait qu’il signifie que le jeton delta ne peut plus être utilisé et que le client doit recommencer avec une nouvelle requête delta initiale. Prévoyez ce cas dans toute synchronisation incrémentielle.

Vérifier

  1. Consignez le nombre de réponses 429 et les valeurs Retry-After pour une exécution, avant et après vos modifications.
  2. Exécutez le script seul, sans autre tâche utilisant la même inscription d’application, afin de mesurer l’effet de vos propres appels.
  3. Si la limitation persiste malgré un backoff correct et un nombre d’appels réduit, collectez les en-têtes request-id et date, puis ouvrez un dossier de support.

Limites

  • Le fil de mai 2026 n’a pas abouti à un résultat confirmé, et la réponse retenue dans ce fil a été générée par IA. Les recommandations de Learn citées ci-dessus constituent donc la référence utilisée ici.
  • La question de l’auteur concernant les utilisateurs sans bloc signInActivity n’a jamais reçu de réponse dans le fil. Learn ne la décrit pas non plus : considérez donc un bloc absent comme une inconnue. Learn précise en revanche que lastSuccessfulSignInDateTime n’est pas renseigné rétroactivement avant le 1er décembre 2023, si bien qu’une valeur vide ne prouve pas que l’utilisateur ne s’est jamais connecté.
  • Learn indique que les limites qu’il publie sont susceptibles d’évoluer. Consultez la page en ligne avant de construire quoi que ce soit sur un chiffre.

Articles associés

Sources

Entités dans cet article

Microsoft Graph Microsoft Graph PowerShell Throttling

Articles associés

RSS