Struct S3ConfigBuilder 

pub struct S3ConfigBuilder { /* private fields */ }

Builder for S3Config.

Implementations

impl S3ConfigBuilder

pub fn endpoint(self, endpoint: Endpoint) -> Self

Sets a custom endpoint. HTTP endpoints still require explicit opt-in.

pub fn region(self, region: impl Into<String>) -> Self

Sets the SigV4 signing region.

pub fn bucket(self, bucket: impl Into<String>) -> Self

Sets the target bucket.

pub fn addressing_style(self, style: AddressingStyle) -> Self

Sets the bucket addressing style.

pub fn allow_http_for_local_testing(self) -> Self

Explicitly permits plain HTTP for local S3-compatible testing.

This does not disable TLS verification for HTTPS endpoints and should not be enabled for endpoints reached over an untrusted network.

pub fn connect_timeout(self, timeout: Duration) -> Self

Sets the connection-establishment timeout.

pub fn attempt_timeout(self, timeout: Duration) -> Self

Sets the timeout for each individual request attempt.

pub fn operation_timeout(self, timeout: Duration) -> Self

Sets the overall timeout for one primitive S3 operation across retries.

Managed multipart uploads instead use the transfer and cleanup deadlines in crate::MultipartOptions.

pub fn idle_body_timeout(self, timeout: Duration) -> Self

Sets the maximum idle period while streaming a response body.

pub fn max_xml_response_size(self, bytes: usize) -> Self

Sets the maximum XML response body size.

pub fn max_error_response_size(self, bytes: usize) -> Self

Sets the maximum error response body size.

pub fn retry_policy(self, policy: RetryPolicy) -> Self

Sets the retry policy.

pub fn user_agent(self, user_agent: impl Into<String>) -> Self

Sets the HTTP user-agent value.

pub fn credentials_provider( self, provider: Arc<dyn CredentialsProvider>, ) -> Self

Sets the asynchronous credential provider.

pub fn observer(self, observer: Arc<dyn RequestObserver>) -> Self

Installs a dependency-free observer for sanitized request lifecycle events.

pub fn build(self) -> Result<S3Config, S3Error>

Validates and creates the configuration.

Trait Implementations

impl Default for S3ConfigBuilder

fn default() -> Self

Returns the “default value” for a type.