Microsoft Graph 特定于服务的节流限制

  • 项目

Microsoft Graph 允许访问多个服务中的数据，例如 Outlook 或 Microsoft Entra ID。 这些服务实施自己的限制，这些限制会影响使用 Microsoft Graph 访问它们的应用程序。

任何请求均可根据多个限制进行评估，具体取决于限制范围（所有租户中的每个应用、所有应用的每个租户、每个租户的每个应用等）、请求类型（GET、 POST、PATCH等）以及其他因素。 即将达到的第一个限制会触发阻止行为。 除了本节中描述的服务特定限制之外，还适用以下全局限制：

请求类型 所有租户中的每个应用
任何 每 10 秒 130,000 个请求

注意

此处所述的具体限制可能会发生更改。

在此部分中，术语 租户 是指安装应用程序的 Microsoft 365 组织。 对于单个租户应用程序，此租户可以与创建应用程序的租户相同，而对于 多租户应用程序，则可以不同。

作业服务限制

下列的限制适用于关于作业服务 API 的请求:

请求类型 每个租户每个应用限制 所有应用的每个租户的使用限制
任何 每 10 秒 500 个请求 每 10 秒 1,000 个请求
任何 每 3,600 秒 15,000 个请求 每 3,600 秒 30,000 个请求
获取/作业 每 10 秒 50 个请求 每 10 秒 150 个请求

上述限制适用于下列资源：

Bookings服务限制

Bookings服务对每个应用 ID 和邮箱组合应用限制，尤其是在特定应用访问特定预订邮箱时。 超过一个邮箱的限制不会影响应用程序访问另一个邮箱的能力。

限制 适用对象
四个并发请求 v1.0 和 beta 终结点

上述限制适用于下列资源:

云通信服务限制

资源 每个应用的限制
通话 15 秒内每个租户每个应用程序 50,000 个请求
会议信息 每月 2,000 个会议/用户
状态 在 30 秒的时间段内，每个租户每个应用程序 1,500 个请求
虚拟事件 每月 10,000 个请求/应用

通话记录限制

下表中列出的限制适用于以下资源：

限制类型 限制
所有租户的每个应用程序 每 20 秒 15,000 个请求
所有应用程序的每个租户 每 20 秒 10,000 个请求
每个租户的每个应用程序 每 20 秒 1,500 个请求
每个通话记录 每 20 秒 10 个请求 (第一页)
每 5 分钟 50 个请求 (后续页面)

Excel 服务限制

有关 Excel 服务限制的说明和最佳实践，请参阅 减少限制错误。 此外，还存在以下限制。

请求类型 所有租户的每个应用限制 每个租户每个应用限制
任何 每 10 秒 5000 个请求 每 10 秒 1500 个请求

上述限制适用于下列资源:

教育版服务限制

请求类型 所有租户的每个应用限制 每个租户每个应用限制
任何 每 20 秒 400000 个请求 每 10 秒 35000 个请求

上述限制适用于下列资源：

文件和列表服务限制

有关 OneDrive、OneDrive for Business 和 SharePoint Online 的服务限制，请参阅 避免在 SharePoint Online 中受到限制或阻止。

上述信息适用于以下资源：

身份和访问报告服务限制

请求类型 每个租户每个应用限制
任何 每 10 秒 5 个请求

上述限制适用于下列资源:

标识和访问报告最佳做法

Microsoft Entra当Microsoft Entra ID在给定时间范围内收到来自租户或应用的过多调用时，报告 API 会受到限制。 如果服务响应时间过长，调用也可能受到限制。 如果尽管应用了 处理限制的最佳做法，但请求仍然失败并出现 429 Too Many Requests 错误代码，请尝试减少返回的数据量。 首先尝试以下方法:

  • 使用筛选器将查询定位到所需数据。 例如，如果只需要特定类型的事件或部分用户，请使用 $filter 和 $select 查询参数筛选出其他事件，从而减小响应对象的大小并减少限制风险。
  • 如果需要一组广泛的Microsoft Entra ID报告数据，请在 $filtercreatedDateTime 上使用 来限制在单个调用中查询的登录事件数。 然后，循环访问下一个时间跨度，直到获得所需的所有记录。 例如，如果受到限制，则可以从调用开始，该调用请求三天的数据，并循环访问较短的时间跨度，直到请求不再受到限制。

身份和访问服务限制

模式

限制基于令牌存储桶算法，后者通过添加各个请求的成本来实现。 然后，将请求成本的总和与预先确定的限制进行比较。 仅限制超过限制的请求。 如果超出任何限制，则响应为 429 Too Many Requests。 即使未达到以下限制，在服务处于重要负载或基于特定租户的数据量的情况下，也可以接收 429 Too Many Requests 响应。 下表列出了现有限制。

限制类型 资源单元配额 写入配额
应用 + 租户对 S：每 10 秒 3,500 个 ResourceUnits
M：每 10 秒 5,000 个 ResourceUnit
L：每 10 秒 8,000 个 ResourceUnit		 每 2 分钟 30 秒 3,000 个请求
应用程序 每 20 秒 150,000 个 ResourceUnits 每 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 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 表中未列出的任何身份路径 1 0
POST 表中未列出的任何身份路径 1 1
PATCH 表中未列出的任何身份路径 1 1
PUT 表中未列出的任何身份路径 1 1
DELETE 表中未列出的任何身份路径 1 1

重要

请求路径上的 POST、PATCH 和 DELETE applications 操作的成本取决于 signInAudience 类型。 对于AzureADMyOrg或AzureADMultipleOrgssignInAudience的应用，每 5 分钟 70,000 个请求；而对于signInAudience为AzureADandPersonalMicrosoftAccount或PersonalMicrosoftAccount的应用，成本为每分钟 60 个请求。

影响请求费用的其他因素：

  • 使用 $select 可将成本降低 1
  • 使用 $expand 可将成本增加 1
  • 使用值小于 20 的 $top 会使成本降低1
  • 在 Microsoft Entra ID B2C 租户中创建用户会增加 4 个成本

注意

请求费用不能低于 1。 适用于从 me/ 开始的请求路径的任何请求费用也适用于以 users/{id | userPrincipalName}/开头的等效请求。

附加标题

请求标头

  • x-ms-throttle-priority - 如果标头不存在或设置为任何其他值，则表示正常请求。 我们建议将优先级 high 用户启动的请求设置优先级。 此标头可以具有以下值之一：
    • 低 - 指示请求的优先级较低。 限制此请求不会导致出现用户可见的故障。
    • 正常 - 如果未提供任何值，则为默认值。 表示请求是默认优先级。
    • 高 - 表示请求具有高优先级。 限制此请求会导致出现用户可见的故障。

注意

如果限制请求，将首先限制低优先级请求，其次限制普通优先级请求，最后限制高优先级请求。 使用优先级请求标头不会更改限制。

正常响应请求

  • 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 - 当前应用程序对特定租户的所有请求。
      • 租户 - 当前租户的所有请求，与应用程序无关。
      • 应用程序 - 当前应用程序的所有请求。
    • 限制： (字符串，必需)
      • 读取：读取范围请求 (GET)
      • 写入：写入范围请求 (POST、PATCH、PUT、DELETE...)
      • ReadWrite：所有范围请求（任何）
    • ApplicationId （Guid、必填）
    • TenantId|UserId|ResourceId: (Guid、必填）
  • x-ms-throttle-information - 指示限制的原因，可以有任何值（字符串）。 提供该值是为了进行诊断和故障排除，其中一些示例包括：
    • CPULimitExceeded - 限制因为超过 cpu 应用的限值。
    • WriteLimitExceeded - 限制因为超过写入限值。
    • ResourceUnitLimitExceeded - 限制因为超过已分配资源单位的限值。

身份和访问数据策略操作服务限制

请求类型 每个租户的使用限制
发布于 exportPersonalData 任何主题每天 1,000 个请求，每个主题每天 100 个请求
任何其他请求 每小时 10,000 个请求

上述限制适用于下列资源：

注意

此前列出的资源未在 429 Too Many Requests 响应上返回 Retry-After 标头。

身份保护和条件访问服务限制

请求类型 所有应用的每个租户的使用限制
任何 每秒一个请求

注意

此前列出的资源未在 429 Too Many Requests 响应上返回 Retry-After 标头。

身份提供程序的服务限制

请求类型 所有应用的每个租户的使用限制 每个租户每个应用限制
任何 每 1 分钟 300 个请求 每 1 分钟 200 个请求

上述限制适用于下列资源:

信息保护服务限制

以下限制适用于 /informationProtection 上的所有请求。

对于电子邮件，资源是唯一的网络消息 ID/收件人对。 例如，在 15 分钟的时间段内多次提交具有相同邮件 ID 的电子邮件会触发下表中列出的每个资源限制限制。 但是，每 15 分钟最多可以提交 150 封唯一电子邮件（租户限制）。

操作 每个租户的使用限制 每个资源（电子邮件、URL、文件）的使用限制
POST 每 15 分钟 150 个请求，每 24 小时 10,000 个请求 每 15 分钟一个请求，每 24 小时 3 个请求

见解服务限制

以下限制适用于 me/insights或users/{id}/insights 上的所有请求。

限制 适用对象
10 分钟内 10,000 个 API 请求 v1.0 和 beta 终结点
四个并发请求 v1.0 和 beta 终结点

上述限制适用于下列资源:

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。 例如，在 10 分钟内对 Microsoft Teams 用户活动报告 API 的请求和对 Outlook 用户活动报告 API 的请求将计为每个 API 的 14 个请求中的一个请求，而不是 14 个请求中的两个请求。

上述限制适用于所有 使用情况报表 资源。

Microsoft Teams 服务限制

限制表示为每秒请求数 (rps)。

Teams 请求类型 每个租户每个应用限制 所有租户中的每个应用限制
GET 团队 30 rps 600 rps
GET 通道 30 rps 600 rps
频道、聊天的 GET 选项卡 30 rps 600 rps
GET installedApps for chat， user， team 30 rps 600 rps
GET appCatalogs 30 rps 600 rps
POST 通道 30 rps 300 rps
频道或聊天的 POST 选项卡 30 rps 300 rps
POST installed适用于聊天、用户、团队的Apps 30 rps 300 rps
POST appCatalogs 30 rps 300 rps
PATCH 团队、 频道、 选项卡 30 rps 300 rps
DELETE 通道 15 rps 150 rps
聊天、频道“删除”选项卡 15 rps 150 rps
DELETE installedApps for chat， user， team 15 rps 150 rps
DELETE appCatalogs 15 rps 150 rps
GET /teams/{team-id}， joinedTeams 30 rps 300 rps
POST /teams 10 rps 100 rps
PUT /groups/{team-id}/team 六个 rps 150 rps
POST /{team-id}/ clone 六个 rps 150 rps
GET 通道消息 20 rps 200 rps
GET 1：1/群组聊天消息 20 rps 200 rps
POST 通道消息 50 rps 500 rps
POST 1：1/群组聊天消息 20 rps 200 rps
GET /teams/{team-id}/schedule 以及此路径下的所有 API 30 rps 600 rps
POST /teams/{team-id}/schedule 以及此路径下的所有 API 30 rps 300 rps
PUT /teams/{team-id}/schedule 以及此路径下的所有 API 30 rps 300 rps
POST /teams/{team-id}/sendActivityNotification 五个 rps 50 rps
POST /chats/{chat-id}/sendActivityNotification 五个 rps 50 rps
POST /users/{user-id}/teamwork/sendActivityNotification 五个 rps 50 rps
POST /teamwork/sendActivityNotificationToRecipients 两个 rps 20 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/getAllMessages
GET teams/{team-id}/channels/allMessages		 200rps 1000rps
获取用户的所有聊天消息
GET users/{user-id}/chats/getAllMessages
GET users/{user-id}/chats/allMessages		 200rps 1000rps
Microsoft Teams 的其他 GET API 调用 30 rps 1500 rps
Microsoft Teams 的其他 API 调用 30 rps 300 rps

在给定的团队或频道上，每个应用每秒最多可以发出四个请求。

在给定的聊天或频道中执行 POST 消息时，每个用户每秒最多可以发出一个请求 (此限制不适用于 迁移) 。

另请参阅 Microsoft Teams 限制和投票要求。

上述限制适用于下列资源:

多租户管理服务限制

请求类型 所有应用的每个租户的使用限制 每个租户每个应用限制
POST, PUT, DELETE, PATCH 每 20 秒 200 个请求 每 20 秒 100 个请求
任何 每 20 秒 2000 个请求 每 20 秒 1000 个请求

上述限制适用于下列资源:

OneNote 服务限制

限制类型 每个用户的每个应用程序的限制（委派的上下文） 每个应用程序的限制（仅应用程序上下文）
请求率 每 1 分钟 120 个请求和每 1 小时 400 个请求 每 1 分钟 240 个请求和每 1 小时 800 个请求
并发请求 五个并发请求 20 个并发请求

上述限制适用于下列资源:

可在 OneNote API 限制及避免方法 中找到有关最佳做法的附加信息。

注意

此前列出的资源未在 429 Too Many Requests 响应上返回 Retry-After 标头。

开放和架构扩展服务限制

请求类型 每个租户每个应用限制
任何 每 10 秒 455 个请求

上述限制适用于下列资源:

Outlook 服务限制

Outlook 服务限制适用于公有云 和国家云部署。

每个应用 ID 和邮箱组合的限制

Outlook 服务对每个应用 ID 和邮箱组合（即访问特定用户或组邮箱的特定应用）应用限制。 超过一个邮箱的限制不会影响应用程序访问另一个邮箱的能力。

限制 适用对象
10 分钟内的 10,000 个 API 请求 v1.0 和 beta 终结点
四个并发请求 v1.0 和 beta 终结点
150 MB (MB) 在 5 分钟内上传 (PATCH、POST、PUT) v1.0 和 beta 终结点

Outlook 服务资源

API 资源
搜索 API（预览版）
  • 外部项（Microsoft 搜索）
    		•
    配置文件 API
  • 照片
    		•
    日历 API
  • 事件
  • eventMessage
  • calendar
  • calendarGroup
  • outlookCategory
  • attachment
  • place（预览）
    		•
    邮件 API
  • 邮件
  • mailFolder
  • mailSearchFolder
  • messageRule
  • outlookCategory
  • attachment
    		•
    个人联系人 API
  • contact
  • contactFolder
  • outlookCategory
    		•
    社交和工作场所智能
  • person
    		•
    待办事项任务 API（预览版）
  • outlookTask
  • outlookTaskFolder
  • outlookTaskGroup
  • outlookCategory
  • attachment
    		•

    用于 JSON 批处理的 Outlook 服务限制

    当应用发出包含对 Outlook 服务的多个无序单个请求的 JSON 批处理请求时，默认情况下，Microsoft Graph 一次向 Outlook 服务发送最多四个单独的批处理请求，而不管这些请求的目标邮箱如何。 Outlook 服务可以随时并行执行这些请求，也无论目标邮箱如何。 由于 Microsoft Graph 最多只发送四个并行运行的请求，所以该批的执行将保持在 Outlook 针对同一邮箱的并发限制范围内。

    或者，应用可以使用 dependsOn 属性对批中的请求进行排序。 Microsoft Graph 按照指定的顺序一次向 Outlook 服务发送一个来自批处理的请求，Outlook 将按顺序执行批处理中的每个单个请求。

    换句话说，当面向 同一邮箱时，允许并行运行多个批处理请求的应用可以使用以下方法之一：

    • 如果不必对单个请求进行排序，请同时运行来自单个批处理的单个请求。
    • dependsOn使用 属性对批处理中的请求进行排序，并让最多四个此类批处理请求同时运行。

    Project Rome 服务限制

    请求类型 所有应用的每个用户的限制
    GET 每 5 分钟 400 个请求，每天 12,000 个请求
    POST, PUT, PATCH, DELETE 每 5 分钟 100 个请求，每天 8,000 个请求

    上述限制适用于下列资源:

    安全检测和事件服务限制

    以下限制适用于 /security 上的所有请求。

    操作 每个租户每个应用限制
    对 alert、、 securityActions的任何操作 secureScore 每分钟 150 个请求
    tiIndicator 上的任何操作 每分钟 1,000 个请求
    secureScore 或 secureScorecontrolProfile 上的任何操作 10 分钟内 10,000 个 API 请求
    secureScore 或 secureScorecontrolProfile 上的任何操作 四个并发请求

    安全电子数据展示服务限制

    以下限制适用于 /security/eDiscoveryCases 上的所有请求。

    操作 每个租户每个应用限制
    任何 每分钟五个请求

    服务通信服务限制

    以下限制适用于/admin/serviceAnnouncement/下任何类型的服务通信请求。

    请求类型 每个租户每个应用限制
    任何 每 60 秒 240 个请求
    任何 每小时 800 个请求

    订阅服务

    请求类型 所有租户的每个应用限制 每个租户每个应用限制
    POST, PUT, DELETE, PATCH 每 20 秒 2000 个请求 每 20 秒 500 个请求
    POST /reauthorize 订阅（按 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 响应代码。

    相关内容