M365Con 2027 – 無料オンラインカンファレンス · 11–22 Jan 2027 · 120 sessions→ m365con.net

ブログ · Mirko Peters

一括処理のスクリプトでMicrosoft Graphが429 Too Many Requestsを返す場合の対処法

By ·

Graphスクリプトの処理が極端に遅くなったり、10秒に1回のリクエストでも429で失敗したりすることがあります。高コストなプロパティや共有クォータが影響する理由と、バックオフ、呼び出しの分割、バッチ処理を安全に行う方法を解説します。

Automatically translated with AI from the original post. Read the English original

スクリプトがMicrosoft Graphからユーザーデータを1人ずつ、低速で慎重なペースで読み取っているにもかかわらず、429 Too Many Requestsが返される。2026年5月のMicrosoft Q&Aスレッドでは、まさにこの状況が報告されています。1ユーザーに対する呼び出しで、signInActivityを含む長い$selectリストと$expand=managerを指定し、クライアントは10秒に1回、同時に1件だけの要求を送信していたというものです。

重要なポイント

  • 要求レートを一定に保つだけでは保護になりません。制限は要求の種類、アプリ、テナントによって異なります。Learnでは、GET signInActivityが1分あたり10要求とされています。
  • Retry-Afterヘッダーに示された秒数だけ待ってから再試行してください。Learnによると、スロットリング中もGraphは利用状況の記録を続けるため、すぐに再試行すると状況が悪化します。
  • ユーザーごとの呼び出しから重いプロパティを切り離し、$top を大きくしてページングし、delta クエリや変更通知を使うことで、要求数を減らせます。
  • $batch 呼び出しでは、各要求が個別に判定されます。バッチ全体は 200 を返しても、その中の個々の要求が 429 で失敗することがあり、それらは自動的に再試行されません。

2026年2月の別のスレッドでは、多数のSharePointとOneDriveのドライブを並列に読み取る場合のスロットリングの仕組みが質問されていました。この2つのスレッドを合わせて見ると、クライアント側の単純なレート制限だけでは不十分であることがわかります。この記事では、Microsoft Learnに文書化されている内容と、スレッドで示唆されたにすぎない内容を区別して説明します。これはトラブルシューティングのガイドであり、Microsoftの公式な手順ではありません。

スレッドで報告された内容

2026年5月のスレッド(usersエンドポイント)。質問者は、signInActivityを含む多数のプロパティと$expand=managerを指定してGET /v1.0/users/{id}を呼び出した際に429を受け取りました。各呼び出しは1ユーザーのみを返すため、ページングやフィルターは効果がありませんでした。Microsoftのモデレーターは、要求レートだけでなく高コストなプロパティがスロットリングの原因になっていると回答しました。そのうえで、呼び出しの分割(プロファイル、サインインアクティビティ、マネージャー)、指数バックオフによるRetry-Afterの順守、キャッシュの利用、サインインアクティビティの読み取り頻度を下げることを提案しています。この回答は承認済みとしてマークされませんでした。一方、質問者が承認済みとしたAI生成の回答も、ほぼ同様の内容でした。質問者は429が止まったかどうかは報告していません。

2026年2月のスレッド(driveItems)。 質問者は、スロットリングがサイト単位かドライブ単位か、また安全な同時実行数はどのくらいかを知りたいと考えていました。匿名の回答が寄せられ、質問者も受け入れていました。その回答では、制限はテナント、アプリ、サービスの各レベルで重なって適用されること、異なるサイトへのリクエストが同じクォータを消費しうることが説明されていました。また、Retry-After を尊重し、$batch を使い、ポーリングよりもデルタクエリと変更通知を優先するよう勧めていました。同時実行数の具体的な数値は示されていませんでした。質問者は、この回答が役に立ったと述べています。

ステップ1:429を正しく読む

失敗のたびに、次の3つを記録してください。リクエストのURL、Retry-After の値、そして発生時刻です。Learnの Graph PowerShell のトラブルシューティングのページでは、-Debug を付けてコマンドレットを実行し、HTTPメソッド、URI、ステータスコードを確認することを勧めています。サポートチケットを起票する場合は、応答ヘッダーの request-id と date も記録するよう説明されています。

2026年5月のスレッドでは、Retry-After の値が示されていませんでした。この値がなければ、スクリプトがどの制限に達したのかは特定できません。

ステップ2:Retry-After を尊重する

Learnのスロットリングのページでは、この点が明確に示されています。

  1. Retry-After ヘッダーで示された秒数だけ待機してください。
  2. 要求を再試行します。
  3. 再び429で失敗した場合は、成功するまで同じ遅延時間を使い続けてください。

Learnはその理由も説明しています。スロットリングを受けている間も、Microsoft Graphはクライアントのリソース使用量を記録し続けます。そのため、ヘッダーに従って待機するのが最も早く回復する方法です。すぐに再試行すると、使用量がさらに加算されます。応答に Retry-After ヘッダーがない場合、Learnは指数バックオフを推奨しています。

Learnによれば、Microsoft Graph SDKはこの処理をすでに行っています。一方で、Graph PowerShell のコマンドレットについては同じことは述べられていないため、同様だと決めつけないでください。Invoke-MgGraphRequest などで生のAPI呼び出しをラップしている場合は、待機処理を自分で組み込んでください。

ステップ3:負荷の高い呼び出しを見つける

Learnのサービス固有の制限のページには、ID とアクセスのレポートに関するセクションがあります。そこには次の数値が記載されています。これらの数値は変更される可能性があります。

  • このグループのすべてのリクエスト:アプリごとに、すべてのテナントを合わせて10秒あたり122リクエスト、テナントごとに10秒あたり5リクエストです。
  • GET signInActivity:1分あたり10リクエストです。

10秒に1回実行するスクリプトは1分あたり6回の呼び出しになり、表面上は10未満に収まります。ただし、スレッドでは、同じアプリ登録から同時に実行された他のジョブがあったかどうかは述べられていません。制限はアプリごと、テナントごとに適用されるため、そうしたジョブがあれば同じ枠を共有することになります。これはLearnの制限の表から導いた結論であり、スレッドに書かれていた内容ではありません。

Learnはまた、List users で $select=signInActivity を指定すると、通常の呼び出しよりも厳しいスロットリングが発生することがあると述べています。推奨事項は次のとおりです。

  • signInActivity を選択する場合は、既定の100ではなく、最大ページサイズである $top=500 を使用してください。
  • createdDateTime に対する $filter を使い、対象期間を小さく区切って問い合わせてください。まずは約3日分のデータから始め、スロットリングを受けたら期間をさらに絞ってください。
  • Learnの List users のページによれば、signInActivity プロパティには Microsoft Entra ID P1 または P2 のライセンスと AuditLog.Read.All アクセス許可が必要です。

多数のユーザーのサインインアクティビティが必要な場合は、GET /v1.0/users?$select=displayName,userPrincipalName,signInActivity&$top=500 のようなリスト呼び出しを使うと、1回のリクエストで最大500ユーザーを取得できます。ユーザーごとに1回呼び出すよりも、リクエスト数をかなり減らせます。Learnの List users のページには、signInActivity を含むこのリクエストが記載されています。サービス側の負荷も軽くなるかどうかは述べられていないため、実際に測定してください。

5月のスレッドのモデレーターは、signInActivity をベータエンドポイント経由で読み取るよう提案していました。しかし、Learnの現行の v1.0 リファレンスには signInActivity が記載されているため、このために ベータ版を使う必要はないはずです。使用するエンドポイントで、そのプロパティが利用できるかどうかを確認してください。

ステップ4:リクエスト数を減らす

Learnのベストプラクティスも同じ方向を示しています。

  • 1つのリクエストあたりの操作数と、呼び出しの頻度を減らしてください。
  • 継続的なポーリングや、大きなコレクションの定期的なスキャンは避けてください。変更の追跡(デルタクエリ)と、利用可能な場合は変更通知を使用してください。
  • マネージャーの関係など、頻繁には変わらないデータはキャッシュしてください。これは5月のスレッドのモデレーターによる助言であり、Learnの記述ではありません。

ステップ5:$batch は慎重に使う

バッチ処理はネットワークの往復回数を減らせます。Learnの JSON バッチ処理のページでは、1つのバッチあたり個別リクエスト20件という上限が定められています。また、次のようにも述べられています。

  • バッチ内の各要求は、それぞれ個別にスロットリングの上限と照合されます。上限を超えた要求は 429 で失敗しますが、バッチ自体は 200 を返します。1 つのバッチで複数の要求がスロットリングされることもあります。
  • 失敗した各要求は、その要求のレスポンス本文にある retry-after の値を使って再試行してください。Learn では、最も長い retry-after の値を待ってから、すべてを新しいバッチで再送してもよいとされています。
  • SDK がバッチに含まれていない要求でスロットリングされた要求を自動的に再試行する場合でも、バッチ内でスロットリングされた要求は自動的には再試行されません。

つまり、バッチ処理によって上限がなくなるわけではありません。再試行のロジックがコード側に移るだけです。

手順 6: SharePoint と OneDrive の読み取りを計画する

ドライブのスキャンについて、Learn の SharePoint スロットリングのページには、SharePoint Online が Retry-After ヘッダーとともに 429 または 503 を返すこと、そしてスロットリングされた要求も上限にカウントされることが書かれています。スロットリングは、ユーザー、テナント、アプリケーションの各単位で行われるとされています。サイトごとの制限があるのは匿名リンクと匿名の送信トラフィックのみです。サイトごとに別のクォータがあるものとして計画しないでください。このページの他のポイントは次のとおりです。

  • アプリ ID も User-Agent 文字列もないトラフィックは「装飾されていない」トラフィックです。Learn によると、適切に装飾されたトラフィックは、装飾されていないトラフィックより優先されます。文書化されている User-Agent の形式は ISV|CompanyName|AppName/Version と NONISV|CompanyName|AppName/Version です。
  • 単一項目のクエリは 1 リソース ユニット、複数項目のクエリまたは書き込みは 2 リソース ユニット、$expand=permissions を含むアクセス許可の操作は 5 リソース ユニットを消費します。一括スキャンでは、アクセス許可の展開を避けてください。
  • Learn では、可能な場合は CSOM や REST より Microsoft Graph を推奨しています。通常、使用するリソースが少なくて済むためです。

2 月のスレッドでは、デルタ クエリの 410 Gone にも触れられていました。そこでの回答によると、これはデルタ トークンがもう使用できないことを意味し、クライアントは新しい初期デルタ クエリから始め直す必要があるとのことです。増分同期では、この状況を想定して設計してください。

検証

  1. 1 回の実行について、変更の前後で 429 応答の数と Retry-After の値を記録してください。
  2. 同じアプリ登録を使う他のジョブを動かさずに、スクリプトを単独で実行し、自分の呼び出しによる影響を確認してください。
  3. 正しいバックオフを行い、呼び出しを減らしてもスロットリングが続く場合は、request-id と date ヘッダーを収集して、サポート ケースを作成してください。

制限

  • 2026 年 5 月のスレッドには確定した結果がなく、そこで承認された回答は AI が生成したものでした。ここでは上記の Learn のガイダンスを根拠としています。
  • signInActivity ブロックがないユーザーについての質問者の質問には、スレッドで回答がつきませんでした。Learn でもこの点は説明されていないため、ブロックがないことは不明として扱ってください。一方で、Learn では lastSuccessfulSignInDateTime は 2023 年 12 月 1 日より前の分はさかのぼって設定されないとされています。そのため、値が空であっても、そのユーザーが一度もサインインしていないとは言えません。
  • Learn に掲載されている制限値は変更される可能性があるとされています。数値を前提に構築する前に、最新のページを確認してください。

関連リンク

データソース

Entities in this article

Microsoft Graph Microsoft Graph PowerShell Throttling

Related articles

RSS