← Resource Tagging / resource-tagging

Маркировка ресурсов

Resource Tagging позволяет прикреплять пары «ключ-значение» к широкому спектру Типы ресурсов Cloudflare: включая зоны, пользовательские хосты, Cloudflare Tunnels, Workers, базы данных D1, бакеты R2, пространства имён KV и другие. Теги хранятся отдельно от самих ресурсов, что позволяет выполнять межресурсные запросы и применять политики без изменения конфигурации базовых ресурсов.

Теги представляют собой простые строковые пары «ключ-значение», хранящиеся в виде объекта JSON:

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

Вы управляете тегами через API тегирования с помощью GET, PUT, а также DELETE операции. API поддерживает фильтрация ресурсов по тегам с логикой И/ИЛИ, отрицанием и сопоставлением только по ключу.

Аутентификация выполняется с использованием Account Owned Tokens (AOTs), это токены уровня аккаунта, не привязанные к отдельным пользователям.

• Панель управления находится в бете. Просматривать и управлять тегами можно в панели управления в разделе Manage Account > Маркировка ресурсов, но API остаётся рекомендуемым интерфейсом для процессов автоматизации.
• PUT заменяет все теги. Не существует PATCH конечная точка. PUT операция заменяет все теги ресурса. Используйте GET, объедините, PUT рабочий процесс для изменения отдельных тегов.
• DELETE удаляет все теги. Удалить один тег отдельно нельзя. Используйте PUT с оставшимися тегами.
• Запрос тегов для ресурса, который никогда не был помечен тегами, возвращает 500 ошибку вместо 404. Это известное ограничение бета версии.

Следуйте Руководство по началу работы чтобы настроить аутентификацию и выполнить первые вызовы API.