CLI reference / space / reclaim

stado space reclaim

Invocation

stado space reclaim [OPTIONS] <TARGET>

Purpose

Reclaim only fleet-declared stages, previewing unless --apply is present

Required inputs and options

Input or optionContract
<TARGET>Positional input; required or optional as shown in the invocation.
--stage <STAGES>Select a declared stage; repeat to select several. Omit for all stages
--dry-runReport what the selected stages would remove and write no audit record
--applyRemove what the selected stages name. Requires --reason
--reason <REASON>Why the space is being reclaimed; recorded on the target beside its state
--jsonCommand option; required or optional as shown in the invocation.

Output and state effect

It performs the operation described above and emits its operator result on standard output or standard error. Any state change is limited to the resources and records named by the purpose and options on this page.

Refusals

  • Requires --reason
  • Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.