Enum ObjectStoreError 

pub enum ObjectStoreError {
    Io(Error),
    InvalidConfig(String),
    NotFound(Path),
    TooLarge {
        key: Path,
        size: u64,
        max_bytes: u64,
    },
    AlreadyExists(Path),
    Precondition {
        key: Path,
        reason: String,
    },
    Backend(String),
}

Errors raised by the object-store substrate.

Variants

Io(Error)

A local-filesystem I/O failure, for example during a read of a segment file to upload.

InvalidConfig(String)

The backend builder rejected the config: a bad bucket, region, endpoint, or credential.

NotFound(Path)

A specific object was not found. The variant is structured, so consumers can upgrade it to their own domain error without string matching.

TooLarge

An object exceeded a caller-supplied size cap during a buffered read. This guards against OOM on a corrupt or malicious oversized object.

Fields

key: Path

The object that breached the cap.

size: u64

The metadata size or the bytes observed when streaming exceeded the cap.

max_bytes: u64

The cap in bytes.

AlreadyExists(Path)

A conditional create (PutMode::Create) found an object already at the key.

Precondition

A conditional read or write’s precondition did not hold.

Fields

key: Path

The object whose precondition was evaluated.

reason: String

Why the backend rejected the operation.

Backend(String)

Any other backend error. The error becomes a string, so the public surface stays stable.

Trait Implementations

impl Debug for ObjectStoreError

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

Formats the value using the given formatter.

impl Display for ObjectStoreError

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

Formats the value using the given formatter.

impl Error for ObjectStoreError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

impl From<Error> for ObjectStoreError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ObjectStoreError

fn from(err: Error) -> Self

Converts to this type from the input type.