Enum StorageError 

pub enum StorageError {
    InvalidConfiguration(String),
    AuthenticationError(String),
    PermissionDenied(String),
    FileNotFound(String),
    FileAlreadyExists(String),
    NetworkError(String),
    FilesystemError(Error),
    InvalidUrl(ParseError),
    SerializationError(Error),
    Base64Error(DecodeError),
    InvalidFileFormat(String),
    FileTooLarge {
        size: u64,
        max_size: u64,
    },
    ChecksumMismatch {
        expected: String,
        actual: String,
    },
    UploadInterrupted(String),
    DownloadInterrupted(String),
    MultipartUploadError(String),
    PresignedUrlError(String),
    TemporaryStorageError(String),
    QuotaExceeded {
        used: u64,
        limit: u64,
    },
    RateLimited {
        retry_after: u64,
    },
    InvalidRange(String),
    Timeout {
        timeout: u64,
    },
    OperationFailed {
        operation: String,
        message: String,
    },
    UnsupportedOperation {
        operation: String,
        backend: String,
    },
    S3OperationFailed {
        message: String,
        request_id: Option<String>,
    },
    GcsError(String),
    MinIOError(String),
    HttpError(Error),
    SecurityError {
        operation: String,
        message: String,
    },
    Other(String),
}

Storage error types

Variants

InvalidConfiguration(String)

Configuration error

AuthenticationError(String)

Authentication error

PermissionDenied(String)

Permission error

FileNotFound(String)

File not found

FileAlreadyExists(String)

File already exists

NetworkError(String)

Network connection error

FilesystemError(Error)

Local filesystem error

InvalidUrl(ParseError)

URL parsing error

SerializationError(Error)

Serialization/deserialization error

Base64Error(DecodeError)

Base64 encoding/decoding error

InvalidFileFormat(String)

Invalid file format

FileTooLarge

File too large

Fields

size: u64

max_size: u64

ChecksumMismatch

Checksum mismatch

Fields

expected: String

actual: String

UploadInterrupted(String)

Upload interrupted

DownloadInterrupted(String)

Download interrupted

MultipartUploadError(String)

Multipart upload error

PresignedUrlError(String)

Presigned URL generation error

TemporaryStorageError(String)

Temporary storage error

QuotaExceeded

Storage quota exceeded

Fields

used: u64

limit: u64

RateLimited

Rate limited

Fields

retry_after: u64

InvalidRange(String)

Invalid range request

Timeout

Timeout error

Fields

timeout: u64

OperationFailed

Generic operation error

Fields

operation: String

message: String

UnsupportedOperation

Unsupported operation for backend

Fields

operation: String

backend: String

S3OperationFailed

S3 operation error

Fields

message: String

request_id: Option<String>

GcsError(String)

GCS operation error

MinIOError(String)

MinIO specific errors

HttpError(Error)

HTTP client error

SecurityError

Security-related error

Fields

operation: String

message: String

Other(String)

Generic error

Implementations

impl StorageError

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

Create a configuration error

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

Create an authentication error

pub fn not_found(file_path: impl Into<String>) -> Self

Create a file not found error

pub fn operation_failed( operation: impl Into<String>, message: impl Into<String>, ) -> Self

Create an operation failed error

pub fn is_retryable(&self) -> bool

Check if this is a retryable error

pub fn is_client_error(&self) -> bool

Check if this is a client error (4xx)

pub fn is_server_error(&self) -> bool

Check if this is a server error (5xx)

pub fn category(&self) -> &'static str

Get error category for logging/metrics

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, __formatter: &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<DecodeError> for StorageError

fn from(source: DecodeError) -> Self

Converts to this type from the input type.

impl From<Error> for StorageError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for StorageError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for StorageError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for StorageError

fn from(source: ParseError) -> Self

Converts to this type from the input type.

impl From<Response> for StorageError

Convert HTTP status codes to storage errors

fn from(response: Response) -> Self

Converts to this type from the input type.