diff --git a/docs/deploy.md b/docs/deploy.md index 95dd46a8a..c6c44af5a 100644 --- a/docs/deploy.md +++ b/docs/deploy.md @@ -840,6 +840,8 @@ only; computing durations or prices stays with the consumer. id text NOT NULL, vm text NOT NULL DEFAULT '', key text NOT NULL DEFAULT '', + template text NOT NULL DEFAULT '', + size text NOT NULL DEFAULT '', tenant text NOT NULL DEFAULT '', volumes text[], volumes_rw text[], diff --git a/docs/sandboxd-api.md b/docs/sandboxd-api.md index 8760c3084..63f1795d3 100644 --- a/docs/sandboxd-api.md +++ b/docs/sandboxd-api.md @@ -1015,8 +1015,10 @@ Always on: every lifecycle transition appends one JSONL event to `/usage.jsonl` — `{"t": , "ev": "claim|hibernate|wake|fork|checkpoint|promote|release|reap|archive|unarchive|archive_delete|egress|egress_bytes|vmm_exit|vmm_restart|vmm_failed", "id": "sb_…", "vm": "sbx-…"}` plus `key` (the pool key's stable hash, claim -events), `tenant` (the owning tenant, on every event of a tenant's claim), -`children` (fork) and `ref` (the promoted +events), `template` and `size` (the claim's template and size tier, claim +events, so a consumer can price a sandbox by its shape without the claim +record, which is gone after release), `tenant` (the owning tenant, on every +event of a tenant's claim), `children` (fork) and `ref` (the promoted template / checkpoint id, the egress host, or a `vmm_failed` reason). An egress event that injected credentials names them in `secret` (`gh,claim:`, never a value). An egress event routed through an [upstream proxy](egress.md#upstream-proxies) carries `upstream` (its `host:port`), and with @@ -1047,11 +1049,12 @@ Auth: root only (tenant tokens get 403). Reads the raw usage events of every node of the cell from the [shared usage table](deploy.md#shared-usage-table). - `GET /v1/usage?tenant=&since=