Usage
Options
boolean
Only print instance IDs, one per line (alias:
--quiet)boolean
Show additional columns (SSH, location, template, etc.) (alias:
--verbose)boolean
Fetch all pages automatically and send to pager (alias:
--all)string
Filter by container status. Choices:
running, loading, exitedstring
Filter by instance label; pass empty string to match unlabeled
string
Filter by GPU model name (e.g.
RTX A5000)string
Filter by machine verification. Choices:
verified, unverified, deverifiedinteger
Max instances per page (1-25, default 25)
string
Resume from a pagination token from a previous page
string
Sort column with optional direction, e.g.
start_date descstring
Override displayed columns with a comma-separated list
Description
Returns a paginated list of instance objects. Key status fields per instance: actual_status, current container state:
intended_status, user’s desired target state:
running, stopped, or frozen.
cur_state, machine contract / hardware allocation state: running, stopped, or unloaded (released on destroy).
status_msg, human-readable detail on the current status.