本頁說明如何將物件上傳至 Google Distributed Cloud (GDC) 氣隙式裝置儲存空間值區，以及從該處下載物件。
事前準備
專案命名空間可管理 Management API 伺服器中的 bucket 資源。您必須擁有專案，才能使用值區和物件。
您也必須具備適當的 bucket 權限，才能執行下列作業。請參閱「授予 bucket 存取權」。
物件命名指南
請按照下列規範為物件命名：
- 為物件命名時，請使用 UTF-8 字元。
- 請勿加入任何個人識別資訊 (PII)。
將物件上傳至儲存空間 bucket
如要上傳物件，請執行下列指令：
gdcloud storage cp LOCAL_PATH s3://REMOTE_PATH
gdcloud storage cp s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH
gdcloud storage mv s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH
下列指令會將本機目錄中的所有文字檔上傳至值區：
gdcloud storage cp *.txt s3://BUCKET
下列指令會將本機目錄中的多個檔案上傳至值區：
gdcloud storage cp abc1.txt abc2.txt s3://BUCKET
如要將資料夾上傳至值區，請使用 --recursive 選項複製整個目錄樹狀結構。下列指令會上傳目錄樹 dir：
gdcloud storage cp dir s3://BUCKET --recursive
針對大型物件執行多部分上傳作業，或在要上傳的檔案大於 15 MB 時，自動使用多部分上傳作業。在這種情況下，檔案會分割成多個部分，每個部分的大小為 15 MB。 最後一部分較小。每個部分會分別上傳，並在轉移完成時於目的地重建。
如果某個部分上傳失敗，您可以重新啟動上傳程序，不會影響已上傳的其他部分。
與多部分上傳相關的選項有兩種：
--disable-multipart：停用所有檔案的多部分上傳功能。--multipart-chunk-size-mb=SIZE：設定多部分上傳作業中每個區塊的大小。
如果檔案大於 SIZE，系統會自動以多執行緒多部分上傳方式上傳。使用傳統方法上傳較小的檔案。SIZE 的單位為 MB。預設的區塊大小為 15 MB。允許的最小區塊大小為 5 MB，最大為 5 GB。
從儲存空間 bucket 下載物件
如要從值區取得物件：
gdcloud storage cp s3://BUCKET/OBJECT LOCAL_FILE_TO_SAVE
如要將 bucket 中的所有文字檔下載到目前目錄：
gdcloud storage cp s3://BUCKET/*.txt .
如要從值區將文字檔案 abc.txt 下載至目前目錄，請執行下列指令：
gdcloud storage cp s3://BUCKET/abc.txt .
如要下載舊版檔案，請先列出檔案的所有版本：
gdcloud storage ls s3://BUCKET/abc.txt --all-versions
輸出內容範例：
s3://my-bucket/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND
s3://my-bucket/abc.txt#ODgzNEYzQ0MtMzEzRS0xMUVFLTk2NEItMjI1MTAwQkJENjND
s3://my-bucket/abc.txt#ODNCNDEzNzgtMzEzRS0xMUVFLTlDOUMtQzRDOTAwQjg3RTg3
然後，從值區將特定版本的文字檔 abc.txt 下載到目前目錄：
gdcloud storage cp s3://BUCKET/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .