rate_limit_status
Директива `rate_limit_status` задаёт HTTP код состояния, возвращаемый при превышении лимита частоты запросов.
Описание
Директива rate_limit_status в модуле ограничения скорости запросов с поддержкой Redis для NGINX используется для определения HTTP кода состояния, который должен возвращаться при превышении настроенного лимита запросов. Это позволяет серверу уведомлять клиентов о том, что их запросы были ограничены из‑за достижения предписанных лимитов, обеспечивая возможность корректной обработки таких ситуаций со стороны клиентов. Директива может быть задана в контекстах http, server или location, что делает её гибкой для различных конфигураций маршрутизации в пределах блока сервера NGINX.
При превышении допустимого лимита модуль проверяет настроенный код состояния в директиве rate_limit_status, чтобы определить, какой ответ отправить обратно. По умолчанию многие приложения ожидают код 429 Too Many Requests, который указывает, что пользователь отправил слишком много запросов за определённый промежуток времени. Использование этой директивы гарантирует, что NGINX может следовать этому стандартному поведению или позволяет администраторам настраивать ответ в соответствии с требованиями их приложения.
Например, если служба ограничивает пользователей 15 запросами в минуту, превышение этого порога вызовет ответ, настроенный в rate_limit_status, что помогает эффективно управлять нагрузкой и сигнализирует клиентам о необходимости скорректировать частоту запросов для более стабильной работы.
Пример конфига
rate_limit_status 429;
Убедитесь, что указанный код состояния является допустимым HTTP-кодом; в противном случае это может привести к непредвиденному поведению.
Не забудьте правильно настроить контексты ограничения скорости (например, rate_limit, rate_limit_pass), чтобы увидеть эффект этой директивы.
Если несколько директив rate_limit_status определены в разных контекстах, применяется наиболее специфичная из них. Будьте осторожны при переопределении поведения.