Appearance
systemslab infra requests
| Description | List `instance_request` rows, newest first. |
|---|---|
| Usage | systemslab infra requests [OPTIONS] |
Description
The systemslab infra requests command lists capacity requests the infrastructure manager is tracking: how many instances were asked for, how many have been granted, which market they prefer, and what state the request is in.
Unlike systemslab infra status (a live planning snapshot), this is the "what happened" reader: it includes terminal requests too — fulfilled, denied, expired — unless you filter them out with --state. A request in the awaiting_approval state is one systemslab infra approve or systemslab infra deny can act on.
This command reads over the REST API (there is no GraphQL field for it).
Examples
Requests waiting on an operator right now:
sh
systemslab infra requests --state awaiting_approvalOptions
| Option | Default | Description |
|---|---|---|
--state | Only show requests in one of these states. This flag can be provided multiple times to match more than one state. Omit it to show every state, terminal states included. Valid states are pending, awaiting_approval, launching, fulfilled, denied, and expired. | |
--context-id | Only show requests scoped to this context. | |
--limit | 100 | The maximum number of requests to show, from 1 to 1000. |
--before-created-at | Pagination cursor: only show requests strictly older than this timestamp. Must be given together with --before-id; use the created-at of the last row of the previous page. | |
--before-id | See --before-created-at; use the id of the last row of the previous page. | |
-H, --no-header | Do not emit a table header with the column names. | |
-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. |