Enum Error 

pub enum Error {
    NotFound,
    Gone,
    PermissionDenied,
    Unauthorized,
    DbError,
    Parse,
    ValidationError(String),
    Conflict(String),
    PreconditionRequired(String),
    SettingNotFound(String),
    NetworkError(String),
    Timeout,
    ConfigError(String),
    ServiceUnavailable(String),
    Internal(String),
    ImageError(String),
    CryptoError(String),
    FileSourceNotFound,
    FileSourceForbidden,
    FileSourceUnreachable,
    FileCycleRejected,
    Io(Error),
}

Variants

NotFound

Gone

410 - the resource existed but is permanently gone (used for the IDP activation-resend endpoint when Identity.expires_at has passed — resending after expiry is impossible because the deadline is fixed at registration and not extended).

PermissionDenied

Unauthorized

DbError

Parse

ValidationError(String)

Conflict(String)

PreconditionRequired(String)

SettingNotFound(String)

404 - settings registry has no entry for the requested key, or the registered key has no default value and no override is configured. Used by SettingsService::*_opt to distinguish “not configured” from “configured with the wrong type”.

NetworkError(String)

Timeout

ConfigError(String)

ServiceUnavailable(String)

Internal(String)

ImageError(String)

CryptoError(String)

FileSourceNotFound

FileSourceForbidden

FileSourceUnreachable

FileCycleRejected

Io(Error)

Implementations

impl Error

pub fn is_retryable(&self) -> bool

Whether a failed operation is worth retrying. A short denylist of permanent failures returns false; everything else returns true.

Scoped to what the task scheduler’s federation tasks actually return. Permanent here means “a later attempt cannot succeed”: the sender isn’t following us, the JWT signature is invalid, the action is malformed, or the remote resource is gone (410). Transient failures — network/TLS errors, timeouts, a locked DB, a peer briefly returning 404 — are NOT listed and so remain retryable. Mis-classifying a rare error toward “retryable” is cheap (a few wasted attempts, then the retry limit stops it); mis-classifying toward “permanent” would silently drop recoverable federated actions, so we err toward retryable. Known cost of this choice: Error::NotFound is retryable so a peer briefly 404-ing can recover, but a task whose local target is genuinely gone (e.g. a deleted action) also returns NotFound and will retry to the policy limit before on_failed fires. Error carries no local-vs-remote distinction, so we accept those wasted retries rather than break federation recovery by denylisting NotFound.

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, f: &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<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<JoinError> for Error

fn from(err: JoinError) -> Self

Converts to this type from the input type.

impl From<ParseIntError> for Error

fn from(err: ParseIntError) -> Self

Converts to this type from the input type.

impl From<SystemTimeError> for Error

fn from(err: SystemTimeError) -> Self

Converts to this type from the input type.

impl From<ToStrError> for Error

fn from(err: ToStrError) -> Self

Converts to this type from the input type.

impl IntoResponse for Error

fn into_response(self) -> Response

Create a response.