Struct RetryPolicy 

pub struct RetryPolicy {
    pub max_retries: u32,
    pub initial_backoff: Duration,
    pub max_backoff: Duration,
    pub multiplier: f64,
    pub retryable_statuses: Vec<u16>,
}

Controls how failed requests are retried.

By default the SDK retries up to 2 times on connection errors and on the statuses listed in RetryPolicy::retryable_statuses (which includes the documented 429 Too Many Requests and 529 Overloaded), using exponential backoff with jitter, and honoring the Retry-After response header.

Set RetryPolicy::none (or max_retries: 0) to disable retries.

Fields

max_retries: u32

Maximum number of retries after the initial attempt. 0 disables retries.

initial_backoff: Duration

Backoff before the first retry.

max_backoff: Duration

Upper bound for any single backoff.

multiplier: f64

Multiplier applied to the backoff after each attempt.

retryable_statuses: Vec<u16>

HTTP statuses considered transient.

Implementations

impl RetryPolicy

pub fn none() -> Self

A policy that never retries.

pub fn should_retry_status(&self, status: StatusCode) -> bool

Whether a response status is retryable under this policy.

pub fn backoff_for(&self, attempt: u32) -> Duration

The delay before retry attempt attempt (0 = first retry), including up to 25% random jitter and capped at RetryPolicy::max_backoff.

This function is total: non-finite or non-positive multipliers fall back to 2.0, and overflow saturates at max_backoff instead of panicking.

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.