常用 API 调用

以下示例介绍了使用 Cloudflare API 管理和配置 WAF 内容扫描的常用方案。

如果您使用的是 Terraform，请参阅 Terraform 配置示例。

常规操作

以下 API 示例涵盖了启用和禁用 WAF 内容扫描等基本操作。

启用 WAF 内容扫描

要启用内容扫描，请使用类似于以下的 POST 请求：

Required API token permissions

At least one of the following token permissions is required:

Zone WAF Write
Account WAF Write

Enable Content Scanningbash

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/content-upload-scan/enable" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

禁用 WAF 内容扫描

要禁用内容扫描，请使用类似于以下的 POST 请求：

Required API token permissions

At least one of the following token permissions is required:

Zone WAF Write
Account WAF Write

Disable Content Scanningbash

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/content-upload-scan/disable" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

获取 WAF 内容扫描状态

要获取内容扫描功能的当前状态，请使用类似于以下的 GET 请求：

Required API token permissions

At least one of the following token permissions is required:

Zone WAF Write
Zone WAF Read
Account WAF Write
Account WAF Read

Get Content Scanning Statusbash

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/content-upload-scan/settings" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

自定义扫描表达式操作

以下 API 示例涵盖了针对内容扫描自定义扫描表达式的操作。

获取现有的自定义扫描表达式

要获取现有自定义扫描表达式的列表，请使用类似于以下的 GET 请求：

Required API token permissions

At least one of the following token permissions is required:

Zone WAF Write
Zone WAF Read
Account WAF Write
Account WAF Read

List Existing Custom Scan Expressionsbash

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/content-upload-scan/payloads" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

{
	"result": [
		{
			"id": "<EXPRESSION_ID>",
			"payload": "lookup_json_string(http.request.body.raw, \"file\")"
		}
	],
	"success": true,
	"errors": [],
	"messages": []
}

添加自定义扫描表达式

使用类似于以下的 POST 请求：

Required API token permissions

At least one of the following token permissions is required:

Zone WAF Write
Account WAF Write

Add Custom Scan Expressionsbash

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/content-upload-scan/payloads" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '[
		{
				"payload": "lookup_json_string(http.request.body.raw, \"file\")"
		}
	]'

删除自定义扫描表达式

使用类似于以下的 DELETE 请求：

Required API token permissions

At least one of the following token permissions is required:

Zone WAF Write
Account WAF Write

Delete a Custom Scan Expressionbash

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/content-upload-scan/payloads/$EXPRESSION_ID" \
	--request DELETE \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"