Enum Denial 

#[non_exhaustive]
pub enum Denial {
    QuotaExceeded {
        limit: u64,
        retry_after: Duration,
    },
    StorageCapacity {
        retry_after: Option<Duration>,
    },
}

Structured details for a denied check.

A quota denial always contains its policy limit and the remaining window measured by the backend. A storage-capacity denial may contain the duration until the backend’s earliest known expiry, when one is available.

Process-local backends can measure the duration at evaluation time exactly. Distributed backends may return a safe upper bound measured with their authoritative clock, which can overstate the duration at the caller by commit and transport time.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

QuotaExceeded

Consuming the requested cost would exceed the configured quota.

Fields

limit: u64

Configured policy limit.

retry_after: Duration

Remaining duration of the active window.

StorageCapacity

A bounded backend could not safely allocate storage for a new key.

Fields

retry_after: Option<Duration>

Duration until capacity may become available, when known.

Implementations

impl Denial

pub const fn retry_after(&self) -> Option<Duration>

Returns the backend-reported duration after which the caller may retry, if known.

pub const fn retry_after_seconds(&self) -> Option<u64>

Returns a whole-second Retry-After value rounded up, if known.

The underlying Duration remains available through Denial::retry_after. Values beyond the representable range saturate at u64::MAX.

Trait Implementations

impl Clone for Denial

fn clone(&self) -> Denial

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Denial

impl Debug for Denial

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Denial

impl PartialEq for Denial

fn eq(&self, other: &Denial) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Denial