速率限制 API 请求

如果每次发送的 API 请求太多，则会影响系统的性能。您可以启用速率限制，这会对每个用户发送的 API 请求数施加限制。

SD-WAN Orchestrator 使用特定的防护机制以防范 API 滥用，并将系统保持稳定。将阻止超过允许的请求限制的 API 请求，并返回 HTTP 429（请求太多）。再次发出请求之前，系统需要经历一个冷却期。

将在 SD-WAN Orchestrator 上部署以下类型的速率限制器：

• 漏斗限制器 - 平滑处理请求突发，并仅允许预定义数量的请求。该限制器负责限制在给定时间段内允许的请求数。
• 并发限制器 - 限制并行发出的请求数，并发请求将导致资源争用，并且可能会导致查询长时间运行。

以下是导致限制 API 请求速率的主要原因：

• 大量活动或并发请求。
• 请求数量突然激增。
• 丢弃了导致在 Orchestrator 上长时间运行查询（从而长时间占用系统资源）的请求。

如果启用了 VCO 速率限制功能，依赖于 API 的开发人员可以采取以下措施以提高代码稳定性。

• 在请求超过速率限制时，处理 HTTP 429 响应代码。
• 在速率限制器达到给定时间段内允许的最大请求数时，惩罚时间为 5000 毫秒。如果已阻止，再次发出请求之前，客户端需要经历 5000 毫秒的冷却期。在 5000 毫秒的冷却期内发出的请求仍会受到速率限制。
• 对于不会由于长时间运行的查询而让请求过期的时间序列 API，请使用较短的时间间隔。
• 对于查询各个客户或 Edge 的请求，请尽可能首选批量查询方法。

注： 操作员超级用户根据环境单独配置速率限制。如果对相关策略有任何疑问，请与您的操作员联系。

使用系统属性配置速率限制策略

您可以使用以下系统属性启用速率限制，并定义默认的策略集：

• vco.api.rateLimit.enabled
• vco.api.rateLimit.mode.logOnly
• vco.api.rateLimit.rules.global
• vco.api.rateLimit.rules.enterprise.default
• vco.api.rateLimit.rules.enterpriseProxy.default

有关系统属性的更多信息，请参阅系统属性列表。

使用 API 配置速率限制策略

建议使用系统属性将速率限制器策略配置为全局规则，因为这种方法可以获得最佳的 API 性能，便于进行故障排除，并确保所有合作伙伴和客户具有一致的用户体验。但在极少数情况下，操作员可能会发现全局策略对于特定租户或用户过于宽松。对于这些情况， VMware 支持以下仅操作员 API，以便为特定的合作伙伴和企业设置策略。

• enterpriseProxy/insertOrUpdateEnterpriseProxyRateLimits - 用于配置合作伙伴特定的策略。
• enterprise/insertOrUpdateEnterpriseRateLimits - 用于配置客户特定的策略。

有关这些 API 的更多信息，请参阅 https://code.vmware.com/apis/1037/velocloud-sdwan-vco-api。