Struct UploadId 

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

An opaque, validated multipart upload identifier issued by an S3 service.

Upload identifiers may grant the ability to add parts to or abort an in-progress upload. Formatting therefore always redacts the value; use UploadId::as_str or UploadId::expose when the wire value is needed.

Implementations

impl UploadId

pub const MAX_LENGTH: usize = 2_048

Maximum accepted UTF-8 byte length for an upload identifier.

S3 treats this value as opaque. The bound prevents untrusted service responses from becoming unbounded query parameters while leaving ample room for identifiers produced by S3-compatible implementations.

pub fn new(value: impl Into<String>) -> Result<Self, UploadIdError>

Validates and stores an upload identifier.

pub fn expose(&self) -> &str

Explicitly exposes the identifier for protocol and query construction.

pub fn as_str(&self) -> &str

Returns the identifier for protocol and query construction.

Trait Implementations

impl Clone for UploadId

fn clone(&self) -> UploadId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UploadId

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

Formats the value using the given formatter.

impl Display for UploadId

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

Formats the value using the given formatter.

impl Eq for UploadId

impl FromStr for UploadId

type Err = UploadIdError

The associated error which can be returned from parsing.

fn from_str(value: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for UploadId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for UploadId

fn cmp(&self, other: &UploadId) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for UploadId

fn eq(&self, other: &UploadId) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for UploadId

fn partial_cmp(&self, other: &UploadId) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for UploadId

impl TryFrom<String> for UploadId

type Error = UploadIdError

The type returned in the event of a conversion error.

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

Performs the conversion.