job ls

List jobs in Studio.

Synopsis

usage: datachain job ls [-h] [-v] [-q] [--status STATUS] [--team TEAM] [--limit LIMIT]

Description

This command lists jobs in Studio. You can filter jobs by their status, specify a team, and limit the number of jobs returned. By default, it shows the 20 most recent jobs.

Options

--status STATUS - Status to filter jobs by
--team TEAM - Team to list jobs for (default: from config)
--limit LIMIT - Limit the number of jobs returned (default: 20)
-h, --help - Show the help message and exit
-v, --verbose - Be verbose
-q, --quiet - Be quiet

Status options

You will be able to filter the job with following status:

CREATED - Job has been created but not yet scheduled
SCHEDULED - Job is scheduled to run at a future time
QUEUED - Job is in the queue waiting to be executed
INIT - Job is initializing and preparing to run
RUNNING - Job is currently executing
COMPLETE - Job has finished successfully
FAILED - Job has failed during execution
CANCELING_SCHEDULED - A scheduled job is being canceled
CANCELING - A running job is being canceled
CANCELED - Job has been canceled
ACTIVE - Job is in active state.
INACTIVE - Job is in inactive state.

Note: The following statuses are considered active jobs:

CREATED
SCHEDULED
QUEUED
INIT
RUNNING
CANCELING_SCHEDULED
CANCELING

Examples

List all jobs (default limit of 20):
```
datachain job ls
```
List jobs for a specific team:
```
datachain job ls --team my-team
```
List jobs with a specific status:
```
datachain job ls --status complete
```
List more jobs by increasing the limit:
```
datachain job ls --limit 50
```
List jobs with verbose output:
```
datachain job ls -v
```

Notes

The default limit of 20 jobs helps manage the output size and performance
Jobs are typically listed in reverse chronological order (newest first)
Use the --status filter to find jobs in specific states (e.g., running, completed, failed)