enumeray run

Inspect accepted run history, diagnostics and evidence by ID.

Use when: You need to investigate accepted work or manage a known run directly.

Role and prerequisites: Authenticated model user with access to the resource. Install enumeray, configure the API and log in. Use an account or delegated token with the required permissions. Example IDs must be replaced with IDs from your service.

Example

enumeray run list

Every command also accepts the profile, API, JSON and timeout options.

Choose a subcommand

Command	Purpose
collections	List committed output collections from a run.
list	List runs visible to your account.
get	Inspect an accepted run’s state, inputs, outputs and execution snapshot.
wait	Observe progress until a terminal run state or the local deadline.
log-archive	Inspect terminal log archive metadata and retention availability.
logs	Read retained log pages or follow resumable live diagnostics.
events	Read one cursor page of run lifecycle and execution events.
provenance	Inspect provenance metadata or download the immutable provenance content.
artifacts	List the scientific output artifacts produced by a run.
cancel	Request cancellation of one accepted run submitted by your own account.

Result and next step

Choose a subcommand below. The group itself performs no operation.

Use analysis directories to start executions and manage their normal lifecycle; see run investigation for history and ID-based commands.

Exact syntax, defaults and accepted values

Inspect accepted run history, diagnostics and lifecycle by ID; execute through analysis directories

Usage: enumeray run [OPTIONS] <COMMAND>

Commands:
  collections  List immutable output collections
  list         List your accepted run history with optional model, state and time filters
  get          Inspect an accepted run by its stable UUID
  wait         Wait for a run to finish; a local deadline leaves execution unchanged
  log-archive  Inspect the retained terminal diagnostic log archive reference
  logs         Read one retained log page or follow resumable live run diagnostics
  events       Read one page of retained run lifecycle events
  provenance   Inspect or save immutable run provenance without downloading output bytes
  artifacts    List scientific output artifacts; input files and log archives are separate
  cancel       Request cancellation of an accepted run; repeat after an uncertain reply
  help         Print this message or the help of the given subcommand(s)

Options:
      --api <API>          User API origin override; credentials never cross origins. Host/runner commands use explicit configuration
      --profile <PROFILE>  Named local user API/login profile; host/runner commands use explicit configuration [default: default]
      --config <CONFIG>    Private user profiles file; defaults to $XDG_CONFIG_HOME/enumeray/profiles.json or ~/.config/enumeray/profiles.json
      --json               Emit user API results as JSON (NDJSON for following logs) and runtime errors on stderr; host/runner output follows its own protocol
      --timeout <TIMEOUT>  User API HTTP timeout in seconds; live logs use it for read inactivity. Does not limit execution time [default: 60]
  -h, --help               Print help