Cloudflare GraphQL API 公开 70 多个数据集,代表具有不同配置以及不同 zone 和 account 计划数据可用性的产品。
为支持这种产品多样性,Cloudflare GraphQL API 有三层限制:
- 全局限制
- 用户限制
- 节点(数据集)限制
这些限制应用于每个计划的每个查询:
- zone 范围查询最多可包含 10 个 zone
- account 范围查询只能包含 1 个 account
此外,每个请求可发出的查询数量有限。请求中的查询总数等于 zone/account 范围数量乘以应用到的节点数量。
Cloudflare GraphQL API 限制每个用户可发送的 GraphQL 请求数量。 默认配额为 5 分钟窗口内 300 个 GraphQL 查询。它允许用户至少每秒 1 个查询,或突发 300 个查询然后等待 5 分钟再发出另一个查询。
该速率限制与 Cloudflare API 强制执行的一般速率限制 叠加应用。
如果你查询许多 zone 或账户的分析数据,可以选择启用基于账户的速率限制。启用后,限制按账户和 zone 计算,而非按用户或 API 令牌计算。由于每个账户和 zone 都有自己的配额,同一用户或令牌总体上可以发出更多请求,且可以针对每个资源快速提高限制并使之生效。
有关启用方法和查询要求,请参阅基于账户的速率限制。
每个数据节点都有其限制,例如:
- 可以请求多久远的数据,
- 一次查询可请求的最大时间段(秒),
- 一次查询可请求的最大字段数,
- 一次查询可返回的最大记录数。
节点限制与请求的 zoneTag 或 accountTag 绑定。更高级的计划可以访问更多数据集或字段,并可在更宽的历史间隔上查询。
对于 httpRequestsAdaptiveGroups 和 firewallEventsAdaptive 等自适应数据集,所有套餐至少保留 31 天的数据。对于 httpRequests1hGroups 等聚合数据集,保留期限则按套餐分别规定。
要获取 zone 或 account 的确切边界和可用性,请参阅 settings。