资源标记

Resource Tagging（资源标记）允许您向广泛的 Cloudflare 资源类型——包括 zone、自定义主机名、Cloudflare Tunnel、Worker、D1 数据库、R2 存储桶、KV 命名空间等——附加键值对。标签与资源本身分开存储，无需修改底层资源配置即可实现跨资源查询和策略实施。

标签是存储为 JSON 对象的简单键值字符串对：

{
  "environment": "production",
  "team": "platform",
  "region": "us-west-1"
}

您可以通过 Tagging API 使用 GET、PUT 和 DELETE 操作来管理标签。API 支持通过 使用标签过滤资源，支持 AND/OR 逻辑、取反以及仅匹配键（key-only matching）。

身份验证使用 账户所有令牌 (Account Owned Tokens，AOT)，这是独立于单个用户的账户级令牌。

• 仪表板处于 Beta 阶段。您可以在仪表板的 Manage Account（管理账户）> **Resource Tagging（资源标记）**下查看和管理标签，但 API 仍然是自动化工作流的推荐接口。
• PUT 会替换所有标签。没有 PATCH 端点。PUT 操作会替换资源上的所有标签。要修改单个标签，请使用 GET、合并、PUT 工作流。
• DELETE 会移除所有标签。无法删除单个标签。请改用带有所需保留标签的 PUT 操作。
• 查询从未被标记过的资源的标签会返回 500 错误，而不是 404。这是已知的 Beta 阶段限制。

遵循 快速入门指南 设置身份验证并进行您的首次 API 调用。