Enum ObjectStoreError 

#[non_exhaustive]
pub enum ObjectStoreError {
    NotFound {
        object_key: String,
    },
    InvalidKey {
        object_key: String,
        message: String,
    },
    InvalidContentRef(String),
    InvalidRange {
        object_key: String,
    },
    PreconditionFailed {
        object_key: String,
    },
    PermissionDenied {
        object_key: String,
        message: String,
    },
    Unsupported(&'static str),
    Configuration(String),
    Transport {
        object_key: String,
        message: String,
    },
}

Failure of one object-store operation.

Every object-scoped variant names the object it is about via object_key (for list operations, the listed prefix). The exceptions are deliberate: InvalidContentRef fails before a key exists, Unsupported is about a store capability, and Configuration is about store construction.

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.

NotFound

Reports a required object that was absent, distinct from optional-read None.

Fields

object_key: String

Logical object key that was required.

InvalidKey

Reports a logical key that is empty, escaping, malformed, or otherwise outside its scope.

Fields

object_key: String

Caller-supplied key rejected before provider IO.

message: String

Specific key-validation failure.

InvalidContentRef(String)

Not object-scoped: the content ref never resolved to an object key.

InvalidRange

Reports a byte range whose bounds cannot select a valid position in the object.

Fields

object_key: String

Object for which the caller supplied invalid range bounds.

PreconditionFailed

Reports a create-if-absent or compare-and-swap condition that did not hold.

Fields

object_key: String

Object whose current state disagreed with the requested write mode.

PermissionDenied

The provider rejected the caller’s identity or authorization — wrong, expired, or insufficient credentials. Configuration-shaped and never transient: retrying cannot help, an operator can.

Fields

object_key: String

Object or listing prefix the provider refused to authorize.

message: String

Sanitized provider explanation with credential material removed.

Unsupported(&'static str)

Not object-scoped: the store lacks a required capability.

Configuration(String)

Not object-scoped: store construction or configuration failed before any object was addressed.

Transport

Reports an IO, timeout, protocol, or provider failure with ambiguous completion.

Fields

object_key: String

Object or listing prefix whose operation did not complete observably.

message: String

Sanitized provider or local-IO diagnostic.

Implementations

impl ObjectStoreError

pub fn transport( object_key: impl Into<String>, message: impl Into<String>, ) -> Self

Builds a ObjectStoreError::Transport for an operation on object_key.

pub fn object_key(&self) -> Option<&str>

Key of the object (or listed prefix) the failing operation targeted, when the failure is object-scoped.

pub fn message(&self) -> String

Failure text without the object key, for wrappers that record the key as their own structured field.

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.