Struct PutObjectRequest 

pub struct PutObjectRequest<'a> { /* private fields */ }

Builder for constructing S3 PUT object requests with custom options

Example

use s3::bucket::Bucket;
use s3::creds::Credentials;
use anyhow::Result;

let bucket = Bucket::new("my-bucket", "us-east-1".parse()?, Credentials::default()?)?;

// Upload with custom headers using builder pattern
let response = bucket.put_object_builder("/my-file.txt", b"Hello, World!")
    .with_content_type("text/plain")
    .with_cache_control("public, max-age=3600")?
    .with_content_encoding("gzip")?
    .execute()
    .await?;

Implementations

impl<'a> PutObjectRequest<'a>

pub fn with_content_type<S: AsRef<str>>(self, content_type: S) -> Self

Set the Content-Type header

pub fn with_cache_control<S: AsRef<str>>( self, cache_control: S, ) -> Result<Self, S3Error>

Set the Cache-Control header

pub fn with_content_encoding<S: AsRef<str>>( self, encoding: S, ) -> Result<Self, S3Error>

Set the Content-Encoding header

pub fn with_content_disposition<S: AsRef<str>>( self, disposition: S, ) -> Result<Self, S3Error>

Set the Content-Disposition header

pub fn with_expires<S: AsRef<str>>(self, expires: S) -> Result<Self, S3Error>

Set the Expires header

pub fn with_header<V>(self, key: &str, value: V) -> Result<Self, S3Error>

where V: AsRef<str>,

Add a custom header

pub fn with_headers(self, headers: HeaderMap) -> Self

Add multiple custom headers (already validated HeaderMap)

pub fn with_metadata<K: AsRef<str>, V: AsRef<str>>( self, key: K, value: V, ) -> Result<Self, S3Error>

Add S3 metadata header (x-amz-meta-*)

pub fn with_storage_class<S: AsRef<str>>( self, storage_class: S, ) -> Result<Self, S3Error>

Add x-amz-storage-class header

pub fn with_server_side_encryption<S: AsRef<str>>( self, encryption: S, ) -> Result<Self, S3Error>

Add x-amz-server-side-encryption header

pub async fn execute(self) -> Result<ResponseData, S3Error>

Execute the PUT request

Trait Implementations

impl<'a> Clone for PutObjectRequest<'a>

fn clone(&self) -> PutObjectRequest<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for PutObjectRequest<'a>

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

Formats the value using the given formatter.