Struct S3Store 

pub struct S3Store {
    pub bucket: String,
    pub region: String,
    pub endpoint: Option<String>,
    pub access_key: String,
    pub secret_key: String,
}

AWS S3-compatible object store stub.

Full HTTP/SigV4 implementation requires the aws-sdk-s3 feature. Without that feature, all operations return IoError::Other("s3 feature not enabled").

Fields

bucket: String

Target bucket name.

region: String

AWS region (e.g. "us-east-1").

endpoint: Option<String>

Optional custom endpoint (for S3-compatible services).

access_key: String

AWS access key ID.

secret_key: String

AWS secret access key.

Implementations

impl S3Store

pub fn new( bucket: impl Into<String>, region: impl Into<String>, access_key: impl Into<String>, secret_key: impl Into<String>, ) -> Self

Create a new S3 store configuration.

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

Set a custom endpoint URL (e.g. for MinIO).

Trait Implementations

impl ObjectStore for S3Store

fn put(&self, key: &ObjectKey, _data: &[u8]) -> Result<()>

Store data under key, overwriting any existing object.

fn get(&self, key: &ObjectKey) -> Result<Vec<u8>>

Retrieve the object stored under key.

fn delete(&self, key: &ObjectKey) -> Result<()>

Delete the object at key. Returns Ok(()) if the key does not exist.

fn list(&self, prefix: &str) -> Result<Vec<ObjectMetadata>>

List all keys whose URI starts with prefix.

fn head(&self, key: &ObjectKey) -> Result<ObjectMetadata>

Return metadata for a single object without downloading its content.

fn exists(&self, key: &ObjectKey) -> bool

Check whether an object exists.

fn copy(&self, src: &ObjectKey, dst: &ObjectKey) -> Result<()>

Copy an object from src to dst within the same store.

fn rename(&self, src: &ObjectKey, dst: &ObjectKey) -> Result<()>

Rename/move an object from src to dst.