CLI reference / storage / ls

stado storage ls

Invocation

stado storage ls [OPTIONS] [PREFIX]

Purpose

List objects under a prefix, or per-prefix counts across the whole canonical prefix set when no prefix is given

Required inputs and options

Input or optionContract
[PREFIX]Object-name prefix. Omit for per-prefix counts across the canonical prefix set — the fast answer to "is the queue empty?"
--limit <LIMIT>Maximum objects listed under an explicit prefix [default: 255]
--sizeAlso report each listed object's body size. Opt-in because it costs one download per object; see `probe_sizes`
--jsonCommand option; required or optional as shown in the invocation.

Output and state effect

This is an inspection/reporting operation. It emits the result described above and does not change managed state unless an explicit option in this page says otherwise. Pass `--json` when the command exposes that machine-readable option.

Refusals

  • 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.