Struct CopyOptions 

pub struct CopyOptions {
    pub if_not_exists: bool,
    pub if_match: Option<String>,
    pub source_content_length_hint: Option<u64>,
    pub concurrent: usize,
    pub chunk: Option<usize>,
}

Options for copy operations.

Fields

if_not_exists: bool

Sets the condition that copy operation will succeed only if target does not exist.

Capability

Check [Capability::copy_with_if_not_exists] before using this feature.

Behavior

• If supported, the copy operation will only succeed if the target path does not exist
• Will return error if target already exists
• If not supported, the value will be ignored

This operation provides a way to ensure copy operations only create new resources without overwriting existing ones, useful for implementing “copy if not exists” logic.

if_match: Option<String>

Sets the condition that copy operation will succeed only if the destination currently has the given ETag.

Capability

Check [Capability::copy_with_if_match] before using this feature.

Behavior

• If supported, the copy operation will only succeed when the existing destination object’s ETag matches the given value.

source_content_length_hint: Option<u64>

Known content length of the source object.

This is an execution hint that allows OpenDAL to avoid extra metadata requests while planning copy operations. It must not be used as an object identity or consistency condition.

concurrent: usize

Sets concurrent copy operations for this copier.

This is a best-effort execution option. Services that cannot split copy into concurrent server-side tasks can ignore it.

chunk: Option<usize>

Sets chunk size for segmented copy operations.

Capability

Check [Capability::copy_can_multi], [Capability::copy_multi_min_size] and [Capability::copy_multi_max_size] before using this feature.

This is a best-effort execution option. Services that support server-side segmented copy can use it as the target size for each copy step. Services that cannot split copy operations can ignore it.

Trait Implementations

impl Clone for CopyOptions

fn clone(&self) -> CopyOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CopyOptions

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

Formats the value using the given formatter.

impl Default for CopyOptions

fn default() -> CopyOptions

Returns the “default value” for a type.

impl From<CopyOptions> for (OpCopy, OpCopier)

fn from(value: CopyOptions) -> Self

Converts to this type from the input type.

impl PartialEq for CopyOptions

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for CopyOptions

impl StructuralPartialEq for CopyOptions