Enum StorageError 

pub enum StorageError {
    ResourceNotFound {
        tenant_id: String,
        resource_type: String,
        id: String,
    },
    ResourceAlreadyExists {
        tenant_id: String,
        resource_type: String,
        id: String,
    },
    InvalidData {
        message: String,
        cause: Option<String>,
    },
    TenantNotFound {
        tenant_id: String,
    },
    InvalidQuery {
        message: String,
        attribute: Option<String>,
        value: Option<String>,
    },
    CapacityExceeded {
        message: String,
        current_count: Option<usize>,
        limit: Option<usize>,
    },
    ConcurrentModification {
        tenant_id: String,
        resource_type: String,
        id: String,
        expected_version: Option<String>,
        actual_version: Option<String>,
    },
    Unavailable {
        message: String,
        retry_after: Option<Duration>,
    },
    PermissionDenied {
        operation: String,
        resource: String,
    },
    Timeout {
        operation: String,
        duration: Duration,
    },
    DataCorruption {
        tenant_id: String,
        resource_type: String,
        id: Option<String>,
        details: String,
    },
    Configuration {
        message: String,
        parameter: Option<String>,
    },
    Network {
        message: String,
        endpoint: Option<String>,
    },
    Serialization {
        message: String,
        data_type: Option<String>,
    },
    Internal {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
}

Errors that can occur during storage operations.

These errors represent failures in the storage layer and are protocol-agnostic. They focus on data persistence, retrieval, and basic storage operations without any knowledge of SCIM semantics or business rules.

Variants

ResourceNotFound

The requested resource was not found.

Fields

tenant_id: String

resource_type: String

id: String

ResourceAlreadyExists

The resource already exists when it shouldn’t (for operations requiring uniqueness).

Fields

tenant_id: String

resource_type: String

id: String

InvalidData

Invalid data format or structure that cannot be stored.

Fields

message: String

cause: Option<String>

TenantNotFound

The tenant was not found or is invalid.

Fields

tenant_id: String

InvalidQuery

Invalid query parameters or search criteria.

Fields

message: String

attribute: Option<String>

value: Option<String>

CapacityExceeded

Storage capacity exceeded (disk full, memory limit, etc.).

Fields

message: String

current_count: Option<usize>

limit: Option<usize>

ConcurrentModification

Concurrent modification detected (optimistic locking failure).

Fields

tenant_id: String

resource_type: String

id: String

expected_version: Option<String>

actual_version: Option<String>

Unavailable

Storage backend is temporarily unavailable.

Fields

message: String

retry_after: Option<Duration>

PermissionDenied

Permission denied for the storage operation.

Fields

operation: String

resource: String

Timeout

Timeout occurred during storage operation.

Fields

operation: String

duration: Duration

DataCorruption

Corruption detected in stored data.

Fields

tenant_id: String

resource_type: String

id: Option<String>

details: String

Configuration

Configuration error in the storage backend.

Fields

message: String

parameter: Option<String>

Network

Network-related error for distributed storage systems.

Fields

message: String

endpoint: Option<String>

Serialization

Serialization or deserialization error.

Fields

message: String

data_type: Option<String>

Internal

Generic internal storage error.

Fields

message: String

source: Option<Box<dyn Error + Send + Sync>>

Implementations

impl StorageError

pub fn resource_not_found( tenant_id: impl Into<String>, resource_type: impl Into<String>, id: impl Into<String>, ) -> Self

Create a new ResourceNotFound error.

pub fn resource_already_exists( tenant_id: impl Into<String>, resource_type: impl Into<String>, id: impl Into<String>, ) -> Self

Create a new ResourceAlreadyExists error.

pub fn invalid_data(message: impl Into<String>) -> Self

Create a new InvalidData error.

pub fn invalid_data_with_cause( message: impl Into<String>, cause: impl Into<String>, ) -> Self

Create a new InvalidData error with a cause.

pub fn tenant_not_found(tenant_id: impl Into<String>) -> Self

Create a new TenantNotFound error.

pub fn invalid_query(message: impl Into<String>) -> Self

Create a new InvalidQuery error.

pub fn capacity_exceeded(message: impl Into<String>) -> Self

Create a new CapacityExceeded error.

pub fn concurrent_modification( tenant_id: impl Into<String>, resource_type: impl Into<String>, id: impl Into<String>, ) -> Self

Create a new ConcurrentModification error.

pub fn unavailable(message: impl Into<String>) -> Self

Create a new Unavailable error.

pub fn permission_denied( operation: impl Into<String>, resource: impl Into<String>, ) -> Self

Create a new PermissionDenied error.

pub fn timeout(operation: impl Into<String>, duration: Duration) -> Self

Create a new Timeout error.

pub fn data_corruption( tenant_id: impl Into<String>, resource_type: impl Into<String>, details: impl Into<String>, ) -> Self

Create a new DataCorruption error.

pub fn configuration(message: impl Into<String>) -> Self

Create a new Configuration error.

pub fn network(message: impl Into<String>) -> Self

Create a new Network error.

pub fn serialization(message: impl Into<String>) -> Self

Create a new Serialization error.

pub fn internal(message: impl Into<String>) -> Self

Create a new Internal error.

pub fn internal_with_source( message: impl Into<String>, source: Box<dyn Error + Send + Sync>, ) -> Self

Create a new Internal error with a source error.

pub fn is_not_found(&self) -> bool

Check if this error indicates a resource was not found.

pub fn is_conflict(&self) -> bool

Check if this error indicates a conflict (resource already exists or concurrent modification).

pub fn is_temporary(&self) -> bool

Check if this error indicates a temporary failure that might succeed on retry.

pub fn is_invalid_input(&self) -> bool

Check if this error indicates invalid input data.

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.