MAQPNADocs

maqpna session suspend

Suspend a running session

Run agents-o json | yaml

Synopsis#

maqpna session suspend|resume S [-n NS] [--wait]

Description#

From the help of maqpna session:

Sessions are AgentSession objects: start creates one, the operator provisions its sandbox and token. describe merges the object, its sandbox and pods with the gateway's view (cost, taint, pending approvals). exec, files and liveview go through the gateway session API and are governed and audited like any tool call (scope tools:maqpna-exec, admin role).

exec exits with the remote command's exit code. wait exits 1 on timeout or when the session fails.

Flags#

FlagTypeDescriptionDefault
-n, --namespacestringnamespacedefault
--timeoutdurationhow long --wait waits5m0s
--waitswitchwait until the session is Suspendednone

The global flags (--context, -o, --no-color, ...) work with every command.

What happens when you run it#

  • --wait: wait until the session is Suspended.
  • Prints a table by default; -o json or -o yaml print the data, and --jq EXPR filters the JSON.

Exit codes#

CodeMeaning
0success
1error (the message says what failed, with a hint when there is one)
2usage error: unknown flag, missing argument or bad value; the synopsis is printed
3a check failed, a change is blocked, or a result did not match (tamper, policy mismatch) (not used by this command)

Terminal demo#

maqpna session suspend --help.cast

This command needs a Kubernetes cluster with MAQPNA installed, so the recording shows its help. Try it against a cluster from Install.