Microsoft Graph サービス固有の調整制限
Microsoft Graph では、Outlook や Azure Active Directory などの複数のサービスのデータにアクセスできます。 これらのサービスは、Microsoft Graph を使用してそれらにアクセスするアプリケーションに影響する独自に調整した制限を課します。
すべての要求は、制限の範囲 （すべてのテナントでのアプリ別、すべてのアプリのテナント別、テナントごとに１つのアプリなど）、要求の種類 (GET、POST、PATCH など)、また、その他の要因に応じて、複数の制限に対して評価できます。 最初に到達した上限に達すると、トリガーの調整が行われます。 セクションに記載されているサービス固有の制限に加えて、次のグローバル制限が適用されます:
| 要求の種類 | すべてのテナントのアプリごと |
|---|---|
| 任意 | 1 秒あたり 2000の要求数 |
注意
ここで説明する特定の制限は変更される場合があります。
このセクションの、テナント という語は、アプリケーションがインストールされている Microsoft 365 組織を示します。 このテナントは、1 つのテナント アプリケーションの場合、アプリケーションを作成した場合と同じにすることができますが、マルチ テナント アプリケーション の場合は異なるものにすることもできます。
次の制限は、割り当てサービス API の要求に適用されます。
| 要求の種類 | テナントごとのアプリ別の制限 | すべてのアプリのテナントごとの制限 |
|---|---|---|
| 任意 | 10 秒あたり 500 の要求数 | 10 秒あたり 1000 の要求数 |
| 任意 | 3600 秒あたり 15000 の要求数 | 3600 秒あたり 30000 の要求数 |
| 割り当てを取得する | 10 秒あたり 50 の要求数 | 10 秒あたり 150 の要求数 |
前述の制限は、次のリソースに適用されます:
| リソース | アプリあたりの制限 |
|---|---|
| 通話 | 10,000 回の通話/月および 100 回の同時通話 |
| 会議の情報 | 毎月 2,000 回の会議/ユーザー |
| プレゼンス | テナントごとのアプリ別に、30 秒間に 1500 の要求数 |
次の表に示す制限は、次のリソースに適用されます。
| 制限の種類 | 極限 |
|---|---|
| テナントごと | 20 秒あたり 10,000 要求 |
| テナントごとのアプリケーションごと | 20 秒あたり 1,500 要求 |
| 呼び出しレコードごと | 20 秒あたり 10 件の要求 (最初のページ) 5 分あたり 50 件の要求 (以降のページ) |
Excel サービスの調整に関連する説明とベスト プラクティスについては、「調整エラーを削減する」を参照してください。 さらに、いくつかの調整制限を次に示します。
| 要求の種類 | すべてのテナントに対するアプリごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| 任意 | 10 秒あたり 5000 の要求数 | 10 秒あたり 1500 の要求数 |
上記の制限は、次のリソースに適用されます。
| 要求の種類 | すべてのテナントに対するアプリごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| 任意 | 20 秒あたり 400000 の要求数 | 10 秒あたり 35000 の要求数 |
上記の制限は、次のリソースに適用されます。
OneDrive、OneDrive for Business、SharePoint Online のサービス制限については、「SharePoint Online で調整やブロックされないようにする」 を参照してください。
上記の情報は、次のリソースに適用されます：
| 要求の種類 | テナントごとのアプリ別の制限 |
|---|---|
| 任意 | 10 秒に 5 件の要求 |
上記の制限は、次のリソースに適用されます:
Azure AD レポート API は、テナントまたはアプリから特定の期間内に Azure AD が受け取る呼び出しが多すぎると調整されます。 サービスの応答に時間がかかりすぎる場合にも、呼び出しが調整されることがあります。 調整に対応するためのベスト プラクティスを適用しても 429 Too Many Requests エラー コードが示されて引き続き要求が失敗する場合は、返されるデータ量を減らしてみてください。 最初に次の方法を試してください。
- フィルターを使用して、クエリのターゲットを必要なデータのみに絞ります。 たとえば、特定の種類のイベントまたは一部のユーザーのみが必要な場合は、
$selectおよび$filterクエリ パラメーターを使用して他のイベントを除外することにより、応答オブジェクトのサイズを減らし、調整リスクを軽減します。 - 広範な Azure AD レポート データ セットが必要な場合は、createdDateTime で
$filterを使用して、1 回の呼び出しでクエリを実行するサインイン イベント量を制限します。 次に、必要なすべてのレコードが揃うまで、次の期間を反復処理します。 たとえば、調整されている場合、3 日間のデータを要求する呼び出しから始めて、要求が調整されなくなるまで短い期間で反復処理できます。
調整はトークン バケット アルゴリズムに基づいています。これは、要求の個々のコストを加算することで機能します。 要求コストの合計は、事前に定義された制限と比較されます。 制限を超えた要求のみが調整されます。 いずれかの制限を超えると、応答が 429 Too Many Requests 件になります。 サービスが重要な負荷がかかっている場合、または特定のテナントのデータ ボリュームに基づいている場合は、次の制限に達していなくても 429 Too Many Requests 件の応答を受信できます。 次の表に、既存の制限を示します。
| 制限の種類 | リソース単価のクォータ | 書き込みクォータ |
|---|---|---|
| アプリケーションとテナントのペア | S: 10 秒あたり 3,500 件のリクエスト M: 10 秒あたり 5,000 件のリクエスト L: 10 秒あたり 8,000 件のリクエスト |
2 分 30 秒あたり 3,000 件のリクエスト |
| アプリケーション | 20 秒あたり 150,000 件のリクエスト | 5 分あたり 70,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 |
3 | 0 |
| GET | domains/{id}/domainNameReferences |
4 | 0 |
| POST | getObjectsById |
3 | 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 減少 - Azure AD B2C テナントにユーザーを作成すると、コストが 4 増加する
注意
要求コストを 1 より少なくすることはできません。 me/ で始まる要求パスに適用される要求コストは、users/{id | userPrincipalName}/ で始まる同等の要求にも適用されます。
- x-ms-throttle-priority - ヘッダーが存在しないか、他の値に設定されている場合、それは通常の要求を示します。 ユーザーによって開始された要求に対してのみ、優先度を
highに設定することをお勧めします。 このヘッダーの値は次のとおりです。- 低 - 要求の優先度が低いことを示します。 この要求を調整しても、ユーザーに表示されるエラーは発生しません。
- 標準 - 値が指定されていない場合の既定値です。 要求が既定の優先度であることを示します。
- 高 - 要求の優先度が高いことを示します。 この要求を調整すると、ユーザーに表示されるエラーが発生します。
注意
要求が調整された場合、優先度の低い要求が最初に調整され、通常の優先度の要求が 2 番目に調整され、優先度の高い要求が最後に調整されます。 優先度の要求ヘッダーを使用しても、制限は変更されません。
- x-ms-resource-unit - この要求に使用されているリソース単位を示します。 値は正の整数です。
- x-ms-throttle-limit-percentage - アプリケーションが 0.8 の上限を超えた場合にのみ返されます。 値の範囲は、0.8 から 1.8、かつ上限の使用率です。 呼び出し元がこの値を使用して、アラートを設定し、操作を実行できます。
- 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 - 調整は、割り当てられたリソース単位を超えているためです。
| 要求の種類 | テナントごとの制限 |
|---|---|
exportPersonalData の投稿 |
任意のサブジェクトについて 1 日あたり 1000 件の要求、1 日あたりサブジェクトごとに 100 件 |
| その他の要求 | 1 時間あたり 10000 件の要求 |
前述の制限は、次のリソースに適用されます:
注意
先に挙げたリソースは、429 Too Many Requests 応答に Retry-After ヘッダーを返しません。
| 要求の種類 | すべてのアプリのテナントごとの制限 |
|---|---|
| 任意 | 1 秒あたりのリクエスト |
注意
先に挙げたリソースは、429 Too Many Requests 応答に Retry-After ヘッダーを返しません。
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| 任意 | 1 分あたり 300 の要求数 | 1 分あたり 200 の要求数 |
上記の制限は、次のリソースに適用されます:
次の制限は /informationProtection でのすべての要求に適用されます。
電子メールの場合、リソースは一意のネットワーク メッセージ ID と受信者のペアです。 たとえば、同じメッセージ ID を持つメールを同じユーザーに 15 分間に複数回送信すると、次の表に示すリソースごとの制限がトリガーされます。 ただし、15 分ごとに最大 150 件の一意のメールを送信できます (テナントの制限)。
| 操作 | テナントごとの制限 | リソースあたりの制限 (メール、URL、ファイル) |
|---|---|---|
| POST | 15 分に 150 件の要求、24 時間に 10000 件の要求 | 15 分に 1 件の要求、24 時間に 3 件の要求 |
次の制限はme/insightsまたはusers/{id}/insightsでのすべての要求に適用されます。
| 極限 | 適用対象 |
|---|---|
| 10 分間で 10,000 件の API リクエスト | v 1.0 およびベータ版エンドポイント |
| 4 つの同時リクエスト | v 1.0 およびベータ版エンドポイント |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 400 の要求数 | 20 秒あたり 200 の要求数 |
| 任意 | 20 秒あたり 4000 の要求数 | 20 秒あたり 2000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
次の制限は /invitations でのすべての要求に適用されます。
| 操作 | すべてのアプリのテナントごとの制限 |
|---|---|
| いずれかの操作 | 5 秒あたり 150 の要求数 |
次の制限は /reports でのすべての要求に適用されます。
| 操作 | テナントごとのアプリ別の制限 | すべてのアプリのテナントごとの制限 |
|---|---|---|
| 任意の要求 (CSV) | 10 分あたり 14 の要求数 | 10 分あたり 40 の要求数 |
| 任意の要求 (JSON、beta) | 10 分あたり 100 の要求数 | 該当なし |
上記の制限は、各レポート API に個別に適用されます。 たとえば、10 分間の中の Microsoft Teams ユーザー アクティビティ レポート API および Outlook ユーザー アクティビティ レポート API への要求は、各 API の 14 回の要求のうちの 2 回としてカウントされるのではなく、各 API の 14 回の要求のうちの 1 回としてカウントされます。
前述の制限は、すべての利用状況レポート リソースに適用 されます。
制限は 1 秒あたりの要求数 (RPS) で表されます。
| Teams 要求の種類 | テナントごとのアプリ別の制限 | すべてのテナントでのアプリごとの制限 |
|---|---|---|
| チームを取得する、チャネル、タブ、installedApps、appCatalogs | 30 RPS | 600 RPS |
| POST 操作/PUT 操作、チャネル、タブ、installedApps、appCatalogs | 30 RPS | 300 RPS |
| チームを修正する、チャネル、タブ、installedApps、appCatalogs | 30 RPS | 300 RPS |
| チャネルを削除する、タブ、installedApps、appCatalogs | 15 RPS | 150 RPS |
GET /チーム/{team-id}、joinedTeams |
30 RPS | 300 RPS |
| POST /teams | 10 RPS | 100 RPS |
PUT /groups/{team-id}/team, clone |
6 RPS | 150 RPS |
| チャネル メッセージを取得する | 20 RPS | 200 RPS |
| 1:1/グループのチャット メッセージを取得する | 20 RPS | 200 RPS |
| チャネル メッセージを投稿する | 50 RPS | 500 RPS |
| 1:1/グループのチャット メッセージを投稿する | 20 RPS | 200 RPS |
取得 /teams/{team-id}/スケジュール、およびこのパスの下にあるすべての API |
30 RPS | 600 RPS |
投稿、パッチ、PUT /teams/{team-id}/スケジュール、およびこのパスの下にあるすべての API |
30 RPS | 300 RPS |
削除/teams/{team-id}/スケジュール、およびこのパスの下にあるすべての API |
15 RPS | 150 RPS |
POST /teams/{team-id}/sendActivityNotification |
5 RPS | 50 RPS |
POST /chats/{chat-id}/sendActivityNotification |
5 RPS | 50 RPS |
POST /users/{user-id}/teamwork/sendActivityNotification |
5 RPS | 50 RPS |
GET /teams/{team-id}/members |
60 RPS | 1200 rps |
GET /teams/{team-id}/channels |
60 RPS | 1200 rps |
GET /teams/{team-id}/channels/{channel-id}/members |
60 RPS | 1200 rps |
| チームのすべてのチャネル メッセージを取得する GET teams/ {team-id}/channels/getAllMessagesget teams/ {team-id}/channels/allMessages |
200rps | 1000rps |
| ユーザーのすべてのチャット メッセージを取得する GET users/ {user-id}/chats/getAllMessagesGET users/ {user-id}/chats/allMessages |
200rps | 1000rps |
| Microsoft Teams のためのその他の GET API 呼び出し | 30 RPS | 1500 RPS |
| Microsoft Teams のためのその他の API 呼び出し | 30 RPS | 300 RPS |
指定されたチームまたはチャネルでは、1 つのアプリに対して 1 秒間に最大 4 つの要求を発行することができます。 1 日あたり最大 3,000 件のメッセージを特定のチャネルに送信できます ( 移行モードを使用する場合を除く)。
詳細については、「Microsoft Teams の制限」と「投票の要件」を参照してください。
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのアプリのテナントごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 200 の要求数 | 20 秒あたり 100 の要求数 |
| 任意 | 20 秒あたり 2000 の要求数 | 20 秒あたり 1000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 制限の種類 | ユーザー1人あたりのアプリごとの制限数 (委任されたコンテキスト) | アプリごとに制限 (アプリのみのコンテキスト) |
|---|---|---|
| 要求率 | 1分に120の要求と1時間あたり400の要求 | 1分に240の要求と1時間あたり800の要求 |
| 同時リクエスト | 5つ同時のリクエスト | 20同時のリクエスト |
上記の制限は、次のリソースに適用されます：
OneNote API の調整とその回避方法の成功事例に関する追加情報を見つけることができます。
注意
先に挙げたリソースは、429 Too Many Requests 応答に Retry-After ヘッダーを返しません。
| 要求の種類 | テナントごとのアプリ別の制限 |
|---|---|
| 任意 | 10 秒あたり 455 の要求数 |
上記の制限は、次のリソースに適用されます：
Outlookサービスの制限は、アプリ ID とメールボックスの組み合わせごとに判定されます。 つまり、説明されている制限は、特定のメールボックス (ユーザーまたはグループ) にアクセスする特定のアプリに適用されます。 アプリケーションが 1 つのメールボックス内で制限を超えても、別のメールボックスにアクセスする機能には影響しません。 このような制限は、パブリック クラウドだけでなく、国内クラウドの展開にも適用されます。
| 極限 | 適用対象 |
|---|---|
| 10 分間で 10,000 件の API リクエスト | v 1.0 およびベータ版エンドポイント |
| 4 つの同時リクエスト | v 1.0 およびベータ版エンドポイント |
| 30 秒間で 15 メガバイト (MB) のアップロード (PATCH、POST、PUT) | v 1.0 およびベータ版エンドポイント |
| API | リソース |
|---|---|
| 検索 API (プレビュー) | |
| プロファイル API | |
| カレンダー API | |
| メール API | |
| 個人用連絡先 API | |
| ソーシャルおよび職場のインテリジェンス | |
| To do タスク API (プレビュー) |
| 要求の種類 | すべてのアプリのテナントごとの制限 |
|---|---|
| 取得 | 5分に400件の要求と1日に12000件の要求 |
| 投稿、PUT、PATCH、削除 | 5分に100件の要求と1日に8000件の要求 |
上記の制限は、次のリソースに適用されます。
次の制限は /security でのすべての要求に適用されます。
| 操作 | テナントごとのアプリ別の制限 |
|---|---|
、 securityActionsに対する任意のalert操作secureScore |
1分に150件の要求 |
tiIndicatorでのいずれかの操作 |
1分に1000件の要求 |
secureScoreまたはsecureScorecontrolProfileでの、いずれかの操作 |
10 分間で 10,000 件の API の要求 |
secureScoreまたはsecureScorecontrolProfileでの、いずれかの操作 |
4 つ同時のリクエスト |
次の制限は /security/eDiscoveryCases でのすべての要求に適用されます。
| 操作 | テナントごとのアプリ別の制限 |
|---|---|
| 任意 | 1 分あたり 5 件の要求 |
以下の制限は、/admin/serviceAnnouncement/ に基づくサービス通信のあらゆる種類の要求に適用されます。
| 要求の種類 | テナントごとのアプリ別の制限 |
|---|---|
| 任意 | 60 秒あたり 240 の要求数 |
| 任意 | 1 時間あたり 800 の要求数 |
| 要求の種類 | すべてのテナントに対するアプリごとの制限 |
|---|---|
| 任意 | 10 秒あたり 5000 の要求数 |
上記の制限は、次のリソースに適用されます:
| 要求の種類 | すべてのテナントに対するアプリごとの制限 | テナントごとのアプリ別の制限 |
|---|---|---|
| POST、PUT、DELETE、PATCH | 20 秒あたり 2000 の要求数 | 20 秒あたり 500 要求 |
| ID によるサブスクリプションの取得 | 20 秒あたり 2000 の要求数 | 20 秒あたり 500 要求 |
| サブスクリプションの取得リスト | 20 秒あたり 40 の要求数 | 20 秒あたり 25 要求 |
上記の制限は、 サブスクリプション リソースに適用されます。
Planner のサービス制限は利用できません。
上記の情報は、次のリソースに適用されます：