Struct RetryPolicy 

pub struct RetryPolicy { /* private fields */ }

Available on crate feature retry only.

Retries 429 Too Many Requests, 408 Request Timeout and 5xx responses, and failures to connect.

It waits as long as a Retry-After header (in seconds) asks, or else backs off exponentially from RetryPolicy::base_delay up to RetryPolicy::max_delay. A request whose body is a stream (a streamed file upload) cannot be sent again and is not retried.

Implementations

impl RetryPolicy

pub fn new(max_retries: usize) -> Self

A policy that retries at most max_retries times (after the first attempt).

pub fn base_delay(self, delay: Duration) -> Self

The first backoff delay, doubled on each retry (default 200 ms).

pub fn max_delay(self, delay: Duration) -> Self

The longest backoff delay, also the cap on Retry-After (default 8 s).

pub fn max_retries(&self) -> usize

The number of retries allowed.

Trait Implementations

impl Clone for RetryPolicy

fn clone(&self) -> Self

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

Three retries.

fn default() -> Self

Returns the “default value” for a type.

impl<B> Policy<Request<Body>, Response<B>, Box<dyn Error + Send + Sync>> for RetryPolicy

type Future = Pin<Box<dyn Future<Output = ()> + Send>>

The Future type returned by Policy::retry.

fn retry( &mut self, _request: &mut Request<Body>, result: &mut Result<Response<B>, BoxError>, ) -> Option<Self::Future>

Check the policy if a certain request should be retried.

fn clone_request(&mut self, request: &Request<Body>) -> Option<Request<Body>>

Tries to clone a request before being passed to the inner service.