Struct GcResponse 

pub struct GcResponse {
    pub namespace_id: NamespaceId,
    pub deleted: DeletedObjectCounts,
    pub released_checkpoints: ReleasedCheckpointCounts,
    pub retained_candidates: u64,
    pub retained: RetainedCandidates,
    pub retention_degraded: bool,
    pub content_reclamation_deferred: bool,
    pub budget_exhausted: bool,
    pub next_cursor: Option<String>,
    pub next_reclamation_at_ms: Option<u64>,
}

Result of one mark-and-sweep garbage-collection pass.

Deletion counts are grouped by object family. Checkpoint releases and retained candidates are grouped by reason.

Fields

namespace_id: NamespaceId

Namespace the pass ran against.

deleted: DeletedObjectCounts

Objects the pass deleted, split by object family.

released_checkpoints: ReleasedCheckpointCounts

Checkpoint records the pass released, split by the reason each one was released.

retained_candidates: u64

Candidates retained at delete time (grace window, missing timestamps, or reachable from the fresh root set).

retained: RetainedCandidates

retained_candidates grouped by reason.

retention_degraded: bool

True when ambiguous roots suppressed manifest/segment deletion.

content_reclamation_deferred: bool

True when max_objects was too small to build the complete reference set required for completed-content reclamation.

budget_exhausted: bool

True when the pass reached max_objects before it finished. Use next_cursor to continue or run again with a larger limit.

next_cursor: Option<String>

Opaque resume token when more candidates remain. It is valid only for the same namespace.

next_reclamation_at_ms: Option<u64>

Earliest known time when a retained upload session may become reclaimable. This covers open-session leases and grace periods for aborted or completed sessions. It only reflects candidates inspected by this pass, so absence does not mean no future work remains.

Implementations

impl GcResponse

pub fn empty(namespace_id: NamespaceId) -> Self

An empty report for namespace_id, before any candidate is examined.

pub fn retain(&mut self, reason: RetainedReason)

Records one retained candidate under the reason that spared it.

The total and the breakdown move together here so they cannot drift: every sweep site names a reason, and no site can count a retention without naming one.

Trait Implementations

impl Clone for GcResponse

fn clone(&self) -> GcResponse

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GcResponse

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GcResponse

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for GcResponse

impl PartialEq for GcResponse

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for GcResponse

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 GcResponse