对于某些操作,您可以使用 Rulesets API 提供的特定端点来管理阶段入口点规则集。这些端点在端点中包含阶段名称,而不是规则集 ID。
例如,代替使用以下端点:
PUT /zones/{zone_id}/rulesets/{ruleset_id}您可以使用以下端点:
PUT /zones/{zone_id}/rulesets/phases/{phase_name}/entrypoint要调用 Rulesets API 操作,请将端点附加到 Cloudflare API 基础 URL:
https://api.cloudflare.com/client/v4有关身份验证说明,请参阅 Cloudflare API 文档中的入门:请求。
有关端点和分页的帮助,请参阅入门:端点。
Cloudflare Rulesets API 支持以下概述的操作。请访问相关链接以获取 API 端点和示例。
| 操作 | 方法 | 注释 |
|---|---|---|
| 列出现有规则集 | GET | 返回账户级别或区域级别的现有规则集列表。 |
| 查看特定规则集 | GET | 返回特定规则集最新版本的属性。 |
列出规则集的所有版本 | GET | 返回规则集的所有版本列表。 |
查看规则集的特定版本 | GET | 返回规则集特定版本的配置,包括其规则。 |
列出具有特定标签的托管规则集中的规则 | GET | 返回具有特定标签的托管规则集中所有规则的列表。 |
| 操作 | 谓词 | 注释 |
|---|---|---|
| 创建规则集 | POST | 创建新规则集或新阶段入口点。 |
| 操作 | 谓词 | 注释 |
|---|---|---|
| 更新或部署规则集 | PUT | 更新规则集的基本属性和规则集中的规则列表。 允许您配置托管规则集的执行。 |
| 将规则添加到规则集 | POST | 将单个规则添加到现有规则集。 允许您添加单个规则,而无需在请求中包含所有现有规则集规则。 |
| 更新规则集中的规则 | PATCH | 更新规则集中单个规则的定义。 允许您更改规则集中规则的顺序。 |
| 删除规则集中的规则 | DELETE | 删除规则集中的单个规则。 |
| 操作 | 谓词 | 注释 |
|---|---|---|
| 删除规则集 | DELETE | 删除规则集的所有版本。 |
| 删除规则集版本 | DELETE | 删除规则集的特定版本。 |