Enum KmsError 

pub enum KmsError {
    Unavailable(String),
    Denied(String),
    Tampered(String),
    Invalid(String),
    Refused(String),
}

Why a wrap or unwrap did not happen. The split that matters operationally is unavailable (retry, alarm on duration) against denied (do not retry, alarm immediately): they want different alarms and different retry behaviour, and a single opaque error makes a permissions mistake look like an outage for as long as it takes someone to read the logs.

Variants

Unavailable(String)

The KMS could not be reached, or answered that it is unwell. Retryable.

Denied(String)

The KMS was reached and refused: no permission on the key, or the key is disabled. Not retryable; a human has to change something.

Tampered(String)

The wrapped key did not authenticate: it was truncated, altered, or wrapped under a different master key. Never retryable, and never a reason to fall back to anything.

Invalid(String)

The caller passed something this port cannot accept.

Refused(String)

The provider refuses to run in this configuration.

Implementations

impl KmsError

pub fn is_retryable(&self) -> bool

Whether a retry could plausibly succeed without anyone intervening. Retry policy lives with the caller; this is the fact it needs.

Trait Implementations

impl Debug for KmsError

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

Formats the value using the given formatter.

impl Display for KmsError

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

Formats the value using the given formatter.

impl Error for KmsError

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.