CLI Menu

Command Line Interface (CLI)InstallationCommand Line Interface (CLI) Examples
Hosted Command Line Interface (Legacy)
Using the Legacy Command Line Interface (CLI)
Reference
CLI ChangelogGLOBUS BOOKMARK CREATE(1)GLOBUS BOOKMARK DELETE(1)GLOBUS BOOKMARK LIST(1)GLOBUS BOOKMARK RENAME(1)GLOBUS BOOKMARK SHOW(1)GLOBUS DELETE(1)GLOBUS ENDPOINT ACTIVATE(1)GLOBUS ENDPOINT CREATE(1)GLOBUS ENDPOINT DEACTIVATE(1)GLOBUS ENDPOINT DELETE(1)GLOBUS ENDPOINT IS-ACTIVATED(1)GLOBUS ENDPOINT MY-SHARED-ENDPOINT-LIST(1)GLOBUS ENDPOINT PERMISSION CREATE(1)GLOBUS ENDPOINT PERMISSION DELETE(1)GLOBUS ENDPOINT PERMISSION LIST(1)GLOBUS ENDPOINT PERMISSION SHOW(1)GLOBUS ENDPOINT PERMISSION UPDATE(1)GLOBUS ENDPOINT ROLE CREATE(1)GLOBUS ENDPOINT ROLE DELETE(1)GLOBUS ENDPOINT ROLE LIST(1)GLOBUS ENDPOINT ROLE SHOW(1)GLOBUS ENDPOINT SEARCH(1)GLOBUS ENDPOINT SERVER ADD(1)GLOBUS ENDPOINT SERVER DELETE(1)GLOBUS ENDPOINT SERVER LIST(1)GLOBUS ENDPOINT SERVER SHOW(1)GLOBUS ENDPOINT SERVER UPDATE(1)GLOBUS ENDPOINT SHOW(1)GLOBUS ENDPOINT UPDATE(1)GLOBUS GET-IDENTITIES(1)GLOBUS LIST-COMMANDS(1)GLOBUS LOGIN(1)GLOBUS LOGOUT(1)GLOBUS LS(1)GLOBUS MKDIR(1)GLOBUS RENAME(1)GLOBUS TASK CANCEL(1)GLOBUS TASK EVENT-LIST(1)GLOBUS TASK GENERATE-SUBMISSION-ID(1)GLOBUS TASK LIST(1)GLOBUS TASK PAUSE-INFO(1)GLOBUS TASK SHOW(1)GLOBUS TASK UPDATE(1)GLOBUS TASK WAIT(1)GLOBUS TRANSFER(1)GLOBUS UPDATE(1)GLOBUS VERSION(1)GLOBUS WHOAMI(1)
  1. Home
  2. Command Line Interface (CLI)
  3. Reference

GLOBUS TASK SHOW(1)

NAME

globus task show - Show detailed information about a specific task

SYNOPSIS

globus task show [OPTIONS] TASK_ID

DESCRIPTION

The globus task show command prints information to standard out detailing the status and other info about a task. The task may be pending, completed, or in progress.

OPTIONS

-t, --successful-transfers

Show files that were successfully transferred as a result of this task. This option completely changes the output, only producing this information and no other task details.

--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, output varies slightly between TRANSFER and DELETE tasks, and between active and completed tasks.

All of the following which apply will be shown:

  • Task ID

  • Type

  • Status

  • Is Paused

  • Label

  • Files

  • Directories

  • Source Endpoint

  • Source Endpoint ID

  • Destination Endpoint

  • Destination Endpoint ID

  • Endpoint

  • Endpoint ID

  • Completion Time

  • Deadline

  • Details

  • Request Time

  • Bytes Transferred

  • Bytes Per Second

  • Faults

  • Total Subtasks

  • Subtasks Succeeded

  • Subtasks Pending

  • Subtasks Retrying

  • Subtasks Failed

  • Subtasks Canceled

  • Subtasks Expired

If --successful-transfers is given, the following fields are used:

  • Source Path

  • Destination Path

EXAMPLES

Show detailed info about a task as text

$ globus task show TASK_ID

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