Enum Denial 

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

Structured details for a denied check.

A quota denial always contains its policy capacity and the duration until the requested cost can be retried. 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.

With the serde feature, this is an object tagged by reason. Durations use Serde’s exact { "secs": ..., "nanos": ... } representation.

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

capacity: u64

Maximum immediately available policy allowance.

retry_after: Duration

Duration until the rejected cost can be retried.

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<'de> Deserialize<'de> for Denial

Available on crate feature serde only.

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

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 Serialize for Denial

Available on crate feature serde only.

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Denial