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.getIamPolicystorage.managedFolders.liststorage.managedFolders.get
在目的地 bucket 或代管資料夾中:
storage.managedFolders.setIamPolicystorage.managedFolders.liststorage.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」。
疑難排解
如需建立及管理代管資料夾的說明,請參閱「疑難排解」頁面。