← Аналитика / analytics / graphql-api

Лимиты

Cloudflare GraphQL API предоставляет более 70 наборов данных, которые представляют продукты с разными конфигурациями и доступностью данных для разных зон и тарифных планов аккаунтов.

Чтобы поддерживать такое разнообразие продуктов, Cloudflare GraphQL API использует три уровня ограничений:

• глобальные лимиты
• пользовательские лимиты
• лимиты узла (датасета)

Эти ограничения применяются к каждому запросу для каждого тарифа:

• Запрос в пределах зоны может включать до 10 зон
• Запрос в рамках аккаунта может включать только 1 аккаунт

Кроме того, количество запросов, которые можно выполнить в рамках одного запроса, ограничено. Общее число запросов равно числу областей действия зоны или аккаунта, умноженному на число узлов, к которым они применяются.

Cloudflare GraphQL API ограничивает количество запросов GraphQL, которые может отправить каждый пользователь. Квота по умолчанию составляет 300 GraphQL запросов за 5 минут. Она позволяет пользователю выполнять как минимум 1 запрос в секунду либо отправить пакет из 300 запросов и затем подождать 5 минут перед следующим запросом.

Это ограничение частоты запросов применяется в дополнение к общим лимитам частоты запросов, применяемым API Cloudflare.

Если вы запрашиваете аналитику по многим зонам или аккаунтам, вы можете использовать ограничение частоты запросов на основе аккаунта, где лимиты действуют для каждого аккаунта и каждой зоны отдельно, а не для пользователя или API токена. Поскольку у каждого аккаунта и зоны есть собственный бюджет, один пользователь или токен может выполнять гораздо больше запросов в целом, а повышение лимита можно применить к отдельному ресурсу, и оно вступит в силу быстро.

Сведения о том, как его включить, и требования к запросам см. в разделе Ограничение частоты запросов на основе аккаунта.

У каждого узла данных есть собственные лимиты, например:

• как далеко в прошлое можно запрашивать данные,
• максимальный период времени (в секундах), который можно запросить в одном запросе,
• максимальное количество полей, которые можно запросить в одном запросе,
• максимальное количество записей, которые можно вернуть в одном запросе.

Лимиты узлов зависят от запрошенного zoneTag или accountTag. Более высокие тарифы имеют доступ к более широкому выбору наборов данных или полей и могут запрашивать данные за более широкие исторические периоды.

Точные границы и доступность для ваших зон или аккаунта см. в разделе настройки.