Struct RestoreStatus 

pub struct RestoreStatus {
    pub phase: Option<RestorePhase>,
    pub source_kind: Option<String>,
    pub observed_generation: Option<i64>,
    pub resolved: Option<ResolvedRestore>,
    pub target: Option<RestoreTargetStatus>,
    pub timing: Option<RestoreTiming>,
    pub wait_started_at: Option<String>,
    pub progress: Option<RestoreProgress>,
    pub conditions: Vec<Condition>,
    pub log_tail: Option<String>,
    pub failure: Option<FailureBlock>,
    pub claims: BTreeMap<String, RestoreClaimStatus>,
}

Observed state of a Restore, written by the controller/mover.

Fields

phase: Option<RestorePhase>

Current lifecycle phase.

source_kind: Option<String>

The pinned source kind (SnapshotRef/FromPolicy/Identity); backs the SOURCE printer column.

observed_generation: Option<i64>

metadata.generation last reconciled, so stale status is detectable.

resolved: Option<ResolvedRestore>

The source resolved and pinned at admission; never re-resolved.

target: Option<RestoreTargetStatus>

Resolved target details (the PVC written to / populator handshake).

timing: Option<RestoreTiming>

Start/end timestamps for the restore run.

wait_started_at: Option<String>

When the policy.waitTimeout window OPENED (RFC3339) — the first reconcile on which the restore could actually proceed (its repository reached Ready, and for a target.populator a PVC already claims it), NOT when the Restore was created. The window does NOT open while the referenced Repository object or fromPolicy SnapshotPolicy doesn’t exist: the restore parks in Pending (ReferentAvailable=False, reason RestoreReferentMissing) and stays unstamped. It DOES still open for a snapshotRef whose Snapshot row doesn’t exist yet (so onMissingSnapshot can fire for a ref that never appears) and for a restore whose mover Job already launched. Stamped once and then honored verbatim, so the window survives controller restarts and Job pod retries; cleared when a populator re-opens resolution for a re-created claim, so that claim gets the full window again. Absent means the window has not opened yet (or no policy.waitTimeout is configured, in which case there is no window to anchor).

progress: Option<RestoreProgress>

Bytes/files restored so far, patched periodically by the mover.

conditions: Vec<Condition>

Standard Kubernetes conditions carrying the human-readable status/reason.

log_tail: Option<String>

The last lines of the run’s output, written by the mover at the terminal transition.

failure: Option<FailureBlock>

Structured terminal-failure detail (kopia error class, stderr tail, retry hint).

claims: BTreeMap<String, RestoreClaimStatus>

Per-claimant state for a target.populator restore, keyed by the claiming PVC’s name (#443).

A populator Restore is claimed by EVERY PVC whose spec.dataSourceRef names it, not just the first, and each claimant gets its own prime PVC, its own mover Job and its own kopia source path — so each needs its own state. A map, not a list, because an RFC-7386 merge patch merges map keys but REPLACES arrays: N concurrent populate movers each patch only their own key and can never clobber a sibling (the same reason as SnapshotPolicyStatus.verificationStamps).

Absent for a direct target.pvc/target.pvcRef restore, which keeps using the top-level resolved/target/waitStartedAt/logTail/failure.

The schema renders as an object with additionalProperties, which PRUNES unknown keys — so every field any writer (controller or mover) puts under claims.<pvc> must exist on RestoreClaimStatus.

Trait Implementations

impl Clone for RestoreStatus

fn clone(&self) -> RestoreStatus

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RestoreStatus

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

Formats the value using the given formatter.

impl Default for RestoreStatus

fn default() -> RestoreStatus

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RestoreStatus

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for RestoreStatus

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for RestoreStatus

fn eq(&self, other: &RestoreStatus) -> 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 Serialize for RestoreStatus

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RestoreStatus