NAME

globus task list - List tasks for the current user

SYNOPSIS

globus task list [OPTIONS]

DESCRIPTION

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.

OPTIONS

--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.

--inexact/--exact

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)

OUTPUT

When text output is requested, the following fields are used:

  • Task ID

  • Status

  • Type

  • Source Display Name

  • Dest Display Name

  • Label

EXAMPLES

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

EXIT STATUS

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.


© 2010- The University of Chicago Legal