Enum mountpoint_s3_client::error::ObjectClientError

pub enum ObjectClientError<S, C> {
    ServiceError(S),
    ClientError(C),
}

The top-level error type returned by calls to an ObjectClient.

Errors that are explicitly modeled on a per-request-type basis are ServiceErrors. Other generic or unhandled errors are ClientErrors.

The distinction between these two types of error can sometimes be blurry. As a rough heuristic, ServiceErrors are those that any reasonable implementation of an object client would be capable of experiencing, and ClientErrors are anything else. For example, any object client could experience a “no such key” error, but only object clients that implement a permissions system could experience “permission denied” errors. When in doubt, we err towards not adding new ServiceErrors, as they are public API for every object client.

Variants

ServiceError(S)

An error returned by the service itself

ClientError(C)

An error within the object client (for example, an unexpected response, or a failure to construct the request).

Trait Implementations

impl<S: Debug, C: Debug> Debug for ObjectClientError<S, C>

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

Formats the value using the given formatter.

impl<S, C> Display for ObjectClientError<S, C>

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

Formats the value using the given formatter.

impl<S, C> Error for ObjectClientError<S, C>

where S: Error + 'static, C: Error + 'static, Self: Debug + Display,

fn source(&self) -> Option<&(dyn Error + 'static)>

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<S, C> From<C> for ObjectClientError<S, C>

fn from(source: C) -> Self

Converts to this type from the input type.