Last updated 2026-05-18

Redis Model

V1 supports Redis single-primary or primary-replica topology. Redis Cluster is not supported because decisions may touch arbitrary keys that must be evaluated and mutated atomically in one Lua script.

Prefix

quota:v1:{environment}:{product}:

Key families

req:{request_id}
fw:{limit_id_hash}:{scope_hash}:{window_id}
sw:{limit_id_hash}:{scope_hash}:{bucket_id}
tb:{limit_id_hash}:{scope_hash}
lb:{limit_id_hash}:{scope_hash}
gcra:{limit_id_hash}:{scope_hash}
res:{reservation_id}
res_expiry
lease_set:{limit_id_hash}:{scope_hash}
lease:{lease_id}

Lua scripts

• consume.lua
• reserve.lua
• increment_reservation.lua
• finalize_reservation.lua
• release_reservation.lua
• expire_reservations.lua
• acquire_lease.lua
• renew_lease.lua
• release_lease.lua