Enum agreed::error::ChangeConfigError

#[non_exhaustive]
pub enum ChangeConfigError {
    RaftError(RaftError),
    ConfigChangeInProgress,
    InoperableConfig,
    NodeNotLeader(Option<NodeId>),
    Noop,
    NodeFailedToCatchUp(NodeId),
}

The set of errors which may take place when requesting to propose a config change.

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.

RaftError(RaftError)

An error related to the processing of the config change request.

Errors of this type will only come about from the internals of applying the config change to the Raft log and the process related to that workflow.

ConfigChangeInProgress

The cluster is already undergoing a configuration change.

InoperableConfig

The given config would leave the cluster in an inoperable state.

This error will be returned if the full set of changes, once fully applied, would leave the cluster in an inoperable state.

NodeNotLeader(Option<NodeId>)

The node the config change proposal was sent to was not the leader of the cluster. The ID of the current leader is returned if known.

Noop

The proposed config changes would make no difference to the current config.

NodeFailedToCatchUp(NodeId)

Since the node was not ready to join when attempting to add it to the cluster, we had to sync it. However, the syncing process failed to complete on time, and thus we’re giving up on the configuration change.

Trait Implementations

impl Debug for ChangeConfigError

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

Formats the value using the given formatter.

impl Display for ChangeConfigError

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

Formats the value using the given formatter.

impl Error for ChangeConfigError

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

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

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

impl<D: AppData> From<ClientWriteError<D>> for ChangeConfigError

fn from(src: ClientWriteError<D>) -> Self

Performs the conversion.

impl From<RaftError> for ChangeConfigError

fn from(source: RaftError) -> Self

Performs the conversion.