カスタムルールセットを作成する

Create an account or zone ruleset 操作でカスタムルールセットを作成します。次の点を確認してください。

kind フィールドを custom に設定します。
phase フィールドに、カスタムルールセットを作成したいフェーズの名前を指定します。

rules 配列で、カスタムルールセットに含めるルールの一覧も指定できます。カスタムルールセット作成後にルールを追加する場合はカスタムルールセットにルールを追加するを参照してください。

Terraform を使っている場合は、カスタムルールセットの作成とデプロイの例について Terraform による WAF カスタムルールの設定を参照してください。

Cloudflare ダッシュボードを使っている場合は、ダッシュボードでカスタムルールセットを操作するを参照してください。

例 A - アカウントレベルのカスタムルールセット

次のリクエストは、アカウントレベルで新しいカスタムルールセットを作成します。応答の id フィールドに、新しいカスタムルールセットの ID が含まれます。

Required API token permissions

At least one of the following token permissions is required:

Mass URL Redirects Write
Magic Firewall Write
L4 DDoS Managed Ruleset Write
Transform Rules Write
Select Configuration Write
Account WAF Write
Account Rulesets Write
Logs Write

Create an account rulesetbash

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/rulesets" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"name": "Custom Ruleset 1",
		"description": "My First Custom Ruleset (account)",
		"kind": "custom",
		"phase": "http_request_firewall_custom"
	}'

{
	"result": {
		"id": "f82ccda3d21f4a02825d3fe45b5e1c10",
		"name": "Custom Ruleset 1",
		"description": "My First Custom Ruleset (account)",
		"kind": "custom",
		"version": "1",
		"last_updated": "2025-08-09T10:27:30.636197Z",
		"phase": "http_request_firewall_custom"
	},
	"success": true,
	"errors": [],
	"messages": []
}

カスタムルールセットの作成リクエストに、ルールの一覧を含められます。まだルールを追加していない場合は、カスタムルールセットにルールを追加するを参照してください。

例 B - ゾーンレベルのカスタムルールセット

次のリクエストは、ゾーンレベルで新しいカスタムルールセットを作成します。応答の id フィールドに、新しいカスタムルールセットの ID が含まれます。

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

Create a zone rulesetbash

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/rulesets" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"name": "Custom Ruleset 1",
		"description": "My First Custom Ruleset (zone)",
		"kind": "custom",
		"phase": "http_request_firewall_custom"
	}'

{
	"result": {
		"id": "f82ccda3d21f4a02825d3fe45b5e1c10",
		"name": "Custom Ruleset 1",
		"description": "My First Custom Ruleset (zone)",
		"kind": "custom",
		"version": "1",
		"last_updated": "2025-08-09T10:27:30.636197Z",
		"phase": "http_request_firewall_custom"
	},
	"success": true,
	"errors": [],
	"messages": []
}