Enum StorageError 

pub enum StorageError {
    NotFound {
        key: String,
    },
    BucketNotFound {
        bucket: String,
    },
    BackendUnavailable {
        message: String,
    },
    Other {
        source: Box<dyn Error + Send + Sync>,
    },
    NotModified,
    PreconditionFailed,
    RangeNotSatisfiable {
        complete_length: u64,
    },
}

Storage-layer error — distinct from Error so that different backends (S3, in-memory mock, future prefix-per-KB) share a stable failure surface.

Variants

NotFound

The requested object was not found in storage.

Fields

key: String

The key of the missing object.

BucketNotFound

The storage bucket for the KB was not found.

Fields

bucket: String

The bucket name that was not found.

BackendUnavailable

The storage backend is temporarily unavailable.

Fields

message: String

The underlying error message from the backend.

Other

An unexpected storage error. The inner error provides details.

Fields

source: Box<dyn Error + Send + Sync>

The root cause.

NotModified

S3 backend returned 304 Not Modified.

PreconditionFailed

S3 backend returned 412 Precondition Failed.

RangeNotSatisfiable

S3 backend returned 416 Range Not Satisfiable. complete_length is the total object size extracted from the Content-Range: bytes */N header in the error response.

Fields

complete_length: u64

The total size of the object in bytes.

Implementations

impl StorageError

pub fn is_not_found(&self) -> bool

Returns true if this error represents a missing object or bucket.

Trait Implementations

impl Debug for StorageError

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

Formats the value using the given formatter.

impl Display for StorageError

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

Formats the value using the given formatter.

impl Error for StorageError

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<StorageError> for Error

fn from(err: StorageError) -> Self

Converts to this type from the input type.