平台限制

已完成

平台不提供无限数量的资源并且限制可以进行的 API 调用次数。

解决方案架构师需要通过适当设计并确保自定义代码能够处理违反限制的情况,确保解决方案不超过平台施加的限制。

API 请求

Microsoft Power Platform 中的请求包括用户可在各种产品中执行的各项操作。 以下列表简要描述 API 请求的构成:

  • Power Apps - 所有连接器和 Microsoft Dataverse 的 API 请求。
  • Power Automate - 从初始化变量到简单撰写操作的所有连接器、HTTP 操作和内置操作的 API 请求。 计入这些限制的成功和失败操作。 此外,分页中的重试和其他请求算作操作实现。 作为基本规则,Power Automate 云端流中的每个步骤都是 API 请求。
  • Dataverse - 所有创建、读取、更新和删除 (CRUD)、分配和共享操作,包括完成 CRUD 交易所需的用户驱动和内部系统请求以及共享或分配等特殊操作。 这些请求可以来自任意客户端或应用程序并且可以使用任意终结点。 这些请求包括但不限于执行上述操作的插件、经典工作流和自定义控件。

权利限制

权利限制表示用户每天有权提出的 API 请求数。 分配的限制取决于分配给每个用户的许可证类型。 API 权利限制基于 24 小时期间,如下表所示。

产品 每 24 小时每个付费许可证的请求
Power Platform(不包括 Power Apps 每应用计划、Power Automate 每流计划和 Power Virtual Agents)和 Dynamics 365(不包括 Dynamics 365 Team Member)付费许可用户 40,000
Power Apps 即用即付计划以及 Power Apps 每应用计划、包含 Power Platform 访问权限的 Microsoft 365 应用和 Dynamics 365 Team Member 付费许可用户 6,000
Power Automate 每流计划、Power Virtual Agents 基本产品/服务和 Power Virtual Agents 加载项包 250,000
付费 Power Apps 门户登录 200

Dataverse 提供支持不需要用户许可证即可与服务交互的标识功能。 四类用户分别为:

  • 应用程序用户
  • 非交互用户
  • 管理用户
  • 系统用户

每个租户拥有仅限用户使用,而不支持拥有标准许可证的用户使用的基础请求容量。 本基础请求容量基于预订类型,如下所示:

  • 如果租户至少拥有一项 Dynamics 365 企业订阅,每 24 小时请求容量为 100,000 项。
  • 如果租户至少拥有一项 Dynamics 365 专业订阅,每 24 小时请求容量为 50,000 项。
  • 如果租户至少拥有一项 Microsoft Power Apps 或 Power Automate 订阅,每 24 小时请求容量为 25,000 项。

Power Apps 和 Power Automate 容量加载项允许客户增加给定用户的限制。 每个容量加载项使每 24 小时请求限制增加 10,000 项。

注意

有关详细信息,请参阅 API 请求限制

服务限制

除每日 API 请求限制外,还可对各项服务施加特定服务保护限制。 与日常限制一样,服务限制可以保护服务免受可能中断所有客户服务的恶意或噪音行为的影响,有助于维护服务质量。

服务保护 API 限制有助于确保避免运行应用程序的用户因资源约束而互相干扰。 限制不影响平台的普通用户。 仅执行多项 API 请求的应用程序可能受到影响。 这些限制可提供一定级别的保护,防止请求量随机和意外增加,威胁 Dataverse 平台的可用性和性能特征。

Microsoft 限制每个用户帐户的并发连接数、每个连接的 API 请求数以及每个连接可以使用的运行时间。 在五分钟滑动窗口中评估这些限制。 超出其中一项限制后,平台将引发异常。

重要提示

无法增加服务保护限制。

注意

有关详细信息,请参阅API 限制

重试策略和模式

使用 API 的自定义逻辑应处理重试。 在出现服务保护 API 限制错误时提供值,指示处理用户的任何新请求之前的持续时间。

达到限制时 Web API 返回 429 错误。 响应包括 Retry-After 和秒数。 对于组织服务,在包含密钥 Retry-After 的 OrganizationServiceFault.ErrorDetails 集合中返回 TimeSpan 值。

注意

应注意避免因重试次数过多而使情况恶化。

有关详细信息,请参阅 服务保护限制

最小化 API 调用

解决方案设计不得依赖无限可用容量。 对于交互式应用的普通用户,已设置足够高的限制,用户不应受到影响。

旨在将数据加载到 Dataverse 或执行批量更新的应用程序还必须能够管理服务保护 API 限制错误。 这些应用程序确定吞吐量的优先级,以便在最短的时间内完成工作。 这些应用程序必须采用重试操作策略。

门户应用程序通常通过服务主体帐户发送匿名用户的请求。 服务保护 API 限制基于用户基础,因此门户应用程序可以达到基于门户流量的服务保护 API 限制。

应优化集成,尽量减少 API 调用次数。

解决方案架构师还必须在设计解决方案时考虑高可用性问题。