保留期
Sandbox 的物件依用途套用獨立的保留時鐘。前端若快取資源 id 或下載連結，要理解它們何時會消失。
可設定的保留（公司設定）
經 PUT /settings 調整（company manager）：
| 設定 | 範圍 | 意義 |
|---|---|---|
run_content_retention_days | 1..365 | 執行內容（輸入/輸出/日誌/產物）保留天數 |
unreferenced_image_retention_days | 1..90 | 未被引用的建置映像保留天數 |
固定的內部時鐘
| 類別 | 規則 | 常數 |
|---|---|---|
| 成功正式來源 | 活躍/被引用期間保留，之後 30 天歸檔寬限 | SOURCE_ARCHIVE_GRACE_DAYS = 30 |
| 失敗情境內容/日誌/報告 | 終止後 7 天過期 | FAILED_CONTEXT_RETENTION_DAYS = 7 |
| 建置重試窗 | retryable_failed / cancelled 的 attempt，7 天內可重試 | BUILD_RETRY_WINDOW_DAYS = 7 |
| 下載 capability | 5 分鐘（過期重換） | _DOWNLOAD_CAPABILITY_TTL = timedelta(minutes=5) |
| Agent 提案 | 30 分鐘 | PROPOSAL_TTL_SECONDS = 1800 |
| Agent turn receipt | 10 分鐘 | TURN_RECEIPT_TTL_SECONDS = 600 |
| 已歸檔的環境版本（後端 ≥ SBW-08） | 歸檔後幾分鐘內，controller 會回收它各區的 Cloud Run Job、quarantine + execution 映像套件、attestation 與建置報告（未完成的回收每 10 分鐘重試）。歸檔是終態 —— 之後沒有東西能釘住或執行該版本，建置日誌也一併消失。例外（v5.10.11）：若仍有未歸檔的 curated 版本釘住同一個映像 digest，該 execution 套件會保留（各區 Job 仍照常回收），等 curated 版本歸檔後，下一輪回收才刪除。 | RECLAIM_RECHECK_INTERVAL = 10 min |
給前端的實務建議
- 不要把
run_id/artifact_id當永久連結；受保留天數限制。 - 失敗情境的日誌/報告 7 天後消失——要留存請及時下載。
- 下載 capability 過期就重新
POST .../download換一張。 - 改
PUT /settings的保留天數不會改寫既有 run／產出物的過期快照。只有新 run 吃新時鐘。
Last updated on