Lists API 提供以编程方式管理以下类型列表的接口:
-
自定义列表 (Custom lists):包含一种或多种相同类型的字符串(例如 IP 地址或主机名),可在规则表达式中按名称整体引用。
-
批量重定向列表 (Bulk Redirect Lists):包含 URL 重定向,可通过创建批量重定向规则启用。
要在规则表达式中使用列表,请参阅 Rules 语言文档中的 Lists。
开始前,请先查看 Lists 的 JSON object 与 Endpoints。
Cloudflare 可能会对您创建、修改或删除自定义列表与 Bulk Redirect Lists 中列表项的 API 请求应用速率限制。
对列表项的每次操作(创建、编辑或删除)都计为一次修改。适用以下限制:
- 在 12 小时内,API 请求中的列表项修改次数最多为 1,000,000 次。
- 在 12 小时内,用于列表项修改的 API 请求最多为 30,000 次。
如果某次写入操作仍在处理中(该处理是异步进行的)而您又提交了新请求,将收到 429 HTTP 状态码。出现此情况时,请稍后重新提交请求。
由 CrowdSec 集成保持更新的列表受到更严格的限制:每 24 小时只能对每个此类列表执行一次批量操作。
如果超过此限制,API 将拒绝请求,并返回 HTTP 状态码 429 和错误代码 10040。响应不包含 operation_id,因为请求在创建批量操作之前就已被拒绝。
为避免达到此限制,请将自动更新安排为最多每 24 小时运行一次,或者使用单独的自定义列表执行更频繁的更新。