Struct RetryParams 

pub struct RetryParams {
    pub attempts: u32,
    pub retry_post: bool,
    pub backoff_base_ms: u64,
    pub backoff_cap_ms: u64,
    pub retry_statuses: Vec<u16>,
    pub retry_transport: bool,
    pub budget_percent: u32,
    pub buffer_max_bytes: u64,
    pub hedge: HedgeParams,
    pub total_deadline: Option<Duration>,
    pub buffer_first_frame_bytes: u64,
}

Resolved (validated) retry parameters for one upstream. attempts == 0 disables retries entirely — the single-attempt path then performs no body buffering and no extra per-request work (the budget denominator is still recorded: the window counts all proxied traffic).

Fields

attempts: u32

Maximum retries beyond the first attempt.

retry_post: bool

Whether POST requests may be retried (opt-in). Governs POST only: other non-idempotent methods (DELETE, PATCH, …) are never retried.

backoff_base_ms: u64

Backoff base (milliseconds).

backoff_cap_ms: u64

Backoff ceiling (milliseconds).

retry_statuses: Vec<u16>

Response statuses that trigger a retry.

retry_transport: bool

Whether transport errors and per-attempt read timeouts trigger a retry.

budget_percent: u32

Retry budget percentage in (0, 100].

buffer_max_bytes: u64

Request-body buffering cap in bytes.

hedge: HedgeParams

Request hedging parameters (DW-063).

total_deadline: Option<Duration>

Cross-attempt total retry deadline (REL-01): caps the wall-clock time from the first attempt to the last, INCLUDING backoff delays. None leaves the cross-attempt budget unbounded (the default).

buffer_first_frame_bytes: u64

Streaming failover first-frame buffer cap in bytes (REL-05, #216). When > 0, the proxy buffers up to this many bytes of the upstream response body before forwarding any bytes to the client, so a mid-body failure before the buffer fills can still trigger a retry to a different endpoint. Default 0 = no first-frame buffering (v1 behavior).

Implementations

impl RetryParams

pub fn from_config(cfg: Option<&RetryConfig>) -> Self

Resolve from the config form; None yields the disabled default (serde has already applied per-field defaults for a present block).

pub fn retries_status(&self, status: u16) -> bool

Whether a response status triggers a retry under these parameters.

Trait Implementations

impl Clone for RetryParams

fn clone(&self) -> RetryParams

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RetryParams

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

Formats the value using the given formatter.

impl Default for RetryParams

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for RetryParams

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RetryParams