Квоты API: объём, частота и параллелизм

Кратко

Исчерпанная квота, всплеск запросов и избыток одновременных операций требуют разных мер. Изучите договор до добавления попыток или аккаунтов.

Пустой защищённый коридор серверов и сетевого оборудования
В этой статье

Определить достигнутый предел

HTTP 429 означает слишком много запросов и может содержать Retry-After. Учёт и область действия определяет сервис. Низкое среднее не предотвращает превышение в коротком окне.

ПонятиеЧто ограничиваетПолезная мера
КвотаОбъём за периодПланировать общий бюджет.
ЧастотаПоступления в коротком окнеРазнести старты.
ПараллелизмТекущие операцииОграничить одновременную работу.
Retry-After: 120Ожидание 120 секундПроверить общий срок и допустимость повтора.

Планировать допустимую нагрузку

  • Уточните ключ учёта: аккаунт, проект, пользователь или маршрут. Проверьте часовой пояс сброса, стоимость операций и общий бюджет.
  • Сглаживайте всплески ограниченной очередью, отдельно ограничивайте выполняемую работу. Передавайте отмены и удаляйте ненужные задачи.
  • Читайте Retry-After как HTTP-дату или задержку в секундах. Учитывайте общий срок и ограничивайте ожидание при отсутствии заголовка.

Повторять без обхода защиты

429 не доказывает безопасность повторной операции. Проверьте идемпотентность, общий срок и число попыток. Измеряйте отказы и очередь; постоянный избыток спроса требует сокращения потребности или согласования мощности.

Первоисточники

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

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

  • Записывайте пороговое значение, решение, маршрут и минимальный контекст без секретов.
  • Сопоставьте повторные отказы с последствиями для законных пользователей.
  • Проверьте, приводят ли оповещения к расследованию или соразмерной настройке.

Первичный источник: ACSC and partners — Event logging and threat detection. Связанный метод: прочитать практическое руководство.