30s, 1m, 1h), and the Retry-After the refusal
carries — by default the window, which is when the allowance actually returns.
Refused responses carry the standard rate-limit headers so a well-behaved client
backs off on its own.
What the counter counts depends on the scope. Gateway-wide, one counter covers all
traffic. Targeted, each application gets its own. This is the only type that
offers Throttle mode: a request over the line waits its share of the window
and then goes through, which turns a burst into a queue instead of a wall of 429s.
Group by header splits the counter by a header value — X-User-Id, say — so
one policy gives every end user of an application their own allowance.
Where to apply it
A refused request gets HTTP 429 with the standard rate-limit headers and the
Retry-After you set. Pair it with an LLM Budget
when the concern is spend rather than volume.