Struct InitiateMultipartBuilder 

pub struct InitiateMultipartBuilder { /* private fields */ }

A builder for initiating a multipart upload.

Implementations

impl InitiateMultipartBuilder

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

Sets an explicit object key.

If a key is specified, the object will be stored under that key. Otherwise, the Objectstore server will automatically assign a random key, which is then returned from this request.

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

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

IMPORTANT: unlike single-object uploads, the client does not automatically compress the contents of MultipartUpload::put/MultipartUpload::put_stream based on the configured compression. The caller is responsible to compress the payload in accordance with the configured compression.

By default, the compression algorithm set on this Session’s Usecase is used.

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

Sets the expiration policy of the object to be uploaded.

By default, the expiration policy set on this Session’s Usecase is used.

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

Sets the content type of the object to be uploaded.

You can use the utility function crate::utils::guess_mime_type to attempt to guess a content_type based on magic bytes.

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

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

This is an optional but encouraged field that tracks where the payload was originally obtained from. For example, the IP address of the Sentry SDK or CLI that uploaded the data.

Example

session.initiate_multipart_upload()
    .origin("203.0.113.42")
    .send()
    .await
    .unwrap();

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

Sets the custom metadata to the provided map.

It will clear any previously set metadata.

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

Appends the key/value to the custom metadata of this object.

pub async fn send(self) -> Result<MultipartUpload>

Sends the initiate request and returns a MultipartUpload handle.

Trait Implementations

impl Debug for InitiateMultipartBuilder

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

Formats the value using the given formatter.