pub struct BehaviorVersion { /* private fields */ }client only.Expand description
Behavior version of the client
Over time, new best-practice behaviors are introduced. However, these behaviors might not be backwards compatible. For example, a change which introduces new default timeouts or a new retry-mode for all operations might be the ideal behavior but could break existing applications.
Implementations§
Source§impl BehaviorVersion
impl BehaviorVersion
Sourcepub fn latest() -> Self
pub fn latest() -> Self
This method will always return the latest major version.
This is the recommend choice for customers who aren’t reliant on extremely specific behavior characteristics. For example, if you are writing a CLI app, the latest behavior major version is probably the best setting for you.
If, however, you’re writing a service that is very latency sensitive, or that has written code to tune Rust SDK behaviors, consider pinning to a specific major version.
The latest version is currently BehaviorVersion::v2026_11_17
Sourcepub fn v2026_11_17() -> Self
pub fn v2026_11_17() -> Self
Behavior version for November 17th, 2026.
This version applies a default read timeout to AWS SDK clients. The read timeout bounds the span from request dispatch until response headers arrive, which is where an unresponsive peer would otherwise leave a request hanging until the operating system gives up.
The value depends on the service: 5 minutes generally, 15 minutes for services that legitimately hold a connection open before replying, and no timeout at all for services where any bound would break normal usage — a large upload cannot produce response headers until the whole body has been sent, for instance, so S3 applies none.
This bounds only the wait for response headers. It does not bound a transfer that has started and then stalls; stalled stream protection already covers that.
A read_timeout you configure yourself always wins, whether it is longer, shorter, or
disabled, and whether you set it on the client or per operation. To keep the previous
behavior for every service, pin to an earlier behavior version.
For more information about behavior versions and how they affect SDK behavior, see the AWS SDK for Rust Developer Guide.
Sourcepub fn v2026_11_10() -> Self
👎Deprecated since 1.22.0: Superseded by v2026_11_17, which applies a default read timeout to AWS SDK clients.
pub fn v2026_11_10() -> Self
Superseded by v2026_11_17, which applies a default read timeout to AWS SDK clients.
Behavior version for November 10th, 2026.
This version updates retry behavior per the Retry Behavior 2.1 spec:
- Non-throttling errors use 50ms base backoff (previously 1s)
- Token bucket costs: 14 for non-throttling, 5 for throttling (previously 5/10)
- HTTP 5xx status codes no longer trigger connection poisoning
x-amz-retry-afterheader bounded between exponential backoff and 5s above it
Sourcepub fn v2026_01_12() -> Self
👎Deprecated since 1.20.0: Superseded by v2026_11_10, which updates retry behavior per the Retry Behavior 2.1 spec.
pub fn v2026_01_12() -> Self
Superseded by v2026_11_10, which updates retry behavior per the Retry Behavior 2.1 spec.
Behavior version for January 12th, 2026.
This version enables retries by default for AWS SDK clients. Generic Smithy clients (non-AWS) do not have retries enabled by default.
Additionally, this version sets a 3.1 second connect timeout for all clients.
For more information about behavior versions and how they affect SDK behavior, see the AWS SDK for Rust Developer Guide.
Sourcepub fn v2025_08_07() -> Self
👎Deprecated since 1.10.0: Superseded by v2026_01_12, which enables retries by default for AWS SDK clients and sets a 3.1s connect timeout for all clients.
pub fn v2025_08_07() -> Self
Superseded by v2026_01_12, which enables retries by default for AWS SDK clients and sets a 3.1s connect timeout for all clients.
Behavior version for August 7th, 2025.
This version updates the default HTTPS client to support proxy environment variables
(e.g. HTTP_PROXY, HTTPS_PROXY, NO_PROXY) by default.
Sourcepub fn v2025_01_17() -> Self
👎Deprecated since 1.9.0: Superseded by v2025_08_07, which enables automatic HTTP(S) proxy support from environment variables in the default HTTPS client.
pub fn v2025_01_17() -> Self
Superseded by v2025_08_07, which enables automatic HTTP(S) proxy support from environment variables in the default HTTPS client.
Behavior version for January 17th, 2025
This version updates the default HTTP client and TLS stack. SDKs shipped with a pre 1.x version of hyper and rustls originally. This behavior version updates the HTTP+TLS stack to maintained versions.
Sourcepub fn v2024_03_28() -> Self
👎Deprecated since 1.8.0: Superseded by v2025_01_17, which updates the default HTTPS client stack.
pub fn v2024_03_28() -> Self
Superseded by v2025_01_17, which updates the default HTTPS client stack.
Behavior version for March 28th, 2024.
This version enables stalled stream protection for uploads (request bodies) by default.
When a new behavior major version is released, this method will be deprecated.
Sourcepub fn v2023_11_09() -> Self
👎Deprecated since 1.4.0: Superseded by v2024_03_28, which enabled stalled stream protection for uploads (request bodies) by default.
pub fn v2023_11_09() -> Self
Superseded by v2024_03_28, which enabled stalled stream protection for uploads (request bodies) by default.
Behavior version for November 9th, 2023.
Sourcepub fn is_at_least(&self, other: BehaviorVersion) -> bool
pub fn is_at_least(&self, other: BehaviorVersion) -> bool
True if this version is newer or equal to the given other version.
Trait Implementations§
Source§impl Clone for BehaviorVersion
impl Clone for BehaviorVersion
impl Copy for BehaviorVersion
Source§impl Debug for BehaviorVersion
impl Debug for BehaviorVersion
Source§impl PartialEq for BehaviorVersion
impl PartialEq for BehaviorVersion
impl StructuralPartialEq for BehaviorVersion
Auto Trait Implementations§
impl Forget for BehaviorVersion
impl Freeze for BehaviorVersion
impl Move for BehaviorVersion
impl RefUnwindSafe for BehaviorVersion
impl Send for BehaviorVersion
impl Sync for BehaviorVersion
impl Unpin for BehaviorVersion
impl UnsafeUnpin for BehaviorVersion
impl UnwindSafe for BehaviorVersion
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more