Struct ManagedMultipartUploadRequest 

pub struct ManagedMultipartUploadRequest {
    pub headers: ManagedMultipartHeaders,
    /* private fields */
}

Request for a bounded, automatically cleaned-up multipart upload.

In-memory sources retain the caller’s complete byte buffer for the duration of the operation. File sources retain at most the derived in-flight part byte bound in memory; their immutable snapshot is disk-backed.

Fields

headers: ManagedMultipartHeaders

Phase-specific additional headers. Values are signed and repeated values are preserved. Generated-name collisions are errors; signing- and transport-owned headers are rejected.

Implementations

impl ManagedMultipartUploadRequest

pub fn from_bytes(key: ObjectKey, bytes: impl Into<Bytes>) -> Self

Constructs a request with a replayable in-memory body.

pub fn from_path(key: ObjectKey, path: impl AsRef<Path>) -> Self

Constructs a request with a replayable regular-file body.

The file is copied into a private disk-backed snapshot before S3 creates the multipart upload, so later changes to the source path have no effect.

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

Replaces the upload’s phase-specific additional headers.

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

Sets the object’s media type.

pub fn with_metadata( self, name: impl Into<String>, value: impl Into<String>, ) -> Self

Adds user-defined object metadata.

pub fn with_options(self, options: MultipartOptions) -> Self

Applies validated resource and time bounds to this upload.

pub fn with_checksum_algorithm( self, algorithm: ChecksumAlgorithm, ) -> Result<Self, ChecksumCalculationError>

Calculates and sends this checksum for every uploaded part.

Errors

Returns an error when local calculation is unavailable for the selected algorithm. SHA-1 may still be supplied through primitive multipart APIs.

pub const fn options(&self) -> MultipartOptions

Returns this upload’s resource and time bounds.

pub const fn key(&self) -> &ObjectKey

Returns the destination object key.

Trait Implementations

impl Debug for ManagedMultipartUploadRequest

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

Formats the value using the given formatter.