Struct ForcedTransitionRequest 

pub struct ForcedTransitionRequest { /* private fields */ }

A request to force ownership of one range to target for disaster recovery.

Unlike a TransitionRequest it carries no CAS expectations and no catch-up evidence — force exists precisely for the case where those cannot be satisfied. What it carries instead are the two authorisation inputs ADR 0037 requires: an optional ForceTransitionCapability and an optional OperatorReason. They are optional on the request so the authorisation gate can observe — and audit — their absence; force_transition refuses any request missing either.

Implementations

impl ForcedTransitionRequest

pub fn new( collection: CollectionId, range_id: RangeId, target: NodeIdentity, ) -> ForcedTransitionRequest

A forced-transition request for (collection, range_id) installing target as the new owner, with no capability or reason attached yet. As built it will be denied; attach authorisation with with_capability and with_reason.

pub fn with_capability( self, capability: ForceTransitionCapability, ) -> ForcedTransitionRequest

Attach the administrative capability authorising the force.

pub fn with_reason(self, reason: OperatorReason) -> ForcedTransitionRequest

Attach the operator’s explicit justification.

pub fn with_replicas( self, replicas: impl IntoIterator<Item = NodeIdentity>, ) -> ForcedTransitionRequest

Set the replica set the forced new owner will carry. Defaults to empty — in a disaster the operator often installs a sole survivor with no replicas.

pub fn collection(&self) -> &CollectionId

pub fn range_id(&self) -> RangeId

pub fn target(&self) -> &NodeIdentity

Trait Implementations

impl Clone for ForcedTransitionRequest

fn clone(&self) -> ForcedTransitionRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ForcedTransitionRequest

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

Formats the value using the given formatter.

impl Eq for ForcedTransitionRequest

impl PartialEq for ForcedTransitionRequest

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ForcedTransitionRequest