Struct BehaviorVersion

pub struct BehaviorVersion { /* private fields */ }

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

impl BehaviorVersion

pub fn latest() -> BehaviorVersion

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::v2025_01_17

pub fn v2025_01_17() -> BehaviorVersion

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.

NOTE: In a future release behavior versions prior to this will require enabling feature flags manually to keep the legacy Hyper stack as the default. Specifically the `aws-smithy-runtime/tls-rustls` feature flag combined with an older behavior version.

pub fn v2024_03_28() -> BehaviorVersion

👎Deprecated since 1.8.0: 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.

pub fn v2023_11_09() -> BehaviorVersion

👎Deprecated since 1.4.0: Superseded by v2024_03_28, which enabled stalled stream protection for uploads (request bodies) by default.

Behavior version for November 9th, 2023.

pub fn is_at_least(&self, other: BehaviorVersion) -> bool

True if this version is newer or equal to the given other version.

Trait Implementations

impl Clone for BehaviorVersion

fn clone(&self) -> BehaviorVersion

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for BehaviorVersion

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

Formats the value using the given formatter.

impl PartialEq for BehaviorVersion

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for BehaviorVersion

impl StructuralPartialEq for BehaviorVersion