本頁說明如何將物件上傳至 Google Distributed Cloud (GDC) 氣隙儲存空間值區，以及從該值區下載物件。
事前準備
專案命名空間可管理 Management API 伺服器中的 bucket 資源。您必須擁有專案，才能使用 bucket 和物件。
您也必須具備適當的 bucket 權限，才能執行下列作業。請參閱「授予 bucket 存取權」。
物件命名指南
請按照下列規範為物件命名：
- 為物件命名時，請使用 UTF-8 字元。
- 請勿加入任何個人識別資訊 (PII)。
將物件上傳至儲存空間 bucket
控制台
- 在導覽選單中，按一下「物件儲存空間」。
- 按一下要上傳物件的值區名稱。
- 選用：如要建立資料夾來儲存物件，請依序按一下「建立資料夾」 > 輸入資料夾名稱 > 按一下「建立」。
- 直接按一下「上傳檔案」，或前往剛建立的資料夾，然後按一下「上傳檔案」。
- 選取所需檔案，然後按一下「開啟」。
- 等待系統顯示上傳成功的確認訊息。
CLI
如要上傳物件，請執行下列指令：
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
下列指令需要 FULLY_QUALIFIED_BUCKET_NAME。使用「查看值區設定」一節中的 GET 或 DESCRIBE 指令，取得完整值區名稱。
下列指令會將本機目錄中的所有文字檔上傳至值區：
gdcloud storage cp *.txt s3://FULLY_QUALIFIED_BUCKET_NAME
下列指令會將本機目錄中的多個檔案上傳至值區：
gdcloud storage cp abc1.txt abc2.txt s3://FULLY_QUALIFIED_BUCKET_NAME
如要將資料夾上傳至值區，請使用 --recursive 選項複製整個目錄樹狀結構。下列指令會上傳目錄樹 dir：
gdcloud storage cp dir s3://FULLY_QUALIFIED_BUCKET_NAME --recursive
針對大型物件執行多部分上傳作業，或在要上傳的檔案大於 15 MB 時，自動使用多部分上傳作業。在這種情況下，檔案會分割成多個部分，每個部分的大小為 15 MB。 最後一部分較小。每個部分會分別上傳，並在轉移完成時於目的地重建。
如果某個部分上傳失敗，您可以重新啟動上傳程序，不會影響已上傳的其他部分。
與多部分上傳相關的選項有兩種：
--disable-multipart：停用所有檔案的多部分上傳功能。--multipart-chunk-size-mb=SIZE：設定多部分上傳作業中每個區塊的大小。
如果檔案大於 SIZE，系統會自動以多執行緒多部分上傳方式上傳。使用傳統方法上傳較小的檔案。SIZE 的單位為 MB。預設的區塊大小為 15 MB。允許的最小區塊大小為 5 MB，最大為 5 GB。
從儲存空間 bucket 下載物件
控制台
- 在導覽選單中，按一下「物件儲存空間」。
- 按一下包含物件的值區名稱。
- 選取要下載的物件名稱旁的核取方塊。
- 點選 [下載]。
CLI
如要從值區取得物件：
gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/OBJECT LOCAL_FILE_TO_SAVE
如要將 bucket 中的所有文字檔下載到目前目錄：
gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/*.txt .
如要從值區將文字檔案 abc.txt 下載至目前目錄，請執行下列指令：
gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/abc.txt .
如要下載舊版檔案，請先列出檔案的所有版本：
gdcloud storage ls s3://FULLY_QUALIFIED_BUCKET_NAME/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://FULLY_QUALIFIED_BUCKET_NAME/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .
使用自訂 AEADKey
如要進一步自訂，您可以建立自己的 AEADKey，並在加密 bucket 中的物件時直接使用。這樣一來，您就能完全掌控加密金鑰，略過預設值。按照「建立金鑰」一文的說明建立新的 AEADKey，並確認該金鑰與您要使用的值區位於同一個 Namespace。然後，每次傳送要求時，請確保 HEADER 已設定 x-amz-server-side-encryption: SSE-KMS 和 x-amz-server-side-encryption-aws-kms-key-id: NAMESPACE_NAME/AEADKey_NAME