Module aws_smithy_runtime_api::client::retries::classifiers

source ·
Available on crate feature client only.
Expand description

Classifiers for determining if a retry is necessary and related code.

When a request fails, a retry strategy should inspect the result with retry classifiers to understand if and how the request should be retried.

Because multiple classifiers are often used, and because some are more specific than others in what they identify as retryable, classifiers are run in a sequence that is determined by their priority.

Classifiers that are higher priority are run after classifiers with a lower priority. The intention is that:

  1. Generic classifiers that look at things like the HTTP error code run first.
  2. More specific classifiers such as ones that check for certain error messages are run after the generic classifiers. This gives them the ability to override the actions set by the generic retry classifiers.

Put another way:

large nets target common failures with basic behaviorrun beforesmall nets target specific failures with special behavior
low priority classifiersresults overridden byhigh priority classifiers

Structs§

  • The priority of a retry classifier. Classifiers with a higher priority will run after classifiers with a lower priority and may override their result. Classifiers with equal priorities make no guarantees about which will run first.
  • Retry classifier used by the retry strategy to classify responses as retryable or not.

Enums§

Traits§