| 制限 | 値 | エラーコード |
|---|---|---|
| アカウントあたりのタグ上限 | 10,000（ベータ） | N/A |
| タグキーの最大長 | 256 文字 | 1011 |
| タグ値の最大長 | 1,024 文字 | 1012 |
| クエリあたりのタグフィルター上限 | 20 | 1010 |
| フィルターあたりの OR 値上限 | 10 | 1013 |
| 1 ページあたりの結果件数 | 100（固定） | N/A |
制限を超えると、API は対応するエラーコード付きで 400 Bad Request を返します。
ベータ期間中、各アカウントのタグ総数は 10,000 件までです。より高い上限が必要な場合は、Cloudflare サポート へお問い合わせください。
タグのキーと値は大文字と小文字を区別します。Environment、environment、ENVIRONMENT は 3 つの別キーとして扱われます。重複キーを避けるため、組織全体で大文字・小文字の規則を揃えてください。
タグキーは次の文字規則に従う必要があります。
- Unicode の文字（任意の言語）
- Unicode の数字（0-9）
- アンダースコア（
_） - ピリオド（
.） - ハイフン（
-）
- 空文字列
- スペース
- 特殊文字（
_、.、-を除く）
| キー | 有効 | 理由 |
|---|---|---|
environment |
はい | 文字のみ |
team_name |
はい | アンダースコア |
cost-center |
はい | ハイフン |
owner.email |
はい | ピリオド |
env123 |
はい | 文字と数字 |
env name |
いいえ | スペースを含む |
team@work |
いいえ | 特殊文字 @ |
| （空） | いいえ | 空文字列 |
無効なタグキーは、エラーコード 1014 付きで 400 Bad Request を返します。
一覧エンドポイントは、ページサイズ固定 100 件のカーソルベースのページネーションを使います。ページサイズは変更できません。
ページネーション対象のエンドポイント:
GET /accounts/{account_id}/tags/keysGET /accounts/{account_id}/tags/resourcesGET /accounts/{account_id}/tags/values/{tag_key}
詳細なページネーション例は タグでリソースを絞り込む を参照してください。