Struct S3Config 

pub struct S3Config {

    pub bucket: String,
    pub prefix: Option<String>,
    pub region: String,
    pub endpoint: Option<String>,
    pub access_key_id: Option<String>,
    pub secret_access_key: Option<String>,
    pub allow_http: bool,
    pub multipart_threshold: u64,
    pub multipart_chunk_size: usize,
    pub conditional_put: bool,
    pub checksum_sha256: bool,
    pub max_retries: usize,
    pub retry_timeout: Duration,
    pub request_timeout: Duration,
    pub connect_timeout: Duration,
}

Connection and bucket parameters for an S3-compatible backend.

The credentials come either from access_key_id and secret_access_key or from the standard AWS credential chain. When both fields are None, object_store falls back to the environment-variable chain.

Debug redacts the credential fields, so a stray {:?} call or tracing call never leaks them.

Fields

bucket: String

S3 bucket name.

prefix: Option<String>

Optional key prefix inside the bucket. No leading slash and no trailing slash.

region: String

AWS region. AWS S3 requires it. Use the placeholder "us-east-1" for MinIO and R2.

endpoint: Option<String>

Optional custom endpoint URL, for example http://minio:9000 or an R2 endpoint.

access_key_id: Option<String>

Optional explicit access key id. Without it, the backend falls back to the AWS credential chain.

secret_access_key: Option<String>

Optional explicit secret access key. Without it, the backend falls back to the AWS credential chain.

allow_http: bool

Allow plaintext HTTP. MinIO without TLS requires it.

multipart_threshold: u64

Files of at least this size upload with multipart. Defaults to DEFAULT_MULTIPART_THRESHOLD.

multipart_chunk_size: usize

Per-part size for multipart. Defaults to DEFAULT_MULTIPART_CHUNK_SIZE.

conditional_put: bool

Enable conditional puts (If-None-Match) so a PutMode::Create write fails instead of silently overwriting. Defaults to true.

checksum_sha256: bool

Send x-amz-checksum-sha256 so the server verifies each object on ingest. Defaults to true.

max_retries: usize

How many times one request is retried before the error surfaces. Defaults to [DEFAULT_MAX_RETRIES]; 0 disables retries.

retry_timeout: Duration

Ceiling on the wall-clock time one request may spend across all of its retries. Defaults to [DEFAULT_RETRY_TIMEOUT].

request_timeout: Duration

Ceiling on one HTTP request. Defaults to [DEFAULT_REQUEST_TIMEOUT].

connect_timeout: Duration

Ceiling on the connect phase alone. Defaults to [DEFAULT_CONNECT_TIMEOUT].

Trait Implementations

impl Clone for S3Config

fn clone(&self) -> S3Config

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for S3Config

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

Formats the value using the given formatter.

impl Default for S3Config

fn default() -> S3Config

Returns the “default value” for a type.

impl Eq for S3Config

impl PartialEq for S3Config

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for S3Config