stado status
Invocation
stado status [OPTIONS] [FILTER_ID]Purpose
Show job status: the queue's jobs by state, or one job by its id
Required inputs and options
| Input or option | Contract |
|---|---|
[FILTER_ID] | A job id — whole (`job-` and its hex) or its first hex characters, with or without `job-` — read directly and, once its run was reaped, from the run's retained outcome; an id no job holds is refused by name. Any other text is a substring of a job id or batch id to filter the listing by |
--json | Print the rows as JSON: each job's record with its lifecycle `state` and whether it was read from a reaped run |
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
- A job id — whole (`job-` and its hex) or its first hex characters, with or without `job-` — read directly and, once its run was reaped, from the run's retained outcome; an id no job holds is refused by name.
- 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.