Enum StorageError 

pub enum StorageError {
    NotFound,
    AccessDenied,
    QuotaExceeded,
    Backend(String),
}

Errors a storage backend can return.

Kept as a flat enum so the shape is stable across backends. Callers branch on the variant to map to HTTP status codes (e.g. 404 / 403 / 413 / 500) without having to parse a message string.

Variants

NotFound

Key not found. Maps to HTTP 404 in the usual caller pattern. Returned by get, delete, and presigned_url for non-existent keys; list_page returns an empty page instead of NotFound.

AccessDenied

Authentication / authorization failure. Maps to HTTP 403. Covers both “wrong credentials” and “credentials valid but not allowed to touch this key”.

QuotaExceeded

Backend rejected the operation because a quota (object size, request rate, per-bucket ceiling) was exceeded. Maps to HTTP 413 when the caller is surfacing this to a user — an upload that was too big.

Backend(String)

Transport / storage layer failure (network, disk, provider 5xx, malformed response, SDK error). Maps to HTTP 500. The wrapped message is for logs, not for users.

Trait Implementations

impl Clone for StorageError

fn clone(&self) -> StorageError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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.