Struct PartSize 

pub struct PartSize(/* private fields */);

Represents a valid part size for S3 multipart uploads.

PartSize ensures that the size of each part used in multipart uploads is within the allowed range defined by S3. The size must be at least 5 MB and at most 5 GB.

Constants

• MIN_PART_SIZE: The minimum allowed part size (5 MB).
• MAX_PART_SIZE: The maximum allowed part size (5 GB).

Trait Implementations

impl AsRef<i64> for PartSize

fn as_ref(&self) -> &i64

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for PartSize

fn clone(&self) -> PartSize

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PartSize

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

Formats the value using the given formatter.

impl Default for PartSize

The default size of a block for S3 multipart copy operations, set to 50 MiB.

Why 50 MiB?

• Balance: Optimizes between throughput and the number of API calls.
• S3 Limits: Fits within S3’s part size requirements (min 5 MiB, max 5 TB).
• Parallelism: Allows efficient parallel uploads, speeding up the copy process.
• Error Handling: Facilitates easier retries of failed parts without re-uploading the entire object.

This size ensures efficient, cost-effective, and reliable multipart copy operations.

Note

While 50 MiB is a good default for many use cases, it might not be suitable for all operations. Adjust the part size based on your specific requirements and constraints.

fn default() -> Self

Returns the “default value” for a type.

impl<'__derive_more_into> From<&'__derive_more_into PartSize> for &'__derive_more_into i64

fn from(value: &'__derive_more_into PartSize) -> Self

Converts to this type from the input type.

impl<'__derive_more_into> From<&'__derive_more_into mut PartSize> for &'__derive_more_into mut i64

fn from(value: &'__derive_more_into mut PartSize) -> Self

Converts to this type from the input type.

impl From<PartSize> for i64

fn from(value: PartSize) -> Self

Converts to this type from the input type.

impl TryFrom<i64> for PartSize

Attempts to create a PartSize from an i64 value.

The TryFrom<i64> implementation for PartSize ensures that the given value is within the allowed range for S3 multipart upload part sizes. If the value is within the range, it returns Ok(PartSize). Otherwise, it returns an appropriate PartSizeError.

Errors

• Returns PartSizeError::TooSmall if the value is smaller than MIN_PART_SIZE.
• Returns PartSizeError::TooLarge if the value is larger than MAX_PART_SIZE.

type Error = PartSizeError

The type returned in the event of a conversion error.

fn try_from(value: i64) -> Result<Self, Self::Error>

Performs the conversion.