sandbox_get
把 /work、/tmp 或 /dev/shm 底下的檔案或資料夾取出成下載網址,一小時有效(資料夾是 tar.gz);小圖片也會直接附在結果裡。
| 輸入 | 輸出 |
|---|---|
id、path 或 paths |
url(1 小時有效:https://api.parallelsandbox.com/v1/files/…,打開時會轉址到儲存空間)、name、bytes、contentType、archive、expiresAt;資料夾另附 note,打包時有檔案還在寫就再附 changedWhileReading;只拿一張小圖時另附圖本身;給 paths 時回 files[],每項多一個 path,拿不到的那項只有 path 與 error,後面再附前 10 張圖(合計 8 MB 內),每張前面一行路徑,還有圖只給網址時附 note |
要存到自己這台電腦,經 stdio 轉接器改用 sandbox_pull:它會下載下來,資料夾直接解開到本機資料夾。用 sandbox_get 拿資料夾時,note 也會這樣提醒。
sandbox_get 會把檔案或目錄上傳成暫存副本,目錄會打成 tar.gz,最上層是那個目錄本身。路徑相對於 /work(shots 就是 /work/shots,寫 /work/shots 也行),或是 /tmp/、/dev/shm/ 底下的絕對路徑,測試常把產物寫在那裡;其他絕對路徑會被拒絕。下載網址有效 1 小時,expiresAt 是到期時間;簽名用的憑證比較早到期時,會是那個比較早的時間。下載被拒(HTTP 403)就再呼叫一次 sandbox_get 拿新網址。暫存副本約 1 天後自動刪除,而且不計入檔案保存量。箱子還在時可再呼叫取得新網址。要保留的檔案請在停箱前下載,例如用 sandbox_pull;停箱後不能重取網址,原網址也只在到期前可用。同一次可用 paths 取最多 50 個路徑;同名檔案也各自有獨立網址與內容。只取一張 4 MB 以內的 PNG、JPEG、WebP 或 GIF,結果還會直接附圖;用 paths 時,前 10 張圖(合計 8 MB 內)也會附上,每張標出路徑,其餘只給網址,note 寫還有幾張。被中斷的箱子若在主機消失前存下了 /work,path: "/work" 會拿到那一份 work.tar.gz(箱子狀態)。
所有工具與主題都列在工具參考。