传输 Cloud Storage 托管文件夹

Cloud Storage 托管文件夹可对 Cloud Storage 存储桶中的对象提供精细访问权限控制。可以在使用统一存储桶级访问权限的存储桶中的文件夹级别设置权限。使用 Storage Transfer Service 在 Cloud Storage 存储桶之间转移对象时,可以保留这些托管文件夹权限。

限制

以下限制适用于托管文件夹的转移:

  • 源存储桶和目标存储桶都必须使用统一存储桶级访问权限。
  • 托管式文件夹转移作业不支持 deleteObjectsUniqueInSink 或 deleteObjectsFromSourceAfterTransfer 选项。
  • 目标存储桶或其项目上不得存在使用存储桶资源类型 (storage.googleapis.com/Bucket) 或对象资源类型 (storage.googleapis.com/Object) 的 IAM 条件。如果项目中的任何存储桶具有使用其中任一资源类型的 IAM 条件,则无法将托管文件夹转移到该项目中的任何存储桶,即使该条件稍后被移除也是如此。
  • 不支持事件驱动型转移作业。
  • 不支持清单转移作业。

IAM 权限

Storage Transfer Service 服务代理需要以下 Google Cloud Identity and Access Management (IAM) 权限。

对于来源和目的地,权限可以在存储桶级层设置,也可以在托管文件夹中设置。如需在目标托管文件夹上设置权限,该文件夹必须已存在。

我们不建议在项目级层设置托管文件夹权限;如需了解更多信息,请参阅安全注意事项。

在源存储桶或托管文件夹上:

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

在目标存储桶或托管文件夹上:

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

除了 Storage Transfer Service 所需的标准权限之外,还需要以下权限:

如需授予所需的托管式文件夹权限,请创建自定义角色,其中仅包含所需的权限。

创建托管文件夹转移作业

如需创建包含托管文件夹的转移作业,请在 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 Transfer Service 的 Cloud Logging。

问题排查

如需获得创建和管理托管文件夹方面的帮助,请参阅问题排查页面。