GLOBUS TASK LIST(1)
globus task list - List tasks for the current user
globus task list [OPTIONS]
The globus task list command lists the current user’s most recent tasks. The tasks displayed may be filtered by a number of attributes, each with a separate commandline option.
- --limit N
Limit the number of results to the N most recent. Default value is 10.
- --filter-task-id UUID
Filter the tasks to those matching this UUID. This option can be used multiple times, meaning that any matching Task IDs are allowed.
- --filter-type [TRANSFER|DELETE]
Filter results to only TRANSFER or DELETE tasks.
- --filter-status [ACTIVE|INACTIVE|FAILED|SUCCEEDED]
Task status to filter results by. This option can be used multiple times, meaning that any matching status is allowed.
- --filter-label TEXT
Filter results to task whose label matches a pattern. This option can be used multiple times, meaning that any matching label is allowed.
- --filter-not-label TEXT
Filter results whose label does not match a pattern. This option can be used multiple times, meaning any non-matching patterns are excluded.
When --exact is given --filter-label and --filter-not-label must be exact matches. When --inexact is given, these patterns may include * as a wild-card, and may ignore case.
- --filter-requested-after ISO_TIME
Filter results to tasks that were requested after given time.
- --filter-requested-before ISO_TIME
Filter results to tasks that were requested before given time.
- --filter-completed-after ISO_TIME
Filter results to tasks that were completed after given time.
- --filter-completed-before ISO_TIME
Filter results to tasks that were completed before given time.
- --map-http-status TEXT
Map non success HTTP response codes to exit codes other than 1. e.g. "--map-http-satus 403=0,404=0" would exit with 0 even if a 403 or 404 http error code was received. Valid exit codes are 0,1,50-99.
- -F, --format [json|text]
Set the output format for stdout. Defaults to "text".
- --jq, --jmespath EXPR
Supply a JMESPath expression to apply to json output. Takes precedence over any specified --format and forces the format to be json processed by this expression.
A full specification of the JMESPath language for querying JSON structures may be found at https://jmespath.org/
- -h, --help
Show help text for this command.
- -v, --verbose
Control the level of output.
Use -v or --verbose to show warnings and any additional text output.
Use -vv to add informative logging.
Use -vvv to add debug logging and full stack on any errors. (equivalent to -v --debug)
When text output is requested, the following fields are used:
Source Display Name
Dest Display Name
List results in a text table:
$ globus task list
List the first 100 tasks which were completed between May 2015 and July 2015, but whose labels aren’t the exact string autolabel:
$ globus task list --limit 100 \ --filter-completed-after 2015-05-01 \ --filter-completed-before 2015-07-30 \ --filter-not-label 'autolabel' --exact
0 on success.
1 if a network or server error occurred, unless --map-http-status has been used to change exit behavior on http error codes.
2 if the command was used improperly.