使用配额

配额限制一个操作在滚动窗口内可以运行多少次。达到限制的人会看到你为该规则所写的消息。

操作上的规则

配额在配置中、在操作上声明,形式是一个规则列表。规则设置 points,即窗口内允许的最多运行次数,以及 duration,即窗口的长度,单位为秒。points 为零表示不限量。窗口是滑动的:每次运行都有时间戳,早于 duration 的运行会移出计数。

统计谁的运行

规则可以按已登录用户计数,使每个人有自己的额度。配额也可以在更大的范围内共享。

达到限制时

调用会失败,错误为 RATE_LIMITED 并附带该规则的消息。没有消息的规则会返回一个错误,说明用量、限额以及窗口重置的时间。

由规则顺序形成层级

规则按从上到下的顺序评估,第一个匹配的生效。规则可以限定为某个分群的成员,由此可以搭建分层设置:先为付费用户分群设一条不限量的规则,再为其他所有人设一条计量规则。

检查顺序与失败

配额在前置条件通过之后检查。如果无法读取计数存储,规则默认放行调用,规则也可以设为失败时关闭并拒绝。配额只计量操作。

了解详情

操作配置参考列出了配额规则上的每个字段,并展示了分层模式。