Struct CreateResumableUploadBuilder 

pub struct CreateResumableUploadBuilder { /* private fields */ }

A builder for Session::create_upload.

Implementations

impl CreateResumableUploadBuilder

pub fn key(self, key: impl Into<ObjectKey>) -> Self

Sets an explicit object key instead of asking the server to generate one.

pub fn content_type(self, content_type: impl Into<Cow<'static, str>>) -> Self

Sets the object’s content type.

pub fn expiration_policy(self, expiration_policy: ExpirationPolicy) -> Self

Sets the object’s expiration policy.

pub fn compression(self, compression: impl Into<Option<Compression>>) -> Self

Sets the compression algorithm recorded in this object’s metadata.

Unlike regular uploads, the client does not automatically compress chunk contents. The caller must pre-compress the object according to compression, then create the upload with the post-compression object_length. Offsets similarly refer to the bytes after compression.

By default, no compression is set.

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

Sets the origin of the object, typically the IP address of the original source.

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

Sets the filename recorded for the object.

pub fn set_metadata(self, metadata: impl Into<BTreeMap<String, String>>) -> Self

Replaces all custom metadata for the object.

pub fn append_metadata( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Adds or replaces one custom metadata entry.

pub async fn send(self) -> Result<Option<ResumableUpload>>

Creates the resumable upload and returns a handle bound to it.

Returns None when the server declines resumable uploads for this object. Callers should fall back to a regular Session::put in that case.

Trait Implementations

impl Debug for CreateResumableUploadBuilder

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

Formats the value using the given formatter.