了解 Workers KV 中存储数据的位置如何确定,包括如何将命名空间限制在特定管辖区域。
默认情况下,写入 Workers KV 命名空间的数据会存储在 KV 的中心数据存储中,不受管辖区域限制,然后在 Cloudflare 网络中全局缓存,使您可以从世界任何地方以低延迟读取数据。更多信息请参考 KV 的工作原理。
管辖区域用于创建仅在特定区域内持久存储数据的 Workers KV 命名空间,以帮助遵守 GDPR ↗ 或 FedRAMP ↗ 等数据本地化法规。
Workers 仍可从全球任意位置访问受管辖区域约束的命名空间,KV 数据也可以缓存在管辖区域位置之外的 Cloudflare 网络上。管辖区域约束仅控制命名空间数据的持久存储位置。考虑使用 Regional Services 来控制 Cloudflare 响应请求的区域。
| 参数 | 数据存储位置 |
|---|---|
| eu | 欧盟 |
| fedramp | 符合 FedRAMP 要求的数据中心 |
| us | 美国 |
要创建限制在管辖区域内的命名空间,向 wrangler kv namespace create 传递 --jurisdiction 标志:
npx wrangler@latest kv namespace create <NAMESPACE_NAME> --jurisdiction=eu要创建限制在管辖区域内的命名空间,在创建命名空间时在请求正文中包含 jurisdiction 字段:
Required API token permissions
At least one of the following token permissions is required:Workers KV Storage Write
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/storage/kv/namespaces" \
--request POST \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--json '{
"title": "<NAMESPACE_NAME>",
"jurisdiction": "eu"
}'