CLI reference / instances / list

stado instances list

Invocation

stado instances list [OPTIONS]

Purpose

List every live agent VM across the configured providers, flagging the ones no queue job or lease still references

Required inputs and options

Input or optionContract
--provider <PROVIDER>Single provider to inspect; default is every entry in WC_PROVIDERS
--jsonEmit machine-readable JSON instead of the table

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.