cookie_limit_req_status

Директива `cookie_limit_req_status` задаёт код состояния HTTP, возвращаемый для запросов, которые превышают настроенные ограничения по частоте.

Синтаксисcookie_limit_req_status code;
По умолчанию503
Контекстhttp, server, location, if in location
Аргументы1

Описание

Директива cookie_limit_req_status является частью ngx_cookie_limit_req_module, которая используется для управления частотой запросов, связанных с cookie. Когда при обработке запроса обнаруживается превышение допустимой частоты запросов, он может быть либо отложен, либо отклонён в зависимости от настроек других директив, таких как cookie_limit_req и cookie_limit_req_zone. Директива cookie_limit_req_status конкретно определяет код состояния HTTP, который будет возвращён клиенту, когда запрос отклоняется из‑за чрезмерного количества запросов с cookie.

Директива принимает один аргумент — код состояния HTTP для возврата, и допускает значения в пределах стандартного диапазона кодов HTTP. По умолчанию, если директива не указана, возвращается код состояния 503. Настраивая это значение, администраторы могут предоставить клиентам более информативную информацию, например 403 (Запрещено) или 429 (Слишком много запросов), в зависимости от контекста приложения и стратегии ответа.

Пример конфига

cookie_limit_req_status 403;

Убедитесь, что код состояния находится в пределах допустимых диапазонов кодов состояния HTTP (400-599).

Если не указать эту директиву, по умолчанию будет использован 503, что может не подходить для всех приложений.

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

← Ко всем директивам