Appearance
systemslab context list
| Description | List contexts. |
|---|---|
| Usage | systemslab context list [OPTIONS] |
Description
The systemslab context list command lists contexts on the SystemsLab server.
The results can be filtered by name or state, and the number of returned contexts can be limited. Pagination is supported via the --after and --before flags.
For use in scripts you will want to use the --no-align flag along with (potentially) the --record-separator and --field-separator flags.
Options
| Option | Default | Description |
|---|---|---|
--name | Filter to only contexts whose name matches the provided regex. | |
--state | Filter to only contexts in the specified state. Valid states are open, pending, complete, and cancelled. | |
--limit | 100 | The maximum number of contexts to return. |
--after | Only return contexts that came after this context ID. | |
--before | Only return contexts that came before this context ID. | |
-H, --no-header | Do not emit a table header with the column names. | |
-f, --field | id, name, state, created-at | Specifies fields to be printed when listing contexts. This flag can be provided multiple times to specify multiple fields to show. The defaults are only used if no fields are requested. Valid fields which can be requested are:
|
-A, --no-align | Switches to unaligned output mode. | |
-F, | " " | Use this separator as the field separator when emitting unaligned output. |
-R, | "\n" | Use this separator as the record separator for unaligned output. |
Common Options
| Option | Default | Description |
|---|---|---|
--systemslab-url | The URL at which to access the systemslab server. | |
--color | auto | Controls when color is used in the output. Possible values are auto, always, and never. |
--output-format | long | Output format to use when outputting messages. long will result output designed to be human-readable while short is short output meant to be used within scripts. |
Environment Variables
| Variable | Description |
|---|---|
SYSTEMSLAB_URL | Specify the URL used to contact the SystemsLab server. Equivalent to --systemslab-url. |