← Resource Tagging / resource-tagging / reference
Limity a validace
Limity API
| Limit | Hodnota | Kód chyby |
|---|---|---|
| Maximální počet štítků na účet | 10 000 (beta) | N/A |
| Maximální délka klíče štítku | 256 znaků | 1011 |
| Maximální délka hodnoty štítku | 1 024 znaků | 1012 |
| Maximální počet filtrů štítků na dotaz | 20 | 1010 |
| Maximální počet hodnot OR na filtr | 10 | 1013 |
| Výsledky na stránku | 100 (pevné) | N/A |
Když je limit překročen, API vrátí 400 Bad Request s odpovídajícím chybovým kódem.
Během beta verze je každý účet omezen na celkem 10 000 štítků. Pokud potřebujete vyšší limit, kontaktujte podpora Cloudflare.
Rozlišování velkých a malých písmen
U klíčů a hodnot tagů se rozlišují velká a malá písmena. Environment, environment, a ENVIRONMENT se považují za tři odlišné klíče. Dodržujte v celé organizaci konzistentní konvence velikosti písmen, abyste se vyhnuli duplicitním klíčům.
Ověření klíče tagu
Klíče tagů musí splňovat tato pravidla pro znaky:
Povoleno
- Písmena Unicode (libovolný jazyk)
- Číslice Unicode (0-9)
- Podtržítka (
_) - Tečky (
.) - Spojovníky (
-)
Nepovoleno
- Prázdné řetězce
- Mezery
- Speciální znaky (kromě
_,.,-)
Příklady
| Key | Platné | Důvod |
|---|---|---|
environment |
Ano | Pouze písmena |
team_name |
Ano | Podtržítko |
cost-center |
Ano | Spojovník |
owner.email |
Ano | Období |
env123 |
Ano | Písmena a číslice |
env name |
Ne | Obsahuje mezeru |
team@work |
Ne | Speciální znak @ |
| (prázdné) | Ne | Prázdný řetězec |
Neplatné klíče štítků vrátí 400 Bad Request s chybovým kódem 1014.
Stránkování
Endpointy pro výpis používají stránkování založené na kurzoru s pevnou velikostí stránky 100. Velikost stránky nelze konfigurovat.
Stránkované koncové body:
GET /accounts/{account_id}/tags/keysGET /accounts/{account_id}/tags/resourcesGET /accounts/{account_id}/tags/values/{tag_key}
Viz Filtrování prostředků podle štítku pro příklady stránkování.