Microsoft Graph では、すべての API 呼び出しに 2 カテゴリの調整制限が同時に課されます。
- すべてのサービスに適用されるグローバルな制限
- 個々のサービスに適用されるサービス固有の制限
すべての要求は、制限の範囲 (すべてのテナントでのアプリ別、すべてのアプリのテナント別、テナントごとに1つのアプリなど)、要求の種類 (GET、POST、PATCH など)、また、その他の要因に応じて、複数の制限に対して評価できます。 最初に到達した上限に達すると、トリガーの調整が行われます。
次の表は、グローバル制限を示しています。
| 要求の種類 | すべてのテナントのアプリごと |
|---|---|
| 任意 | 10 秒あたり 130,000 件の要求 |
この記事の残りの部分では、各 Microsoft Graph サービスのサービス固有の調整制限の概要を説明します。
注:
この記事で説明する特定の制限は変更される可能性があります。
このセクションの、テナント という語は、アプリケーションがインストールされている Microsoft 365 組織を示します。 シングルテナント アプリケーションの場合、このテナントはアプリケーションが作成された場所と同じにすることができます。マルチテナント アプリケーションの場合は、別のテナントにすることができます。
割り当てサービスの制限
| 要求の種類 | テナントごとのアプリ別の制限 | すべてのアプリのテナントごとの制限 |
|---|---|---|
| 任意 | 10 秒あたり 350 件の要求 | 10 秒あたり 700 件の要求 |
| 任意 | 3,600 秒あたり 10,000 件の要求 | 3,600 秒あたり 20,000 件の要求 |
| POST /publish | 10 秒あたり 25 の要求数 | 10 秒あたり 25 の要求数 |
前述の制限は、次のリソースに適用されます:
Bookings サービスの制限
Bookings サービスは、特に特定のアプリが特定の予約メールボックスにアクセスするときに、各アプリ ID とメールボックスの組み合わせに制限を適用します。 1 つのメールボックスの制限を超えても、アプリケーションが別のメールボックスにアクセスする機能には影響しません。
| 極限 | 適用対象 |
|---|---|
| 4 つの同時要求 | v 1.0 およびベータ版エンドポイント |
上記の制限は、次のリソースに適用されます:
クラウド コミュニケーションのサービスの制限
| リソース | アプリあたりの制限 |
|---|---|
| 通話 | 15 秒間に 50,000 件の要求 (テナントあたりのアプリケーションあたり) |
| 会議の情報 | 毎月 2,000 件の会議/ユーザー |
| プレゼンス | 30 秒間に 10,000 件の要求 (テナントあたりのアプリケーションあたり) |
| 仮想イベント | 30 秒間にすべてのテナントでアプリあたり 750 件の GET 要求、30 秒間にすべてのテナントでアプリあたり 15 件の Create、 Update、 Delete 要求。 |
通話記録の制限
次の表に示す制限は、次のリソースに適用されます。
| 制限の種類 | 極限 |
|---|---|
| すべてのテナントのアプリケーションごと | 20 秒あたり 15,000 件の要求 |
| すべてのアプリケーションのテナントごと | 20 秒あたり 10,000 件の要求 |
| テナントあたりのアプリケーションごと | 20 秒あたり 1,500 件の要求 |
| 通話記録ごと | 20 秒あたり 40 の要求数 |
| 通話レコードの一覧表示 | 20 秒あたり 40 の要求数 |
PSTN 通話記録の制限
次の表に示す制限は、次のリソースに適用されます。
| 制限の種類 | 極限 |
|---|---|
| テナントごと | 60 秒あたり 1,000 件の要求 |
| テナントあたりのアプリケーションごと | 60 秒あたり 200 件の要求 |
| コレクションごと | 60 秒あたり 50 件の要求 |
Excel サービスの制限
Excel サービスの調整に関連する説明とベスト プラクティスについては、「調整エラーを削減する」を参照してください。 さらに、いくつかの調整制限を次に示します。
| 要求の種類 | すべてのテナントに対するアプリごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| 任意 | 10 秒あたり 5000 の要求数 | 10 秒あたり 1500 の要求数 |
上記の制限は、次のリソースに適用されます。
教育サービスの制限
| 要求の種類 | すべてのテナントに対するアプリごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| 任意 | 20 秒あたり 400,000 件の要求 | 10 秒あたり 35,000 件の要求 |
上記の制限は、次のリソースに適用されます。
Exchange メッセージ追跡サービスの制限
| 制限の種類 | 極限 |
|---|---|
| テナントごと | 5 分あたり 100 件の要求 |
上記の制限は、次のリソースに適用されます。
ファイルとリストサービスの制限
OneDrive と SharePoint のサービス制限については、「 SharePoint でスロットルまたはブロックされないようにする」を参照してください。
上記の情報は、次のリソースに適用されます:
ID とアクセス レポート サービスの制限
| 要求の種類 | すべてのテナントに対するアプリごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| 任意 | 10 秒あたり 122 件の要求 | 10 秒あたり 5 件の要求 |
| GET signInActivity | 10 要求/分 | 10 要求/分 |
上記の制限は、次のリソースに適用されます。
ID レポートとアクセス レポートのベスト プラクティス
Microsoft Entra レポート API は、指定した期間中にテナントまたはアプリから受信した呼び出しが多すぎる場合Microsoft Entra ID調整されます。 サービスの応答に時間がかかりすぎると、呼び出しが調整される可能性もあります。
調整に対応するためのベスト プラクティスを適用しても 429 Too Many Requests エラー コードが示されて引き続き要求が失敗する場合は、返されるデータ量を減らしてみてください。 最初に次の方法を試してください。
- フィルターを使用して、クエリのターゲットを必要なデータのみに絞ります。 たとえば、特定の種類のイベントまたは一部のユーザーのみが必要な場合は、
$selectおよび$filterクエリ パラメーターを使用して他のイベントを除外することにより、応答オブジェクトのサイズを減らし、調整リスクを軽減します。 - 広範なMicrosoft Entra IDレポート データが必要な場合は、createdDateTime で
$filterを使用して、1 回の呼び出しでクエリを実行するサインイン イベントの数を制限します。 次に、必要なすべてのレコードが揃うまで、次の期間を反復処理します。 たとえば、調整されている場合は、3 日間のデータが要求される呼び出しから始めて、要求が調整されなくなるまで、より短い時間間隔で繰り返すことができます。 -
ユーザーの一覧表示操作の
$select=signInActivityパラメーターにより、標準の Microsoft Graph API 呼び出しよりも厳しい調整が発生する場合があります。 これらの制限を回避するには、必要な場合にのみこのパラメーターを使用します。 サインイン アクティビティ データが必要な場合は、$top=500を使用して、既定の 100 ユーザーではなく、1 ページあたり最大 500 ユーザーを取得します。 これにより、必要な API 呼び出しの総数が減ります。
ID とアクセス サービスの制限
パターン
調整はトークン バケット アルゴリズムに基づいています。これは、要求の個々のコストを加算することで機能します。 次に、要求コストの合計が、事前に決定された制限と比較されます。 制限を超える要求のみがスロットルされます。 いずれかの制限を超えた場合、応答は 429 Too Many Requestsされます。 サービスに重大な負荷がかかっている状況や、特定のテナントのデータ量に基づく状況では、次の制限に達していない場合でも、 429 Too Many Requests 応答を受け取ることができます。 次の表に、既存の制限を示します。
| 制限の種類 | リソース単価のクォータ | 書き込みクォータ |
|---|---|---|
| アプリケーションとテナントのペア | S: 10 秒あたり 3,500 ResourceUnits M: 10 秒あたり 5,000 ResourceUnits L: 10 秒あたり 8,000 ResourceUnits |
2 分 30 秒あたり 3,000 件のリクエスト |
| アプリケーション | 150,000 ResourceUnit/20 秒 | 5 分あたり 35,000 件の要求 |
| テナント | 該当なし | 5 分あたり 18,000 件のリクエスト |
注:
アプリケーションとテナントのペアの制限は、実行されるテナント要求のユーザー数に基づいて異なります。 テナント サイズは次のように定義されます。S - 50 ユーザー未満、M - 50 - 500 ユーザー、L - 500 ユーザー以上。
上記の制限は、次のリソースに適用されます。
次の表に、要求の基本コストを示します。 表示されない要求の基本コストは 1 です。
| 操作 | 要求のパス | 基準リソース単価のコスト | 書き込みコスト |
|---|---|---|---|
| GET | applications |
2 | 0 |
| GET | applications/{id}/extensionProperties |
2 | 0 |
| GET | contracts |
3 | 0 |
| POST | directoryObjects/getByIds |
5 | 0 |
| GET | domains/{id}/domainNameReferences |
4 | 0 |
| POST | getObjectsById |
5 | 0 |
| GET | groups/{id}/members |
3 | 0 |
| GET | groups/{id}/transitiveMembers |
5 | 0 |
| POST | isMemberOf |
4 | 0 |
| POST | me/checkMemberGroups |
4 | 0 |
| POST | me/checkMemberObjects |
4 | 0 |
| POST | me/getMemberGroups |
2 | 0 |
| POST | me/getMemberObjects |
2 | 0 |
| GET | me/licenseDetails |
2 | 0 |
| GET | me/memberOf |
2 | 0 |
| GET | me/ownedObjects |
2 | 0 |
| GET | me/transitiveMemberOf |
2 | 0 |
| GET | oauth2PermissionGrants |
2 | 0 |
| GET | oauth2PermissionGrants/{id} |
2 | 0 |
| GET | servicePrincipals/{id}/appRoleAssignments |
2 | 0 |
| GET | subscribedSkus |
3 | 0 |
| GET | users |
2 | 0 |
| GET | 表に記載されていない ID パス | 1 | 0 |
| POST | 表に記載されていない ID パス | 1 | 1 |
| PATCH | 表に記載されていない ID パス | 1 | 1 |
| PUT | 表に記載されていない ID パス | 1 | 1 |
| DELETE | 表に記載されていない ID パス | 1 | 1 |
重要
applications要求パスに対する POST、PATCH、DELETE 操作のコストは、signInAudience の型によって異なります。
signInAudience が AzureADMyOrg または AzureADMultipleOrgs であるアプリの場合、 コストは 5 分あたり 70,000 件のリクエストです。 signInAudience が AzureADandPersonalMicrosoftAccount または PersonalMicrosoftAccount であるアプリの場合、 コストは 1 分あたり 60 件のリクエストです。
要求コストに影響を与えるその他の要因:
-
$selectを使用すると、コストが 1 減少 -
$expandを使用すると、コストが 1 増加 - 20 未満の値で
$topを使用すると、コストが 1 減少 - Microsoft Entra ID B2C テナントにユーザーを作成すると、コストが 4 増加します
注:
- 要求コストを 1 より少なくすることはできません。
me/で始まる要求パスに適用される要求コストは、users/{id | userPrincipalName}/で始まる同等の要求にも適用されます。 -
directoryObjects/getByIdsとgetObjectsByIdに$selectを使用すると、2 ResourceUnits になります。
その他のヘッダー
要求ヘッダー
-
x-ms-throttle-priority - ヘッダーが存在しないか、他の値に設定されている場合、それは通常の要求を示します。 ユーザーによって開始された要求に対してのみ、優先度を
highに設定することをお勧めします。 このヘッダーには、次のいずれかの値を指定できます。- 低 - 要求の優先度が低いことを示します。 この要求を調整しても、ユーザーに表示されるエラーは発生しません。
- 標準 - 値が指定されていない場合の既定値です。 要求が既定の優先度であることを示します。
- 高 - 要求の優先度が高いことを示します。 この要求を調整すると、ユーザーに表示されるエラーが発生します。
注:
要求をスロットルする必要がある場合、低優先度の要求が最初に、通常の優先度の要求は 2 番目に、優先度の高い要求は最後にスロットルされます。 優先度要求ヘッダーを使用しても制限は変更されません。
定期的な応答要求
- x-ms-resource-unit - この要求に使用されているリソース単位を示します。 値は正の整数です。
-
x-ms-throttle-limit-percentage - アプリケーションが 0.8 の上限を超えた場合にのみ返されます。 値の範囲は、0.8 から 1.8、かつ上限の使用率です。 呼び出し元は、この値を使用してアラートを設定し、アクションを実行できます。
- 0.8 は、許可された制限の 80% を使用していることを示します。
- 1.0 は、許可された制限の 100% を使用していることを示します。 スロットリングが見え始めます。
- 1.2 は、受信要求の 20% が調整されていることを示します。
- 1.8 は、受信要求の 80% が調整されていることを示します。
調整された応答要求
-
x-ms-throttle-scope - たとえば、
Tenant_Application/ReadWrite/9a3d526c-b3c1-4479-ba74-197b5c5751ae/0785ef7c-2d7a-4542-b048-95bcab406e0b。 調整の範囲を次の形式<Scope>/<Limit>/<ApplicationId>/<TenantId|UserId|ResourceId>で示します:- 範囲: (文字列、必須)
- Tenant_Application - 現在のアプリケーションの特定のテナントのすべての要求。
- Tenant - アプリケーションに関係なく、現在のテナントのすべての要求。
- Application - 現在のアプリケーションのすべての要求。
- 制限: (文字列、必須)
- Read: 範囲に対する読み取り要求 (GET)
- Write: 範囲に対する書き込み要求 (POST、PATCH、PUT、DELETE...)
- ReadWrite: 範囲に対するすべての要求 (any)
- ApplicationId (Guid、必須)
- TenantId |UserId |ResourceId: (Guid、必須)
- 範囲: (文字列、必須)
-
x-ms-throttle-information - 調整の理由を示します。任意の値 (文字列) を使用できます。 この値は診断とトラブルシューティングのために用意されています。次に例を示します。
- CPULimitExceeded - 調整は、CPU 割り当ての制限を超えているためです。
- WriteLimitExceeded - 調整は、書き込みの制限を超えているためです。
- ResourceUnitLimitExceeded - 調整は、割り当てられたリソース単位を超えているためです。
ID およびアクセス データ ポリシー操作サービスの制限
| 要求の種類 | テナントごとの制限 |
|---|---|
exportPersonalData の投稿 |
任意のサブジェクトに対して 1 日あたり 1,000 件の要求、およびサブジェクトあたり 1 日あたり 100 件の要求 |
| その他の要求 | 1 時間あたり 10,000 件の要求 |
前述の制限は、次のリソースに適用されます:
注:
前に示したリソースは、429 Too Many Requests応答で Retry-After ヘッダーを返しません。
ID およびアクセス デバイス操作サービスの制限
| 要求の種類 | テナントごとのアプリ別の制限 | テナントあたりのユーザーごとの制限 |
|---|---|---|
| 投稿、パッチ適用、削除 | 2 分 30 秒あたり 3,000 件のリクエスト | 10 秒あたり 25 の要求数 |
上記の制限は、 デバイス リソースの書き込みクォータに適用されます。
ID 保護と条件付きアクセス サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 |
|---|---|
| 任意 | 1 秒あたり 1 つの要求 |
注:
前に示したリソースは、429 Too Many Requests応答で Retry-After ヘッダーを返しません。
ID プロバイダー サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| 任意 | 1 分あたり 300 の要求数 | 1 分あたり 200 の要求数 |
上記の制限は、次のリソースに適用されます:
業界データ ETL サービスの制限
業界データ サービスでは、オンデマンド 実行 を 12 時間ごとに最大 5 回の正常な開始に制限します。
Information Protection サービスの制限
次の制限は /informationProtection でのすべての要求に適用されます。
電子メールの場合、リソースは一意のネットワーク メッセージ ID と受信者のペアです。 たとえば、同じメッセージ ID を持つメールを同じユーザーに 15 分間に複数回送信すると、次の表に示すリソースごとの制限がトリガーされます。 ただし、15 分ごとに最大 150 件の一意のメールを送信できます (テナントの制限)。
| 操作 | テナントごとの制限 | リソースあたりの制限 (メール、URL、ファイル) |
|---|---|---|
| POST | 15 分あたり 150 件の要求、24 時間あたり 10,000 件の要求 | 15 分あたり 1 件の要求と 24 時間あたり 3 件の要求 |
インサイト サービスの制限
次の制限はme/insightsまたはusers/{id}/insightsでのすべての要求に適用されます。
| 極限 | 適用対象 |
|---|---|
| 10 分間に 10,000 件の API 要求 | v 1.0 およびベータ版エンドポイント |
| 4 つの同時要求 | v 1.0 およびベータ版エンドポイント |
上記の制限は、次のリソースに適用されます:
Intune サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
職場用 Intune Android サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune アプリケーション サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune 監査サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune ブック サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune バンドル サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune Chromebook 同期サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune 会社の使用条件サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune デバイス構成 V2 サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune デバイス構成サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune デバイス登録サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune デバイス目的サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune デバイス サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 400 の要求数 | 20 秒あたり 200 の要求数 |
| 任意 | 20 秒あたり 4000 の要求数 | 20 秒あたり 2000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune エンドポイント保護サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune 登録サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune GPAnalytics サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune 管理アプリケーション サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune 通知サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune ODJ サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune パートナー統合サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune RBAC サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune リモート アシスタンス サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune テレフォニー サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune TEM サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune トラブルシューティング サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune ロック解除サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune 更新プログラム サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
Intune WIP サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
招待マネージャー サービスの制限
次の制限は /invitations でのすべての要求に適用されます。
| 操作 | すべてのアプリのテナントごとの制限 |
|---|---|
| いずれかの操作 | 5 秒あたり 150 の要求数 |
Microsoft 365 レポートのサービス制限
次の制限は /reports でのすべての要求に適用されます。
| 操作 | テナントごとのアプリ別の制限 | すべてのアプリのテナントごとの制限 |
|---|---|---|
| 任意の要求 (CSV) | 10 分あたり 14 の要求数 | 10 分あたり 40 の要求数 |
| 任意の要求 (JSON、beta) | 10 分あたり 100 の要求数 | 該当なし |
上記の制限は、各レポート API に個別に適用されます。 たとえば、Microsoft Teams ユーザー アクティビティ レポート API への要求と Outlook ユーザー アクティビティ レポート API への 10 分以内の要求は、両方の 14 要求のうち 2 つではなく、API ごとに 14 件の要求のうち 1 件としてカウントされます。
前述の制限は、すべての利用状況レポート リソースに適用 されます。
Microsoft Teams サービスの制限
Microsoft Teams は、調整制限を 4 つの独立したディメンションに適用します。 要求が 適用される制限を超える と要求が調整されるため、常にシナリオが到達する最小制限を考慮して設計してください。
| Dimension | 重要事項 | 通常適用される場合 |
|---|---|---|
| アプリごと | 1 つのアプリ (クライアント ID) からのすべての要求がすべてのテナントで合計されました。 | 多くの顧客にサービスを提供するマルチテナント アプリ。 |
| テナントあたりのアプリごと | 単一テナント内の 1 つのアプリからの要求。 | 最も一般的に到達する制限。 |
| リソースごと | 1 つのチーム、チャネル、チャットに対する要求。 | 1 つの会話にトラフィックを集中させるアプリ。 |
| ユーザーごと | 1 人のユーザーに代わって行われた要求。 | 委任された (ユーザー) アクセス許可のシナリオ。 |
制限は、特に明記されていない限り、1 秒あたりの要求数 (rps) として表されます。
各制限は、短いバースト期間にわたって評価されます。 リストされている値の約 83% という持続的な制限も、より長い期間にわたって評価されるため、リストされているレートで継続的に実行されるワークロードも引き続きスロットルできます。 定常状態トラフィックのサイズを一覧表示されている制限より下にし、指数バックオフを使用します。
ダッシュ (-) は、そのディメンション専用の制限が定義されていないことを意味します。 要求は引き続き 既定の制限 と、同じ行内の他の制限の対象となります。
Teams
| 要求 | アプリごと | テナントあたりのアプリごと | リソースごと | ユーザーごと |
|---|---|---|---|---|
GET /teams/{team-id} |
1500 RPS | 30 RPS | チームごとに 4 rps | - |
GET /me/joinedTeams or /users/{user-id}/joinedTeams |
300 RPS | 30 RPS | - | - |
| POST /teams | 100 RPS | 10 RPS | - | - |
PUT /groups/{team-id}/team |
150 RPS | 6 RPS | - | - |
PATCH /teams/{team-id} |
300 RPS | 30 RPS | チームごとに 4 rps | - |
POST /teams/{team-id}/clone |
150 RPS | 6 RPS | - | - |
POST /teams/{team-id}/completeMigration |
100 RPS | 10 RPS | - | - |
チャネル
| 要求 | アプリごと | テナントあたりのアプリごと | リソースごと | ユーザーごと |
|---|---|---|---|---|
GET /teams/{team-id}/channels |
1200 rps | 60 RPS | チームごとに 4 rps | - |
GET /teams/{team-id}/channels/{channel-id} |
600 RPS | 30 RPS | 1 チャネルあたり 1 rps | - |
GET /teams/{team-id}/channels/{channel-id}/members |
1200 rps | 60 RPS | 1 チャネルあたり 1 rps | - |
POST /teams/{team-id}/channels |
100 RPS | 10 RPS | チームごとに 4 rps | - |
PATCH /teams/{team-id}/channels/{channel-id} |
300 RPS | 30 RPS | 1 チャネルあたり 1 rps | - |
DELETE /teams/{team-id}/channels/{channel-id} |
150 RPS | 15 RPS | 1 チャネルあたり 1 rps | - |
POST /teams/{team-id}/channels/{channel-id}/completeMigration |
100 RPS | 10 RPS | - | - |
チャネル メッセージ
| 要求 | アプリごと | テナントあたりのアプリごと | リソースごと | ユーザーごと |
|---|---|---|---|---|
GET /teams/{team-id}/channels/{channel-id}/messages |
200 RPS | 20 RPS | 1 チャネルあたり 1 rps | - |
POST /teams/{team-id}/channels/{channel-id}/messages |
500 RPS | 50 RPS | 1 チャネルあたり 1 rps | 1 rps |
POST /teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies |
500 RPS | 50 RPS | 1 チャネルあたり 1 rps | 1 rps |
上記の表の POST 制限は、通常のメッセージ送信と メッセージ インポートによって共有されます。 ユーザーごとの制限はインポートには適用されません。
チャット
| 要求 | アプリごと | テナントあたりのアプリごと | リソースごと | ユーザーごと |
|---|---|---|---|---|
GET /chats、/me/chats、または /users/{user-id}/chats |
200 RPS | 20 RPS | - | 1 rps |
GET /chats/{chat-id} |
2000 rps | 200 RPS | チャットごとに 1 rps | 5 RPS |
| POST /chats | 200 RPS | 20 RPS | - | - |
PATCH /chats/{chat-id} |
300 RPS | 30 RPS | チャットごとに 1 rps | - |
DELETE /chats/{chat-id} |
10 RPS | 1 rps | チャットごとに 1 rps | - |
POST /chats/{chat-id}/removeAllAccessForUser |
300 RPS | 30 RPS | チャットごとに 1 rps | 1 rps |
チャットのメッセージ
| 要求 | アプリごと | テナントあたりのアプリごと | リソースごと | ユーザーごと |
|---|---|---|---|---|
GET /chats/{chat-id}/messages |
200 RPS | 20 RPS | チャットごとに 1 rps | - |
POST /chats/{chat-id}/messages |
200 RPS | 20 RPS | チャットごとに 1 rps | 1 rps |
PATCH /chats/{chat-id}/messages/{message-id} |
300 RPS | 30 RPS | チャットごとに 1 rps | - |
POST /chats/{chat-id}/messages/{message-id}/softDelete または undoSoftDelete |
300 RPS | 30 RPS | チャットごとに 1 rps | - |
GET /chats/{chat-id}/messages/{message-id}/hostedContents |
500 RPS | 50 RPS | チャットごとに 1 rps | - |
GET /chats/{chat-id}/messages/{message-id}/hostedContents/{id}/$value |
600 RPS | 60 RPS | チャットごとに 1 rps | - |
メンバー
| 要求 | アプリごと | テナントあたりのアプリごと | リソースごと | ユーザーごと |
|---|---|---|---|---|
GET /teams/{team-id}/members |
1200 rps | 60 RPS | チームごとに 4 rps | - |
POST /teams/{team-id}/members |
300 RPS | 30 RPS | チームあたり 1 分あたり 4 件の要求 | - |
POST /teams/{team-id}/members/add |
100 RPS | 10 RPS | チームあたり 1 分あたり 4 件の要求 | - |
POST /chats/{chat-id}/members |
300 RPS | 30 RPS | チャットあたり 1 分あたり 4 件の要求 | - |
DELETE /chats/{chat-id}/members/{membership-id} |
300 RPS | 30 RPS | チャットあたり 1 分あたり 4 件の要求 | - |
アプリ、タブ、アクセス許可の付与
| 要求 | アプリごと | テナントあたりのアプリごと | リソースごと | ユーザーごと |
|---|---|---|---|---|
| GET installedApps for team, chat, or user | 1500 RPS | 30 RPS | チャットまたはチャネルごとに 1 rps | - |
| GET アクセス許可チームまたはチャットの許可 | 1500 RPS | 30 RPS | チャットまたはチャネルごとに 1 rps | - |
| POST installedApps for team, chat, or user | 300 RPS | 30 RPS | チャットまたはチャネルごとに 1 rps | - |
| 削除 インストール済みアプリ for team, chat, or user | 150 RPS | 15 RPS | チャットまたはチャネルごとに 1 rps | - |
| チャネルまたはチャットの GET タブ | 600 RPS | 30 RPS | チャットまたはチャネルごとに 1 rps | - |
| チャネルまたはチャットの [投稿] タブ | 300 RPS | 30 RPS | チャットまたはチャネルごとに 1 rps | - |
| [PATCH] タブ | 300 RPS | 30 RPS | チャットまたはチャネルごとに 1 rps | - |
| チャネルまたはチャットのタブを削除する | 150 RPS | 15 RPS | チャットまたはチャネルごとに 1 rps | - |
| GET /appCatalogs/teamsApps | 1500 RPS | 30 RPS | - | - |
| POST /appCatalogs/teamsApps | 300 RPS | 30 RPS | - | - |
DELETE /appCatalogs/teamsApps/{app-id} |
150 RPS | 15 RPS | - | - |
アクティビティ フィード通知
| 要求 | アプリごと | テナントあたりのアプリごと | リソースごと | ユーザーごと |
|---|---|---|---|---|
POST /teams/{team-id}/sendActivityNotification |
50 RPS | 5 RPS | チームごとに 4 rps | - |
POST /chats/{chat-id}/sendActivityNotification |
50 RPS | 5 RPS | チャットごとに 1 rps | - |
POST /users/{user-id}/teamwork/sendActivityNotification |
50 RPS | 5 RPS | - | - |
| POST /teamwork/sendActivityNotificationToRecipients | 20 RPS | 2 RPS | - | - |
一括メッセージの取得
これらの API は、エクスポートとコンプライアンスのシナリオ用に設計されており、独自の制限が高くなっています。
| 要求 | アプリごと | テナントあたりのアプリごと | リソースごと | ユーザーごと |
|---|---|---|---|---|
GET /teams/{team-id}/channels/getAllMessages or /channels/allMessages |
1000 rps | 200 RPS | - | - |
GET /users/{user-id}/chats/getAllMessages or /chats/allMessages |
1000 rps | 200 RPS | - | - |
GET /teams/{team-id}/channels/getAllRetainedMessages |
1000 rps | 200 RPS | - | - |
GET /users/{user-id}/chats/getAllRetainedMessages |
1000 rps | 200 RPS | - | - |
GET /copilot/users/{user-id}/interactionHistory/getAllEnterpriseInteractions |
1500 RPS | 30 RPS | - | - |
Shifts
| 要求 | アプリごと | テナントあたりのアプリごと | リソースごと | ユーザーごと |
|---|---|---|---|---|
GET /teams/{team-id}/schedule とこのパス下にあるすべての API |
600 RPS | 30 RPS | - | - |
POST /teams/{team-id}/schedule とこのパス下のすべての API |
300 RPS | 30 RPS | - | - |
PUT /teams/{team-id}/schedule とこのパス下のすべての API |
300 RPS | 30 RPS | - | - |
セクション
| 要求 | アプリごと | テナントあたりのアプリごと | リソースごと | ユーザーごと |
|---|---|---|---|---|
/users/{user-id}/teamwork/sections の下にあるすべてのセクション管理 API |
- | 5 RPS | - | - |
セクション、セクション アイテム、並べ替えアクション、デルタ クエリなど、すべてのセクション操作は 1 つの制限を共有します。
既定の制限
上記の表に記載されていない Microsoft Teams 要求は、これらの制限を使用します。
| 要求の種類 | アプリごと | テナントあたりのアプリごと | リソースごと | ユーザーごと |
|---|---|---|---|---|
| GET | 1500 RPS | 30 RPS | チャットまたはチャネルごとに 1 rps | 1 rps |
| POST、PUT、PATCH | 300 RPS | 30 RPS | チャットまたはチャネルごとに 1 rps | 1 rps |
| DELETE | 150 RPS | 15 RPS | チャットまたはチャネルごとに 1 rps | 1 rps |
関連リソース
詳細については、「Microsoft Teams の制限」と「投票の要件」を参照してください。
上記の制限は、次のリソースに適用されます:
マルチテナント管理サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
OneNote サービスの制限
| 制限の種類 | ユーザー1人あたりのアプリごとの制限数 (委任されたコンテキスト) | アプリごとに制限 (アプリのみのコンテキスト) |
|---|---|---|
| 要求率 | 1分に120の要求と1時間あたり400の要求 | 1分に240の要求と1時間あたり800の要求 |
| 同時リクエスト | 5 つの同時要求 | 20同時のリクエスト |
上記の制限は、次のリソースに適用されます:
OneNote API の調整とその回避方法の成功事例に関する追加情報を見つけることができます。
注:
前に示したリソースは、429 Too Many Requests応答で Retry-After ヘッダーを返しません。
オープンおよびスキーマ拡張 のサービス制限
| 要求の種類 | テナントごとのアプリ別の制限 |
|---|---|
| 任意 | 10 秒あたり 455 の要求数 |
上記の制限は、次のリソースに適用されます。
Outlook サービスの制限
Outlook のサービス制限は、パブリック クラウドと 国内クラウドの展開に適用されます。
メールボックスあたりの制限
Outlook サービスは、各アプリ ID とメールボックスの組み合わせ (つまり、特定のユーザーまたはグループのメールボックスにアクセスする特定のアプリ) に制限を適用します。 1 つのメールボックスの制限を超えても、アプリケーションが別のメールボックスにアクセスする機能には影響しません。
| 極限 | 適用対象 |
|---|---|
| 10 分間に 10,000 件の API 要求 | v 1.0 およびベータ版エンドポイント |
| 4 つの同時要求 | v 1.0 およびベータ版エンドポイント |
| 5 分間に 150 メガバイト (MB) のアップロード (PATCH、POST、PUT) | v 1.0 およびベータ版エンドポイント |
Outlook サービス リソース
| API | リソース |
|---|---|
| 検索 API (プレビュー) | |
| プロファイル API | |
| カレンダー API | |
| メール API | |
| メールボックスのインポートとエクスポートの API | |
| 個人用連絡先 API | |
| ソーシャルおよび職場のインテリジェンス | |
| To do タスク API (プレビュー) |
JSON バッチ処理の Outlook サービスの制限
アプリが Outlook サービスに対して複数の順序付けられていない個々の要求で構成される JSON バッチ要求を行うと、既定では、Microsoft Graph は、それらの要求のターゲット メールボックスに関係なく、バッチから一度に最大 4 つの個別の要求を Outlook サービスに送信します。 Outlook サービスは、ターゲット メールボックスに関係なく、いつでもこれらの要求を並列で実行できます。 Microsoft Graph は並列実行要求を最大 4 つまでしか送信しないので、どのアプリを使用しているかに関係なく、そのバッチの実行は 同じメールボックスに対する Outlook の同時実行制限内にとどまります。
また、 dependsOn プロパティを使用して、バッチ内の要求を並べ替えることもできます。 Microsoft Graph は指定された順序に従って、バッチから一度に 1 つの要求を Outlook サービスに送信し、Outlook はバッチ内の個々の要求を順番に実行します。
つまり、 同じメールボックスをターゲットにする場合、複数のバッチ要求を並列実行できるアプリでは、次のいずれかの方法を使用できます。
- 個々の要求に順序を付ける必要がない場合は、1 つのバッチからの個々の要求を同時に実行します。
-
dependsOnプロパティを使用して、要求をバッチで順序付けし、最大 4 つのそのようなバッチ要求を同時に実行します。
Places のサービス制限
次の Places API には、1 秒あたり 3 回の呼び出しの調整制限があります。
Project Rome サービスの制限
| 要求の種類 | すべてのアプリのテナントごとの制限 |
|---|---|
| 取得 | 5 分あたり 400 件の要求、1 日あたり 12,000 件の要求 |
| 投稿、PUT、PATCH、削除 | 5 分あたり 100 件の要求、1 日あたり 8,000 件の要求 |
上記の制限は、次のリソースに適用されます。
セキュリティの検出とインシデントのサービスの制限
次の制限は /security でのすべての要求に適用されます。
| 操作 | テナントごとのアプリ別の制限 |
|---|---|
alert、securityActions、secureScore |
1分に150件の要求 |
tiIndicatorでのいずれかの操作 |
1,000 件の要求/分 |
secureScoreまたはsecureScorecontrolProfileでの、いずれかの操作 |
10 分間に 10,000 件の API 要求 |
secureScoreまたはsecureScorecontrolProfileでの、いずれかの操作 |
4 つの同時要求 |
セキュリティ電子情報開示サービスの制限
次の制限は /security/eDiscoveryCases でのすべての要求に適用されます。
| 操作 | テナントごとのアプリ別の制限 |
|---|---|
| 任意 | 毎分 5 つの要求 |
サービス通信のサービスの制限
以下の制限は、/admin/serviceAnnouncement/ に基づくサービス通信のあらゆる種類の要求に適用されます。
| 要求の種類 | テナントごとのアプリ別の制限 |
|---|---|
| 任意 | 60 秒あたり 240 の要求数 |
| 任意 | 1 時間あたり 800 の要求数 |
サブスクリプション サービス
| 要求の種類 | すべてのテナントに対するアプリごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 2000 の要求数 | 20 秒あたり 500 件の要求 |
| POST /reauthorize subscription by ID | 20 秒あたり 4000 の要求数 | 20 秒あたり 1000 の要求数 |
| ID によるサブスクリプションの取得 | 20 秒あたり 2000 の要求数 | 20 秒あたり 500 件の要求 |
| サブスクリプションの取得リスト | 20 秒あたり 40 の要求数 | 20 秒あたり 25 件の要求 |
上記の制限は、 サブスクリプション リソースに適用されます。
タスクと計画のサービスの制限
Planner のサービス制限は利用できません。
上記の情報は、次のリソースに適用されます:
Viva Engage のサービス制限
Viva Engage API 呼び出しにはレート制限があり、30 秒以内にアプリごとにユーザーごとに 10 個の要求が許可されます。 レート制限を超えると、後続のすべての要求は 429 Too Many Requests 応答コードを返します。
Windows 365 のサービス制限
| 要求の種類 | すべてのアプリまたはユーザーについてテナントごとの制限 | テナントあたりのアプリまたはユーザーごとの制限 |
|---|---|---|
| クラウド PC の一覧表示 | 60 秒あたり 180 件の要求 | 60 秒あたり 162 件の要求 |
| クラウド PC の取得 | 60 秒あたり 540 件の要求 | 60 秒あたり 486 件の要求 |
2025 年 9 月 30 日以降、1 人のユーザーまたはアプリがテナント内のすべてのクォータを消費するのを防ぐために、アプリごと/ユーザーごとのテナントごとの調整制限がテナントあたりの合計制限の半分に減少します。
| 要求の種類 | すべてのアプリまたはユーザーについてテナントごとの制限 | テナントあたりのアプリまたはユーザーごとの制限 |
|---|---|---|
| クラウド PC の一覧表示 | 60 秒あたり 180 件の要求 | 60 秒あたり 90 件の要求 |
| クラウド PC の取得 | 60 秒あたり 540 件の要求 | 60 秒あたり 270 件の要求 |