Enum ReloadError 

pub enum ReloadError {
    ReadCatalog {
        path: String,
        source: Error,
    },
    ReadPolicy {
        path: String,
        source: Error,
    },
    Validate(LoadError),
    RoutingShapeChanged(String),
    NoInputs,
}

Why a reload_generation was rejected. On any of these the previous generation keeps serving (fail closed); none of them swap.

Variants

ReadCatalog

The catalog file could not be re-read from its configured path.

Fields

path: String

The catalog path that failed to read.

source: Error

The underlying IO error.

ReadPolicy

The policy file could not be re-read from its configured path.

Fields

path: String

The policy path that failed to read.

source: Error

The underlying IO error.

Validate(LoadError)

The candidate catalog/policy failed the full startup/check validation (load, including the JWT-SVID issuer-alg and publicPath guardrails).

RoutingShapeChanged(String)

The candidate changed a restart-only routing dimension (a backend was added/removed/repathed, or a key’s backend/path/engine/key_type/ public_path changed). Such an edit needs a re-unlock and is rejected on the reload path; apply it via a restart instead.

NoInputs

The broker was constructed without ReloadInputs (no configured catalog/policy paths), so it has nothing to re-read. A reload is a no-op fail-closed rather than reading from an unknown source.

Implementations

impl ReloadError

pub const fn audit_reason(&self) -> &'static str

A short, stable, non-secret reason token for the audit trail.

Trait Implementations

impl Debug for ReloadError

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

Formats the value using the given formatter.

impl Display for ReloadError

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

Formats the value using the given formatter.

impl Error for ReloadError

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<LoadError> for ReloadError

fn from(source: LoadError) -> Self

Converts to this type from the input type.