要调用 Cloudflare Firewall Rules API 操作,请将端点附加到 Cloudflare API 基础 URL:
https://api.cloudflare.com/client/v4/有关身份验证说明,请参阅 Cloudflare API 文档中的入门:请求。
有关端点和分页的帮助,请参阅入门:端点。
Cloudflare Firewall Rules API 支持下面概述的操作。访问本节中的页面以获取示例。
| 操作 | 方法和端点 | 备注 |
|---|---|---|
创建防火墙规则 | POST zones/<ZONE_ID>/firewall/rules | 作为单个事务处理。如果发生错误,则整个操作将失败。 |
列出防火墙规则 | GET zones/<ZONE_ID>/firewall/rules | 列出所有当前的防火墙规则。结果默认以每页 25 个项目进行分页返回。使用可选参数来缩小结果范围。 |
获取防火墙规则 | GET zones/<ZONE_ID>/firewall/rules/<RULE_ID> | 通过 ID 检索单个防火墙规则。 |
更新防火墙规则 | PUT zones/<ZONE_ID>/firewall/rules | 作为单个事务处理。所有规则必须存在才能使操作成功。如果发生错误,则整个操作将失败。 |
更新单个防火墙规则 | PUT zones/<ZONE_ID>/firewall/rules/<RULE_ID> | 通过 ID 更新单个防火墙规则。 |
删除防火墙规则 | DELETE zones/<ZONE_ID>/firewall/rules | 删除现有的防火墙规则。必须指定防火墙规则 ID 列表。 空请求不会导致任何删除操作。如果指定的规则不存在,则返回 HTTP 状态码 200。 |
删除单个防火墙规则 | DELETE zones/<ZONE_ID>/firewall/rules/<RULE_ID> | 通过 ID 删除防火墙规则。 |