GLOBUS BOOKMARK SHOW
DESCRIPTION
Given a single bookmark ID or bookmark name, show the bookmark details. By default, when the format is TEXT, this will display the endpoint ID and path in 'ENDPOINT_ID:PATH' notation.
The default output is suitable for use in a subshell in another command.
If -v, --verbose is given, several fields will be displayed.
OPTIONS
- -v, --verbose
-
Control level of output.
- -h, --help
-
Show this message and exit.
-
-F, --format
[unix|json|text] -
Output format for stdout. Defaults to text.
-
--jmespath, --jq
TEXT -
A JMESPath expression to apply to json output. Forces the format to be json processed by this expression.
-
--map-http-status
TEXT -
Map HTTP statuses to any of these exit codes: 0,1,50-99. e.g. "404=50,403=51"
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.
3 if the command was used on the wrong type of object, e.g. a collection command used on an endpoint.
4 if the command has authentication or authorization requirements which were not met, as in ConsentRequired errors or missing logins.