Struct aws_config::RetryConfig

#[non_exhaustive]
pub struct RetryConfig { /* private fields */ }

Retry configuration for requests.

Implementations

impl RetryConfig

pub fn new() -> RetryConfig

Creates a default RetryConfig with RetryMode::Standard and max attempts of three.

pub fn disabled() -> RetryConfig

Creates a RetryConfig that has retries disabled.

pub fn with_retry_mode(self, retry_mode: RetryMode) -> RetryConfig

Set this config’s retry mode.

pub fn with_max_attempts(self, max_attempts: u32) -> RetryConfig

Set the maximum number of times a request should be tried, including the initial attempt. This value must be greater than zero.

pub fn with_initial_backoff(self, initial_backoff: Duration) -> RetryConfig

Set the multiplier used when calculating backoff times as part of an exponential backoff with jitter strategy. Most services should work fine with the default duration of 1 second, but if you find that your requests are taking too long due to excessive retry backoff, try lowering this value.

Example

For a request that gets retried 3 times, when initial_backoff is 1 seconds:

• the first retry will occur after 0 to 1 seconds
• the second retry will occur after 0 to 2 seconds
• the third retry will occur after 0 to 4 seconds

For a request that gets retried 3 times, when initial_backoff is 30 milliseconds:

• the first retry will occur after 0 to 30 milliseconds
• the second retry will occur after 0 to 60 milliseconds
• the third retry will occur after 0 to 120 milliseconds

pub fn mode(&self) -> RetryMode

Returns the retry mode.

pub fn max_attempts(&self) -> u32

Returns the max attempts.

pub fn initial_backoff(&self) -> Duration

Returns the backoff multiplier duration.

Trait Implementations

impl Clone for RetryConfig

fn clone(&self) -> RetryConfig

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RetryConfig

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

Formats the value using the given formatter.

impl Default for RetryConfig

fn default() -> RetryConfig

Returns the “default value” for a type.

impl PartialEq<RetryConfig> for RetryConfig

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl StructuralPartialEq for RetryConfig