Struct S3OriginConfig 

pub struct S3OriginConfig {
    pub bucket: String,
    pub region: String,
    pub endpoint_url: Option<String>,
    pub path_style: Option<bool>,
    pub prefix: Option<String>,
    pub credentials: Option<S3Credentials>,
    pub decompress: Option<DecompressMode>,
}

S3-compatible origin configuration (#437) — wire form.

Validation runs at config-resolution time via the (private) resolve_s3_origin helper, which produces the runtime form super::resolved::ResolvedS3Config. Unvalidated instances of this type cannot reach the cache wiring layer because super::resolved::ResolvedOrigin::S3 holds the resolved form, not this one.

Fields

bucket: String

Bucket name. Validated DNS-safe at config resolution (lowercase [a-z0-9.-], 3–63 chars; see validate_s3_bucket_name).

region: String

AWS region (e.g. "us-east-1"). Required because the S3 SDK uses it for SigV4 signing even when a custom endpoint_url is set. Validated non-empty at config resolution.

endpoint_url: Option<String>

Custom endpoint URL for non-AWS S3-compatible providers (R2, B2, MinIO). Omit for AWS S3. Validated as http/https at config resolution.

path_style: Option<bool>

Use path-style addressing (https://endpoint/bucket/key) instead of virtual-hosted-style (https://bucket.endpoint/key). Required true for MinIO and many self-hosted providers; AWS S3 and Cloudflare R2 use virtual-hosted-style by default. Absent => fall back to the SDK default (virtual-hosted-style).

prefix: Option<String>

Optional key prefix prepended to every fetched object. Final key is {prefix}{hex[0..2]}/{hex}. Validation rejects prefix starting with /, containing .., containing backslash, or containing ASCII control / whitespace characters; auto-appends a trailing / if the prefix is non-empty and missing one (mirrors parse_origin_url’s trailing-slash normalization).

credentials: Option<S3Credentials>

Credential source. Absent => use the AWS default credential chain (env vars, ~/.aws/credentials, IAM role / instance profile).

decompress: Option<DecompressMode>

How to handle Content-Encoding on the S3 response (#804). "auto" (default) decompresses gzip/zstd transparently; "strict" refuses any non-identity encoding. The BLAKE3 content-address is computed over the canonical (decompressed) form, so "strict" is only safe for origins guaranteed to serve already-canonical bytes. Mirrors the HTTP origin’s decompress knob.

Trait Implementations

impl Clone for S3OriginConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for S3OriginConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for S3OriginConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for S3OriginConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.