CLI Menu

Command Line Interface (CLI) CLI QuickStart GuideCommand Line Interface (CLI) ExamplesUsing the CLI with High Assurance Resources


globus task generate-submission-id - Generate a new Task submission ID


globus task generate-submission-id ['OPTIONS']


The globus task generate-submission-id command generates a new Task submission ID for use in globus transfer and globus delete.

Submission IDs allow you to safely retry submission of a Task in the presence of network errors. No matter how many times you submit a Task with a given ID, it will only be accepted and executed once. The response status may change between submissions.


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

-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 generated 'UUID' is the only output.


Submit a transfer, using a submission ID generated by this command:

$ sub_id="$(globus task generate-submission-id)"
$ globus transfer --submission-id "$sub_id" ...


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