Struct RetryPolicy 

#[non_exhaustive]
pub struct RetryPolicy {
    pub max_attempts: u32,
    pub initial_backoff: Duration,
    pub max_backoff: Duration,
    pub jitter: Jitter,
    pub respect_retry_after: bool,
}

Available on crate features async or sync only.

Retry policy applied to outbound requests.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

max_attempts: u32

Maximum total attempts (1 = no retries, 3 = up to 2 retries after the initial attempt).

initial_backoff: Duration

Backoff before the second attempt; doubled each retry, capped at Self::max_backoff.

max_backoff: Duration

Hard cap on the backoff between attempts.

jitter: Jitter

Jitter strategy.

respect_retry_after: bool

If true and the server sent a Retry-After header, sleep at least that long (max(jittered_backoff, retry_after)).

Implementations

impl RetryPolicy

pub fn none() -> Self

A policy that disables retries entirely.

pub fn compute_backoff( &self, attempt: u32, server_retry_after: Option<Duration>, ) -> Duration

Compute the duration to wait before the next attempt.

attempt is the count of failed attempts so far (1 = “first attempt failed; about to do the first retry”). server_retry_after is the Retry-After header value parsed by the client’s response decoder.

Trait Implementations

impl Clone for RetryPolicy

fn clone(&self) -> RetryPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RetryPolicy

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

Formats the value using the given formatter.

impl Default for RetryPolicy

fn default() -> Self

Returns the “default value” for a type.