status - View status of task(s)
status [OPTIONS] [-a]
status [OPTIONS] TASKID…
status [OPTIONS] label=PATTERN
status displays basic information about tasks. By default, all pending (ACTIVE or INACTIVE) tasks are shown. If the -a option is given, status displays all tasks, including completed tasks. Tasks are sorted by request time in descending order.
Status for specific tasks can be obtained by including one or more task ids or a label pattern. The PATTERN may contain asterisk ("*") characters for wildcard matching of labels.
By default, only a few fields are shown for each task. Use the -f option to select more fields than what are shown by default.
- -l LIMIT
Limit the number of results. Default: Unlimited
Show all tasks, including completed
- -f field[,field2]…
Select field(s) to display. If field is "all", all possible fields are selected. If field is "help", all possible field names are printed and the program will exit.
- -O format
Select the output format. Formats are:
A human readable format with one field per line. Records are delimited by a blank line.
CSV format with no headers
CSV format with field headers on the first line
A basic key=value format with one record per line. Characters such as whitespace are url-encoded.
The original command line, including options, that created this task.
The date and time this task finished processing (successfully or unsuccessfully)
The date and time of this task’s deadline. If a task has not completed by its deadline it will be aborted.
The label (if any) for the task.
The date and time this task was created
The basic, high level status of this task. Valid status codes are:
The task is in progress.
The task has been suspended and will not continue without intervention. Currently, only credential expiration will cause this state.
The task completed successfully.
The task or one of its subtasks failed, expired, or was canceled.
The unique ID of the task
The type of task. Possible values are:
A file transfer task initiated by transfer or the REST API
A delete task initiated by delete, rm, or the REST API
Show all pending tasks:
Show last 20 tasks, including completed:
$ status -a -l 20
Show all tasks containing the label string "data":
$ status label=*data*
Print just the status and request_time fields of a certain task:
$ status -f status,request_time -O csv b9582054-aad4-11df-8cd0-12313806cd95