本頁面說明如何在 Google Distributed Cloud (GDC) 實體隔離儲存空間 bucket 中複製、修改及移動物件。
事前準備
Storage bucket 是特定專案範圍內的資源。專案就像容器,可將 bucket 分組,並透過 Management API 伺服器管理。您必須先建立新專案,或選取具備足夠權限的現有專案,才能執行這個頁面的作業。
必要的 IAM 角色
請與 IAM 專案管理員聯絡,要求在專案命名空間中取得下列角色:
- Bucket 專案管理員 (
project-bucket-admin):建立、更新及刪除儲存空間 bucket。 - Bucket 物件專案檢視者 (
project-bucket-object-viewer):查看及檢查儲存空間 bucket 和物件的詳細資料。
詳情請參閱「授予 bucket 存取權」。
準備環境
如要對管理 API 伺服器或全域 API 伺服器執行指令,請按照下列步驟操作:
- 如果沒有可用檔案,請登入並產生可用於可用區 Management API 伺服器的 kubeconfig 檔案。
- 如果是雙可用區 bucket,請按照下列步驟操作:
- 請向基礎架構運作人員 (IO) 確認,已為配對可用區建立
BucketLocationConfig自訂資源。 - 產生全域 API 伺服器的 kubeconfig 檔案。
- 請向基礎架構運作人員 (IO) 確認,已為配對可用區建立
複製、修改及移動物件
複製物件:
gdcloud storage cp FILE [FILE...] s3://FULLY_QUALIFIED_BUCKET_NAME [/PREFIX ]
修改物件的中繼資料:
gdcloud storage objects update s3://FULLY_QUALIFIED_BUCKET_NAME1/OBJECT --custom-metadata=Key1=Value1
移動物件:
移動物件時,物件副本會移至其他位置,可能在同一個 bucket 中,也可能在同一個 bucket 的其他路徑。之後,原始物件就會刪除。
gdcloud storage mv s3://FULLY_QUALIFIED_BUCKET_NAME1/OBJECT1 s3://FULLY_QUALIFIED_BUCKET_NAME2[/OBJECT2]