Enum ErrorKind 

#[non_exhaustive]
pub enum ErrorKind {
    Unexpected,
    Unsupported,
    ConfigInvalid,
    NotFound,
    PermissionDenied,
    IsADirectory,
    NotADirectory,
    AlreadyExists,
    RateLimited,
    IsSameFile,
    ConditionNotMatch,
    RangeNotSatisfied,
    Conflict,
}

OpenDAL error categories.

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.

Unexpected

OpenDAL don’t know what happened here, and no actions other than just returning it back. For example, s3 returns an internal service error.

Unsupported

Underlying service doesn’t support this operation.

ConfigInvalid

The config for this service is invalid.

OpenDAL also returns this kind for an invalid option value or combination, for example if_not_changed metadata that contains no usable version or ETag, or a restore if_not_exists without a restore version.

NotFound

The given path is not found.

PermissionDenied

The given path doesn’t have enough permission for this operation

IsADirectory

The given path is a directory.

NotADirectory

The given path is not a directory.

AlreadyExists

The given path already exists thus we failed to the specified operation on it.

RateLimited

Requests that sent to this path is over the limit, please slow down.

IsSameFile

The given file paths are same.

ConditionNotMatch

A condition supplied through the OpenDAL operation evaluated to false.

Options such as if_match, if_not_exists, and if_not_changed produce this error. It is returned only for conditions the caller supplied: a service-side conflict unrelated to such a condition returns ErrorKind::Conflict, and observing a missing file with stat or read returns ErrorKind::NotFound regardless of conditions. See the conditional operation specification for its portable error semantics.

RangeNotSatisfied

The range of the content is not satisfied.

OpenDAL returns this error to indicate that the range of the read request is not satisfied.

Conflict

The operation conflicts with the current or transitional state of the resource.

This covers conflicts the service reports on its own; a false condition supplied through OpenDAL options returns ErrorKind::ConditionNotMatch instead.

This error kind does not indicate whether retrying the same operation is safe. Inspect the error’s retry status for that decision.

Implementations

impl ErrorKind

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

Convert self into static str.

Trait Implementations

impl Clone for ErrorKind

fn clone(&self) -> ErrorKind

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ErrorKind

impl Debug for ErrorKind

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

Formats the value using the given formatter.

impl Display for ErrorKind

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

Formats the value using the given formatter.

impl Eq for ErrorKind

impl From<ErrorKind> for &'static str

fn from(v: ErrorKind) -> &'static str

Converts to this type from the input type.

impl Hash for ErrorKind

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ErrorKind

fn eq(&self, other: &ErrorKind) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ErrorKind