GLOBUS BOOKMARK SHOW(1)
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.