Skip to content

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_approval

Options

OptionDefaultDescription
--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.
--limit100 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,
--field-separator
" " Use this separator as the field separator when emitting unaligned output.
-R,
--record-separator
"\n" Use this separator as the record separator for unaligned output.

Common Options

OptionDefaultDescription
--systemslab-url The URL at which to access the systemslab server.
--colorauto Controls when color is used in the output. Possible values are auto, always, and never.
--output-formatlong 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

VariableDescription
SYSTEMSLAB_URLSpecify the URL used to contact the SystemsLab server. Equivalent to --systemslab-url.