← Resource Tagging / resource-tagging / reference

Ограничения и валидация

Ограничения API

Лимит	Значение	Код ошибки
Максимум тегов на аккаунт	10 000 (бета)	N/A
Максимальная длина ключа тега	256 символов	`1011`
Максимальная длина значения тега	1024 символа	`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.

Пагинация

Конечные точки для получения списка используют постраничную загрузку на основе курсора с фиксированным размером страницы 100. Изменить размер страницы нельзя.

Конечные точки с пагинацией:

GET /accounts/{account_id}/tags/keys
GET /accounts/{account_id}/tags/resources
GET /accounts/{account_id}/tags/values/{tag_key}

См. Фильтрация ресурсов по тегу для примеров пагинации.