NAME

globus bookmark show - Show bookmark details, or display it in the form of ENDPOINT_ID:PATH

SYNOPSIS

globus bookmark show [OPTIONS] BOOKMARK_ID_OR_NAME

globus bookmark show --verbose [OPTIONS] BOOKMARK_ID_OR_NAME

DESCRIPTION

The globus bookmark show command takes a single bookmark ID or bookmark name and shows the bookmark details. By default, when the format is TEXT, this will display the endpoint ID and path in ENDPOINT_ID:PATH notation.

If -v, --verbose is given, several fields will be displayed.

OPTIONS

--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 textual output is requested, the output varies depending on verbosity.

By default, output is simply ENDPOINT_ID:PATH

If -v or --verbose is given, output has the following fields:

  • ID

  • Name

  • Endpoint ID

  • Path

EXAMPLES

Resolve a bookmark, for use in another command:

$ globus ls "$(globus bookmark show BOOKMARK_NAME)"

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