NAME

globus get-identities - Lookup Globus Auth identities

SYNOPSIS

globus get-identites [OPTIONS] [UUID_OR_USERNAME(s)]

DESCRIPTION

The globus get-identities command takes in one or more user IDs and/or usernames for Globus Auth identities, and looks up those identities.

Default output resolves each UUID to a username and each username to a UUID, with one output per line in the same order as the inputs. If a particular input had no corresponding identity in Globus Auth, "NO_SUCH_IDENTITY" is printed instead.

If more fields are desired, --verbose will give tabular output, but does not guarantee order and ignores inputs with no corresponding Globus Auth identity.

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)

EXAMPLES

Resolve a user ID (outputs the user’s username)

$ globus get-identities c699d42e-d274-11e5-bf75-1fc5bf53bb24

Resolve a username (outputs the user’s ID)

$ globus get-identities go@globusid.org

Resolve multiple usernames and or IDs with tabular output

$ globus get-identities --verbose go@globusid.org clitester1a@globusid.org \
84942ca8-17c4-4080-9036-2f58e0093869

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