Skip to content

systemslab infra approve

Description Approve an instance request parked in manual allocation mode.
Usage systemslab infra approve [OPTIONS] <REQUEST_ID>

Description

The systemslab infra approve command moves an instance_request that is currently awaiting_approval back to pending, so the infrastructure manager's launch planning considers it again. Requests land in awaiting_approval when this deployment runs in manual allocation mode, which requires an operator to approve capacity requests before they launch.

Find awaiting_approval requests with systemslab infra requests --state awaiting_approval.

Idempotent. Approving a request that is not currently awaiting_approval — already approved, already terminal (fulfilled/denied/expired), or not a request id this deployment recognizes at all — prints nothing-to-do (in --output-format short) or a "nothing to approve" message (in the default long format) rather than either a success or an error. The server cannot tell "already resolved" apart from "no such request", so this command reports the same outcome for both; check with systemslab infra requests beforehand if you need to know which case you hit.

A note on --actor and identity

This deployment has no authentication layer. The actor recorded on an approval — by default operator:<your OS username>, derived automatically — is a courtesy label for the machine log, not a verified identity: anyone able to run this command can pass any --actor value they like. Use a real name via --actor when the automatic default would not identify you (for example, running under a shared or service account).

Examples

Approve a request with the default actor:

sh
systemslab infra approve 01900000-0d00-7f00-8000-000000000001

Approve with an explicit actor:

sh
systemslab infra approve 01900000-0d00-7f00-8000-000000000001 --actor operator:alice

Options

OptionDefaultDescription
<REQUEST_ID> The instance request to approve. Find request ids with systemslab infra requests.
--actoroperator:<current OS user> The actor recorded on this approval, overriding the derived default. Recorded verbatim as the request's approved_by and as the actor on the resulting machine-log entry. Caller-asserted, not authenticated — see the note above.

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.