限制與配額
以下是前端 API 實際會碰到的限制（取自 src/components/sandbox/constants.py 與 schema）。註：控制面的 20 槽位 / 20 GiB / 每分鐘 5 次 init 那類暫存配額，前端碰不到（見 架構）。
分頁
| 項目 | 值 |
|---|---|
page_size | ge=1，le=100（MAX_PAGE_SIZE），預設 20 或 50（依端點） |
page_token | 不透明字串，max_length=512 |
輸入與腳本大小
| 項目 | 值 |
|---|---|
| 執行輸入 JSON | ≤ 1 MiB、深度 ≤ 64、節點 ≤ 100,000、無 NUL、無重複 key |
| startup / work 腳本 | 各 ≤ 1 MiB（MAX_SCRIPT_UTF8_BYTES） |
| 環境變數 | ≤ 100 個名稱、每項 ≤ 64 KiB |
| 提交 body（Content-Length） | 過大先回 413 request_too_large |
逾時
| 項目 | 值 |
|---|---|
| 預設 work 逾時 | 1800 秒（DEFAULT_WORK_TIMEOUT_SECONDS） |
| 最大 work 逾時 | ≈ 7 天（168 小時 − finalization envelope） |
timeout_seconds 欄位 | ge=1，le≈7天 |
產出物
| 項目 | 值 |
|---|---|
| 單一 run 產出物檔案數 | ≤ 1000（MAX_ARTIFACT_FILES） |
每公司政策上限（SandboxCompanyPolicy）
由後端政策決定、可經 PUT /settings（部分）調整或屬營運範圍：
active_environment_limit：可用環境數上限。capacity_retained_version_limit：保留版本數上限。- run/build 同時進行數、佇列上限等。
run_content_retention_days：1..365（可設定）。unreferenced_image_retention_days：1..90（可設定）。
超過相關上限時，對應端點回錯誤（多為 409/422，未授權為 404）。錯誤碼見 錯誤碼對照表。
Last updated on