Last Updated: December 22, 2016

Note:This page refers to the current Globus CLI which is accessed via SSH. We have a new CLI, which is a locally installed program and now available in Beta.
acl-add

acl-add adds a new rule to the endpoint’s access control list (ACL).

acl-list

acl-list displays all rules in an endpoint’s access control list (ACL).

acl-remove

acl-remove deletes a specified rule from the endpoint’s ACL.

bookmark-add

bookmark-add creates a new bookmark. A bookmark is linked to an endpoint and path.

bookmark-list

bookmark-list shows bookmarks owned by the current user. The output format is JSON.

bookmark-remove

bookmark-remove deletes a bookmark.

cancel

cancel stops all processing of a task. If the task has already completed, a notice will be displayed.

delete

The delete command can be used to script multi-line delete operations as a single batch.

details

details displays detailed information about tasks. By default, details displays all currently running or pending tasks. Use the -a option to display all tasks, including completed tasks. Tasks are sorted by request time in descending order.

endpoint-activate

endpoint-activate assigns a short term security credential to specified endpoint(s). If pattern is not specified, it defaults to *, which matches all endpoints shown by endpoint-list.

endpoint-add

endpoint-add creates a logical endpoint with a user specified name. endpoint-add can also add a physical server to an existing logical endpoint if the -p option is given.

endpoint-deactivate

endpoint-deactivate removes credentials previously assigned to a logical endpoint by endpoint-activate. If pattern is not specified, it defaults to *.

endpoint-details

enpoint-details shows attributes of endpoint(s).

endpoint-list

endpoint-list shows information about endpoints. Each logical endpoint has one or more servers, represented by a URL and an optional subject DN. Each logical endpoint may also have a short term security credential which has been assigned by the endpoint-activate command.

endpoint-modify

endpoint-modify can set attributes of endpoint(s). One attribute can be set or unset against one or more endpoints at a time. See the options below for details. Use the empty string ('') to unset a text attribute. Run endpoint-list -v to view current attributes.

endpoint-remove

endpoint-remove can remove logical endpoint(s) with names matching a pattern. endpoint-remove can also remove (unmap) a physical server from a specific logical endpoint.

endpoint-rename

endpoint-rename renames the logical endpoint oldname to newname.

endpoint-search

endpoint-search searches for endpoints which have attributes (display name, legacy name, description, organization, department, keywords) that match the SEARCH text. The current result size limit is 100 endpoints.

events

events displays events for a task. Events are sorted by time in ascending order.

glob

Certain CLI commands, like rm and ls, will expand a shell-compatibile glob pattern in the final path component. For example, 'rm go#ep1/tmp/*.txt' would look for all files in /tmp that match '*.txt'.

labels

Globus Online tasks may be given a user created, arbitrary label to enable easy categorization and management of lots of tasks.

ls

The ls command lists files and subdirectories on an endpoint.

mkdir

The mkdir command creates a directory. Currently, the parent directory must exist (-p is not supported).

modify

The modify command can change properties of task(s), such as deadline and label.

profile

profile is used to view and modify your user settings. If no arguments are given, the profile command will display your user name, DN(s), sshkeys, email address, and notification settings.

quoting

The Globus Online CLI behaves much like a normal shell such as bash with respect to the use of quotes and escaping.

rename

The rename command renames a file or directory on an endpoint.

rm

The rm command is a quick and easy way to delete a single file, directory, or pattern. Its semantics are as close as possible to UNIX rm.

server-add

server-add adds a server to an existing endpoint.

server-list

server-list displays all servers for an endpoint.

server-remove

server-remove removes a server from an endpoint.

status

status displays basic information about tasks. By default, all pending (ACTIVE or INACTIVE) tasks are shown. If the -a option is given, status displays all tasks, including completed tasks. Tasks are sorted by request time in descending order.

transfer

transfer creates a task that copies files and/or directories between endpoints. If multiple input lines are given over stdin, all lines must have the same source and destination endpoint.

versions

versions displays a list of service / version strings that are supported by the server. A specific version can be requested for a command or a shell by using the v=VERSION:USER_AGENT prefix when running a command or starting the interactive shell. If the server does not support the requested version, the command will fail and an error message will be displayed.

wait

wait will wait until a task completes successfully, is canceled, or expires.


© 2010- The University of Chicago Legal