- attemptrequiredinteger
- 1 for the first try, 2 for the first retry, and so on.
- auto_pause_moderequiredstring
- What idle means for the rule:
requests | activity. - auto_pause_srequiredinteger
- The idle rule it is under: park after this many idle seconds, 0 for never.
- billable_secondsinteger | null
- Once it has ended, the seconds it is billed for (the run report's
billable_seconds). Present on GET /v1/sandboxes/{id} for an ended sandbox; absent from list rows. - cost_usdnumber | null
- What it has cost in USD at its run's rates: once it has ended, the run report's
cost; while it is live, the seconds billed so far (running time only). Present on GET /v1/sandboxes/{id} once it has started; absent from list rows. - created_atrequiredstring
- When the sandbox was created, RFC 3339: when its run was started, or when the retry or replay that made it was asked for.
- e2e_msnumber | null
- Milliseconds from the start request, after any time queued, to the sandbox being handed over: it does not include
queued_ms. Add queued_ms for the whole wait. - egressrequiredEgressCounters
- Data out, and whether it was cut for the organisation's monthly cap.
- elapsed_msinteger | null
- Milliseconds of running time since hand-over, time spent paused excluded: what
timeout_ms is measured against, so timeout_ms - elapsed_ms is the time it has left. null before hand-over and once it has ended. - env_verifiedrequiredboolean
- Whether this sandbox's environment passed its checks.
- eta_sinteger | null
- Seconds until this sandbox is expected to start, with
queued_reason: capacity_arriving. null with the other reasons, and once the sandbox has waited longer than the estimate it was first given; queued_message then says it is taking longer than expected rather than repeating a number. - execsExecView[] | null
- The commands run in this sandbox. Present on
GET /v1/sandboxes/{id}; absent from the rows of a list, which would otherwise carry every byte of every command's output. - failureobject
- What went wrong, rendered against this sandbox's own evidence.
null on success. - labelsrequiredmap of string
- Inherited from the run. A caller that looked a sandbox up by label needs to see the labels it got back, and one that did not needs a way to learn what a sandbox is tagged with.
- one_timeboolean | null
- True when this is a one-time wait: once the waiting sandboxes can start, the rest of the run starts at once too. False otherwise.
- optimize_forrequiredOptimizeFor
- What the sandbox asked for.
- optimize_for_appliedOptimizeFor | null
- What its latest start or resume actually got;
null before the first. - outcomestring | null
- Why it ended;
null while it is still alive. - pause_expires_atstring | null
- While it is paused: when it will be deleted, with its files and state, unless it is resumed before then (RFC 3339). A paused sandbox is kept for 30 days, and resuming it starts the 30 days again. Absent while it is not paused, and for a paused sandbox that is not due to be deleted.
- pause_reasonstring | null
- Why it is paused, when a limit paused it rather than a request:
spend_cap (its run reached its spend cap) or credits_exhausted (the organization's credits ran out). Its files and state are kept and paused time is not billed; it resumes once the cap is raised or credits are added. Absent otherwise. - queued_messagestring | null
- The same, in words, ready to show a person.
- queued_msnumber | null
- Milliseconds spent waiting for capacity.
- queued_reasonQueuedReason | null
- ready_msnumber | null
- Milliseconds until the sandbox was ready to take work.
- replay_ofstring | null
- The sandbox this one is a replay of.
- retried_bystring | null
- The retry that replaced this sandbox, if it was retried.
- retry_ofstring | null
- The sandbox this one is a retry of.
- run_idrequiredstring
- The run this sandbox belongs to.
- sandbox_idrequiredstring
- snapshot_idrequiredstring
- The snapshot it was started from, as its run names it (
GET /v1/runs/{id}): the snapshot's id, or promigence/base for the built-in base. - staterequiredstring
queued | ready | running | paused | ended.- t_endstring | null
- When it ended, RFC 3339.
- t_handoffstring | null
- When the sandbox was handed over, RFC 3339.
- timeout_msinteger | null
- The lifetime this sandbox is bound to, in milliseconds of running time: time spent paused does not count. A
PATCH with a larger timeout_ms extends it. - verify_each_msnumber | null
- Milliseconds the per-sandbox verification took, when
verify_each was asked for. - warningsrequiredstring[]