| 限制 (Limit) | 值 (Value) | 错误代码 (Error code) |
|---|---|---|
| 每个账户的最大标签数 | 10,000 (beta) | 不适用 (N/A) |
| 最大标签键长度 | 256 字符 | 1011 |
| 最大标签值长度 | 1,024 字符 | 1012 |
| 每次查询的最大标签过滤器数 | 20 | 1010 |
| 每个过滤器的最大 OR 值个数 | 10 | 1013 |
| 每页结果数 | 100 (固定) | 不适用 (N/A) |
当超出限制时，API 将返回 400 Bad Request 错误，并附带相应的错误代码。
在公测期间，每个账户总共限制为 10,000 个标签。如果您需要更高的限制，请联系 Cloudflare 支持。
标签键和值对大小写敏感。Environment、environment 和 ENVIRONMENT 会被视为三个不同的键。请在您的组织中保持统一的大小写约定，以避免产生重复的键。
标签键必须遵循以下字符规则：
- Unicode 字母（任意语言）
- Unicode 数字（0-9）
- 下划线 (
_) - 点号 (
.) - 连字符 (
-)
- 空字符串
- 空格
- 特殊字符（除了
_、.、-）
| 键 | 是否有效 | 原因 |
|---|---|---|
environment |
是 | 仅含字母 |
team_name |
是 | 包含下划线 |
cost-center |
是 | 包含连字符 |
owner.email |
是 | 包含点号 |
env123 |
是 | 字母和数字组合 |
env name |
否 | 包含空格 |
team@work |
否 | 包含特殊字符 @ |
| （空） | 否 | 空字符串 |
无效的标签键将返回 400 Bad Request 并附带错误代码 1014。
列表端点使用基于游标的分页（cursor-based pagination），固定每页 100 个结果。每页大小不可配置。
分页端点：
GET /accounts/{account_id}/tags/keysGET /accounts/{account_id}/tags/resourcesGET /accounts/{account_id}/tags/values/{tag_key}
请参阅 使用标签过滤资源 以获取分页示例。