Enum Error 

pub enum Error {
    Io(Error),
    Client(ClientError),
    Serde {
        context: String,
        cause: Error,
    },
    Reqwest {
        context: String,
        cause: Error,
    },
    Metadata(Error),
    GcpAuth(Error),
    Panic(String),
    Dropped,
    UnexpectedTombstone,
    AtCapacity,
    Generic {
        context: String,
        cause: Option<Box<dyn Error + Send + Sync>>,
    },
}

Error type for service operations.

Variants

Io(Error)

IO errors related to payload streaming or file operations.

Client(ClientError)

Error originating from a client-supplied input stream.

Indicates the client is at fault (e.g. dropped connection mid-upload) and should map to a 4xx response rather than a 5xx.

Serde

Errors related to de/serialization.

Fields

context: String

Context describing what was being serialized/deserialized.

cause: Error

The underlying serde error.

Reqwest

All errors stemming from the reqwest client, used in multiple backends to send requests to e.g. GCP APIs. These can be network errors encountered when sending the requests, but can also indicate errors returned by the API itself.

Fields

context: String

Context describing the request that failed.

cause: Error

The underlying reqwest error.

Metadata(Error)

Errors related to de/serialization and parsing of object metadata.

GcpAuth(Error)

Errors encountered when attempting to authenticate with GCP.

Panic(String)

A spawned service task panicked.

Dropped

A spawned service task was dropped before it could deliver its result.

This is an unexpected condition that can occur when the runtime drops the task for unknown reasons.

UnexpectedTombstone

A redirect tombstone was encountered at a place where it is not supported.

This indicates a caller bug — tombstone-aware reads must go through the HighVolumeBackend methods.

AtCapacity

The service has reached its concurrency limit and cannot accept more operations.

Generic

Any other error stemming from one of the storage backends, which might be specific to that backend or to a certain operation.

Fields

context: String

Context describing the operation that failed.

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

The underlying error, if available.

Implementations

impl Error

pub fn panic(payload: Box<dyn Any + Send>) -> Self

Creates an Error::Panic from a panic payload, extracting the message.

pub fn reqwest(context: impl Into<String>, cause: Error) -> Self

Creates an Error::Reqwest from a reqwest error with context.

pub fn serde(context: impl Into<String>, cause: Error) -> Self

Creates an Error::Serde from a serde error with context.

pub fn generic(context: impl Into<String>) -> Self

Creates an Error::Generic with a context string and no cause.

pub fn level(&self) -> Level

Returns the appropriate log level for this error.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

fn from(source: ClientError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.