移轉 Cloud Storage 代管資料夾

Cloud Storage 代管資料夾可提供精細的存取控管,以控管 Cloud Storage bucket 中物件的存取權。在採用統一 bucket 層級存取權的 bucket 中,您可以在資料夾層級設定權限。使用 Storage 移轉服務在 Cloud Storage bucket 之間移轉物件時,可以保留這些代管資料夾權限。

限制

轉移代管資料夾時,須遵守下列限制:

  • 來源和目的地 bucket 都必須使用統一 bucket 層級存取權。
  • 代管資料夾移轉作業不支援 deleteObjectsUniqueInSink 或 deleteObjectsFromSourceAfterTransfer 選項。
  • 目的地 bucket 或其專案不得有使用 bucket 資源類型 (storage.googleapis.com/Bucket) 或 object 資源類型 (storage.googleapis.com/Object) 的 IAM 條件。如果專案中的任何 bucket 有使用上述任一資源類型的 IAM 條件,則無法將代管資料夾轉移至該專案中的任何 bucket,即使之後移除條件也一樣。
  • 不支援事件導向移轉作業。
  • 不支援資訊清單轉移作業。

IAM 權限

Storage 移轉服務服務代理需要下列 Google Cloud Identity and Access Management (IAM) 權限。

來源和目的地都可以在 bucket 層級設定權限,或在代管資料夾設定權限。如要設定目的地代管資料夾的權限,該資料夾必須已存在。

不建議在專案層級設定代管資料夾權限,詳情請參閱「安全性考量」。

在來源 bucket 或代管資料夾上:

  • storage.managedFolders.getIamPolicy
  • storage.managedFolders.list
  • storage.managedFolders.get

在目的地 bucket 或代管資料夾中:

  • storage.managedFolders.setIamPolicy
  • storage.managedFolders.list
  • storage.managedFolders.create

除了 Storage 移轉服務所需的標準權限外,還需要下列權限:

如要授予必要的代管資料夾權限,請建立自訂角色,並僅授予必要權限。

建立代管資料夾轉移作業

如要建立包含代管資料夾的移轉作業,請在 transferSpec 中指定 managedFolderTransferEnabled: true。您可以視需要指定 path 值,只移轉特定代管資料夾。

POST https://storagetransfer./v1/transferJobs
{
  "name": "transferJobs/NAME",
  "projectId": "PROJECT_ID",
  "transferSpec": {
    "gcsDataSource": {
      "bucketName": "SOURCE_BUCKET",
      "path": "SOURCE_PATH",
      "managedFolderTransferEnabled": true
    },
    "gcsDataSink": {
      "bucketName": "DESTINATION_BUCKET",
      "path": "DESTINATION_PATH"
    }
  },
  "status": "ENABLED"
}

如果來源和目的地未設定正確的代管移轉權限,移轉作業就會失敗。

如要瞭解如何使用 REST API 建立移轉作業,請參閱「建立移轉作業」或 transferJobs.create 參考資料。

安全性考量

將代管資料夾權限授予服務代理,該帳戶就能修改目的地資料夾的 IAM 政策。如果是在專案層級授予角色,則可修改所有資料夾的 IAM 政策。這會造成安全風險:具備工作編輯權限的使用者,可能會利用這項功能將權限授予惡意行為人。為降低這項風險,建議您在專屬的 Google Cloud 專案中,隔離代管資料夾移轉作業。

Cloud Logging

Cloud Logging 會記錄代管資料夾動作。詳情請參閱「Storage 移轉服務的 Cloud Logging」。

疑難排解

如需建立及管理代管資料夾的說明,請參閱「疑難排解」頁面。