Enum S3CopyIfNotExists 

#[non_exhaustive]
pub enum S3CopyIfNotExists {
    Header(String, String),
    HeaderWithStatus(String, String, StatusCode),
    Multipart,
}

Available on crate feature aws-base only.

Configure how to provide CopyMode::Create for AmazonS3.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Header(String, String)

Some S3-compatible stores, such as Cloudflare R2, support copy if not exists semantics through custom headers.

If set, CopyMode::Create will perform a normal copy operation with the provided header pair, and expect the store to fail with 412 Precondition Failed if the destination file already exists.

Encoded as header:<HEADER_NAME>:<HEADER_VALUE> ignoring whitespace

For example header: cf-copy-destination-if-none-match: *, would set the header cf-copy-destination-if-none-match to *

HeaderWithStatus(String, String, StatusCode)

The same as S3CopyIfNotExists::Header but allows custom status code checking, for object stores that return values other than 412.

Encoded as header-with-status:<HEADER_NAME>:<HEADER_VALUE>:<STATUS> ignoring whitespace

Multipart

Native Amazon S3 supports copy if not exists through a multipart upload where the upload copies an existing object and is completed only if the new object does not already exist.

WARNING: When using this mode, copy_if_not_exists does not copy tags or attributes from the source object.

WARNING: When using this mode, copy_if_not_exists makes only a best effort attempt to clean up the multipart upload if the copy operation fails. Consider using a lifecycle rule to automatically clean up abandoned multipart uploads. See the module docs for details.

Encoded as multipart ignoring whitespace.

Trait Implementations

impl Clone for S3CopyIfNotExists

fn clone(&self) -> S3CopyIfNotExists

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for S3CopyIfNotExists

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

Formats the value using the given formatter.

impl Display for S3CopyIfNotExists

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

Formats the value using the given formatter.

impl Eq for S3CopyIfNotExists

impl PartialEq for S3CopyIfNotExists

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for S3CopyIfNotExists