通过 API 配置 Cloud Connector 规则

你可以使用 Cloudflare API 配置 Cloud Connector 规则。

所需权限

用于管理 Cloud Connector 规则的 API 请求的 API 令牌必须至少具有以下权限：

Zone > Cloud Connector > Write

端点

要获得完整端点，请将下方列出的 Cloud Connector 端点追加到 Cloudflare API 基 URL：

https://api.cloudflare.com/client/v4

{zone_id} 参数是 zone ID（十六进制字符串）。你可以在 Cloudflare 仪表板中找到此值。

下表汇总了可用操作。

操作	动词 + 端点
列出 Cloud Connector 规则	`GET /zones/{zone_id}/cloud_connector/rules`
创建/更新/删除 Cloud Connector 规则	`PUT /zones/{zone_id}/cloud_connector/rules`

API 调用示例

Cloud Connector 规则列表

以下示例返回现有 Cloud Connector 规则的列表：

Required API token permissions

At least one of the following token permissions is required:

Cloud Connector Read
Cloud Connector Write

Rulesbash

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/cloud_connector/rules" \
	--request GET \
	--header "X-Auth-Email: $CLOUDFLARE_EMAIL" \
	--header "X-Auth-Key: $CLOUDFLARE_API_KEY"

{
	"result": [
		{
			"id": "<RULE_1_ID>",
			"provider": "aws_s3",
			"expression": "http.request.uri.path wildcard \"/images/*\"",
			"description": "Connect to S3 bucket containing images",
			"enabled": true,
			"parameters": {
				"host": "examplebucketwithimages.s3.north-eu.amazonaws.com"
			}
		}
	],
	"success": true,
	"errors": [],
	"messages": []
}

创建/更新/删除 Cloud Connector 规则

以下示例请求将用单条规则替换所有现有 Cloud Connector 规则：

Required API token permissions

At least one of the following token permissions is required:

Cloud Connector Write

Put Rulesbash

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/cloud_connector/rules" \
	--request PUT \
	--header "X-Auth-Email: $CLOUDFLARE_EMAIL" \
	--header "X-Auth-Key: $CLOUDFLARE_API_KEY" \
	--json '[
		{
				"expression": "http.request.uri.path wildcard \"/images/*\"",
				"provider": "cloudflare_r2",
				"description": "Connect to R2 bucket containing images",
				"parameters": {
						"host": "mybucketcustomdomain.example.com"
				}
		}
	]'

每条规则的必需正文参数为：expression、provider 和 parameters.host。

provider 值必须是以下之一：cloudflare_r2、aws_s3、azure_storage 和 gcp_storage。