跳转到内容
搜索文档

部署规则集

最后更新 查看 MarkdownAgent 设置

使用 Rulesets API 部署规则集。要部署规则集,请向 phase 入口点规则集 添加一条 "action": "execute" 的规则,并在操作参数中指定要执行的规则集 ID。每部署一个规则集都使用单独的规则。

执行规则集的规则包含:

  • 要执行的规则集 ID,包含在 action_parameters.id 中。
  • 表达式。
  • execute 操作。

当请求满足表达式时,规则集中的规则会执行。

示例

以下示例通过添加一条执行托管规则集的规则,将 Cloudflare Managed Ruleset(ID 为 )部署到指定 zone($ZONE_ID)的 http_request_firewall_managed phase。

Required API token permissions

At least one of the following token permissions is required:
  • Response Compression Write
  • Config Settings Write
  • Dynamic URL Redirects Write
  • Cache Settings Write
  • Custom Errors Write
  • Origin Write
  • Managed headers Write
  • Zone Transform Rules Write
  • Mass URL Redirects Write
  • Magic Firewall Write
  • L4 DDoS Managed Ruleset Write
  • HTTP DDoS Managed Ruleset Write
  • Sanitize Write
  • Transform Rules Write
  • Select Configuration Write
  • Bot Management Write
  • Zone WAF Write
  • Account WAF Write
  • Account Rulesets Write
  • Logs Write
  • Logs Write
Update a zone entry point rulesetbash
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/rulesets/phases/http_request_firewall_managed/entrypoint" \
	--request PUT \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"rules": [
				{
						"action": "execute",
						"action_parameters": {
								"id": "efb7b8c949ac4650a09736fc376e9aee"
						},
						"expression": "true",
						"description": "Execute Cloudflare Managed Ruleset on my zone ruleset"
				}
		]
	}'
{
	"result": {
		"id": "<ZONE_PHASE_RULESET_ID>",
		"name": "Zone-level Ruleset 1",
		"description": "",
		"kind": "zone",
		"version": "latest",
		"rules": [
			{
				"id": "<RULE_ID>",
				"version": "1",
				"action": "execute",
				"action_parameters": {
					"id": "efb7b8c949ac4650a09736fc376e9aee",
					"version": "3"
				},
				"expression": "true",
				"description": "Execute Cloudflare Managed Ruleset on my zone ruleset",
				"last_updated": "2021-03-18T18:08:14.003361Z",
				"ref": "<RULE_REF>",
				"enabled": true
			}
		],
		"last_updated": "2021-03-18T18:08:14.003361Z",
		"phase": "http_request_firewall_managed"
	},
	"success": true,
	"errors": [],
	"messages": []
}

相关资源

有关部署规则集的更多示例,请参阅以下页面:

请参阅 使用托管规则集使用自定义规则集 了解更多信息。

有关编辑与部署规则集的可用 API 端点的更多信息,请参阅 更新或部署规则集

这篇文档对您有帮助吗?