Workspaces/Advanced Features/ws list: Difference between revisions
Jump to navigation
Jump to search
(Created page with "= ws_list - List Workspaces = == Sorting Options == * <tt>-N</tt> - Sort by name (alphabetical) * <tt>-C</tt> - Sort by creation date * <tt>-R</tt> - Sort by remaining time (see what expires soon) * <tt>-r</tt> - Reverse sort order == Display Format Options == * <tt>-s</tt> - Short format (only names, good for scripts) * <tt>-t</tt> - Terse format * <tt>-v</tt> - Verbose format with all metadata == Filtering Options == * <tt>-F <location></tt> - List workspaces on...") |
mNo edit summary |
||
| Line 1: | Line 1: | ||
= ws_list - List Workspaces = |
= ws_list - List Workspaces = |
||
== |
== Basic Usage == |
||
$ ws_list # List all your workspaces |
|||
| ⚫ | |||
| ⚫ | |||
| ⚫ | |||
| ⚫ | |||
Shows workspace ID, location, available extensions, creation date, and remaining time. |
|||
| ⚫ | |||
== Common Use Cases == |
|||
| ⚫ | |||
| ⚫ | |||
* <tt>-v</tt> - Verbose format with all metadata |
|||
'''See what expires soon:''' |
|||
== Filtering Options == |
|||
$ ws_list -Rr # Sort by remaining time (-R), reverse (-r) = soonest first |
|||
| ⚫ | |||
| ⚫ | |||
| ⚫ | |||
== Examples == |
|||
'''List group workspaces:''' |
'''List group workspaces:''' |
||
$ ws_list -g # Show workspaces from your group |
|||
$ ws_list -g |
|||
'''For scripts (names only):''' |
|||
This shows all workspaces that were created with <tt>-g</tt> or <tt>-G</tt> flags by members of your group. |
|||
$ ws_list -s # Short format, just workspace names |
|||
'''List workspaces by expiration:''' |
|||
| ⚫ | |||
$ ws_list -Rr |
|||
$ ws_list -l # List filesystem locations |
|||
This shows workspaces sorted by remaining time in reverse order, so the ones expiring soonest appear first. |
|||
| ⚫ | |||
| ⚫ | |||
'''Sorting:''' |
|||
$ ws_list -l |
|||
| ⚫ | |||
| ⚫ | |||
| ⚫ | |||
* <tt>-r</tt> - Reverse sort order (combine with -R for soonest expiring first) |
|||
'''Display Format:''' |
|||
Shows which filesystem locations are available for workspaces on your cluster. |
|||
| ⚫ | |||
| ⚫ | |||
| ⚫ | |||
'''Filtering:''' |
|||
| ⚫ | |||
| ⚫ | |||
| ⚫ | |||
== Note |
== Note == |
||
To list expired workspaces that can be restored, use <tt>ws_restore -l</tt>. See [[Workspaces/Advanced_Features/ws_restore|ws_restore]] |
To list '''expired workspaces''' that can be restored, use <tt>ws_restore -l</tt> instead. See [[Workspaces/Advanced_Features/ws_restore|ws_restore]]. |
||
For more information: <tt> |
For more information: <tt>ws_list -h</tt> or <tt>man ws_list</tt> |
||
Revision as of 16:39, 2 December 2025
ws_list - List Workspaces
Basic Usage
$ ws_list # List all your workspaces
Shows workspace ID, location, available extensions, creation date, and remaining time.
Common Use Cases
See what expires soon:
$ ws_list -Rr # Sort by remaining time (-R), reverse (-r) = soonest first
List group workspaces:
$ ws_list -g # Show workspaces from your group
For scripts (names only):
$ ws_list -s # Short format, just workspace names
Check available filesystems:
$ ws_list -l # List filesystem locations
All Options
Sorting:
- -N - Sort alphabetically by name
- -C - Sort by creation date
- -R - Sort by remaining time (default: most time remaining first)
- -r - Reverse sort order (combine with -R for soonest expiring first)
Display Format:
- -s - Short format (only names, for scripts)
- -t - Terse format
- -v - Verbose format with all metadata
Filtering:
- -F <location> - Show only workspaces on specific filesystem
- -g - Show group workspaces (created with -g or -G)
- -l - List available filesystem locations
Note
To list expired workspaces that can be restored, use ws_restore -l instead. See ws_restore.
For more information: ws_list -h or man ws_list