使用跨存储桶复制

本页面介绍如何使用跨存储桶复制,该功能使用 Storage Transfer Service 将新对象和更新后的对象从源存储桶异步复制到目标存储桶。使用跨存储桶复制时,您需要创建和管理复制作业,这是 Storage Transfer Service 中的一种作业类型。

准备工作

如需使用跨存储桶复制,您必须完成前提步骤。如需查看相关说明,请参阅 Storage Transfer Service 文档中的准备工作

创建复制作业

控制台

当您使用 Google Cloud 控制台创建跨存储桶复制作业时,系统会自动向 Storage Transfer Service 服务代理授予源存储桶的 storage.legacyBucketOwner 角色和目标存储桶的 storage.legacyBucketWriter 角色。

使用 Google Cloud 控制台时,您可以在创建存储桶过程中为现有存储桶或新存储桶创建复制作业。

如需为新存储桶创建复制作业,请按照创建新存储桶中的说明操作。

如需为现有存储桶创建复制作业,请完成以下步骤:

  1. 在 Google Cloud 控制台中,进入 Cloud Storage 存储桶页面。

    进入“存储桶”

  2. 在存储桶列表中,点击您要复制对象的源存储桶的名称。

  3. 存储桶详情页面上,点击配置标签页。

  4. 找到跨存储桶复制选项,然后点击 修改

  5. 在打开的修改跨存储桶复制窗格中,点击添加目标

  6. 选择目标部分中,选择目标存储桶,然后点击下一步

  7. 选择复制设置部分中,执行以下操作:

    • 可选:如需按对象名称前缀过滤要复制的对象,请在 Choose which objects to replicate 部分中选中根据前缀复制对象复选框。

      • 如需按前缀包含对象,请在包含带前缀的对象部分中输入前缀,然后点击 添加前缀

      • 如需按前缀排除对象,请在排除带前缀的对象部分中输入前缀,然后点击 添加前缀

    • 可选:如需为复制的对象设置存储类别,请从为复制的对象设置存储类别部分的相应菜单中选择一个存储类别。

      如果您跳过此步骤,则复制的对象会默认使用目标存储桶的存储类别。

    1. 点击保存

命令行

如需了解如何使用 Google Cloud CLI 创建复制作业,请参阅使用 Google Cloud CLI 创建复制作业

REST API

JSON API

如需了解如何使用 JSON API 创建复制作业,请参阅使用 JSON API 创建复制作业

如需检查复制作业的状态,请查看适用于 Storage Transfer Service 日志的 Cloud Logging

列出复制作业

控制台

您无法使用 Google Cloud 控制台列出复制作业。如需了解如何一次查看单个复制作业,请参阅查看复制作业

命令行

如需了解如何使用 Google Cloud CLI 列出复制作业,请参阅使用 Google Cloud CLI 列出复制作业

REST API

JSON API

如需了解如何使用 JSON API 列出复制作业,请参阅使用 JSON API 列出复制作业

查看复制作业

控制台

  1. 在 Google Cloud 控制台中,进入 Cloud Storage 存储桶页面。

    进入“存储桶”

  2. 在存储桶列表中,点击您要查看其跨存储桶复制作业的源存储桶的名称。

  3. 存储桶详情页面上,点击配置标签页。

  4. 找到跨存储桶复制选项,然后点击 修改

    系统随即会显示修改跨存储桶复制窗格,其中会显示每个目标存储桶的复制作业。

存储桶页面上,您可以查看复制列,该列显示了存储桶是否正在运行增强型复制作业或跨存储桶复制作业。如需了解如何显示复制列,请参阅显示列

命令行

如需了解如何使用 Google Cloud CLI 查看复制作业,请参阅使用 Google Cloud CLI 查看复制作业

REST API

JSON API

如需了解如何使用 JSON API 查看复制作业,请参阅使用 JSON API 查看复制作业

更新复制作业

您可以更新复制作业的以下字段:

  • 复制作业的说明

  • 用于运行复制作业的配置

  • 发布到 Pub/Sub 的通知的配置

  • 复制作业操作的日志记录行为

  • 复制作业的状态(已启用、已停用或已删除)

控制台

使用 Google Cloud 控制台时,您只能通过暂停或解除暂停复制作业来更新复制作业。

  1. 在 Google Cloud 控制台中,进入 Cloud Storage 存储桶页面。

    进入“存储桶”

  2. 在存储桶列表中,点击您要暂停或解除暂停复制的源存储桶的名称。

  3. 存储桶详情页面上,点击配置标签页。

  4. 找到跨存储桶复制选项,然后点击 修改

  5. 在显示的修改跨存储桶复制窗格中,点击您要更新的复制作业旁边的 暂停 解除暂停

命令行

如需了解如何使用 Google Cloud CLI 更新复制作业,请参阅使用 Google Cloud CLI 更新复制作业

REST API

JSON API

如需了解如何使用 JSON API 更新复制作业,请参阅使用 JSON API 更新复制作业

删除复制作业

控制台

  1. 在 Google Cloud 控制台中,进入 Cloud Storage 存储桶页面。

    进入“存储桶”

  2. 在存储桶列表中,点击您要停止复制的源存储桶的名称。

  3. 存储桶详情页面上,点击配置标签页。

  4. 找到跨存储桶复制选项,然后点击 修改

  5. 在显示的修改跨存储桶复制窗格中,点击您要删除的复制作业旁边的 删除

  6. 在显示的对话框中,点击确认

命令行

如需了解如何使用 Google Cloud CLI 删除复制作业,请参阅使用 Google Cloud CLI 删除复制作业

REST API

JSON API

如需了解如何使用 JSON API 删除复制作业,请参阅使用 JSON API 删除复制作业