sandbox_stop

把箱子永久停掉,釋放它的機器與裝置,/work 裡的東西全部消失。沒有東西要給人看時,做完就呼叫。

輸入 輸出
id ok、id、status(terminated);有別的箱子 link 到它時另有 linkedFrom 與 note
sandbox_stop { "id": "<id>" }
  • 回 { "ok": true, "id": "<id>", "status": "terminated" }。箱子的機器會釋放,/work 裡的一切跟著消失:要留下來的東西,停之前先 commit 並 push、用 sandbox_pull 拉回來,或發布成版本(收尾)。
  • 之後它的網址都回 503 box is terminated。停掉的箱子不會回來:新箱子有新的 id 與新網址(箱子狀態)。
  • 用 sandbox_device 租的裝置會一起還掉。
  • 箱子停掉後,app「全部沙盒」仍列出最近 7 天內停止的箱子,可開啟其尚未過期的截圖與錄影。GET /v1/boxes/{id}/media 也會回傳拍攝後 7 天內的內容(REST)。箱子的 /work 不會保留;需要人試用仍在跑的程式時,用 sandbox_review 交件。
  • 有別的箱子 link 到它時,結果另有 linkedFrom(那些箱子,格式跟被停箱子的 sandbox_status.linkedFrom 一樣:boxId、boxName、status、name、port、fromPort)與 note:These boxes had links to this box; their connections to it now fail until you re-point each link with sandbox_wire {id, service, port, fromBox}.(連到別的箱子)。
  • 凍結的箱子也能停,不會先喚醒它。
  • 只停你開的箱子,或 name 寫明是你的;隊友的箱子先問過再停,也不要照時間批次停箱子(sandbox_list)。
  • REST 也能經 /v1/boxes 停箱子(REST)。

所有工具與主題都列在工具參考。