使用跨 bucket 複製作業

本頁面說明如何使用跨 bucket 複製功能,透過 Storage 移轉服務,以非同步方式將新的和更新後的物件從來源 bucket 複製到目的地 bucket。使用跨 bucket 複製功能時,您會建立及管理複製工作,這是 Storage 移轉服務中的一種工作。

事前準備

如要使用跨 bucket 複製功能,請先完成必要步驟。如需操作說明,請參閱 Storage 移轉服務說明文件中的「事前準備」一節。

建立複製工作

控制台

使用Google Cloud 控制台建立跨 bucket 複製工作時,Storage 移轉服務代理會自動取得來源 bucket 的storage.legacyBucketOwner角色,以及目的地 bucket 的storage.legacyBucketWriter角色。

使用 Google Cloud 控制台時,您可以在建立 bucket 的過程中,為現有或新的 bucket 建立複製工作。

如要為新 bucket 建立複製工作,請按照建立新 bucket 的操作說明進行。

如要為現有 bucket 建立複製工作,請完成下列步驟:

  1. 前往 Google Cloud 控制台的「Cloud Storage bucket」頁面。

    前往「Buckets」(值區) 頁面

  2. 在 bucket 清單中,點選要複製物件的來源 bucket 名稱。

  3. 在「Bucket details」(bucket 詳細資料) 頁面中,按一下「Configuration」(設定) 分頁標籤。

  4. 找出「Cross-bucket replication」(跨 bucket 複製) 選項,然後按一下 「Edit」(編輯)。

  5. 在開啟的「Edit cross-bucket replication」(編輯跨 bucket 複製作業) 窗格中,按一下「Add a destination」(新增目的地)。

  6. 在「Choose a destination」(選擇目的地) 部分,選取目的地 bucket,然後點選「Next」(下一步)。

  7. 在「Choose replication settings」(選擇複製設定) 部分,執行下列操作:

    • 選用:如要依物件名稱前置字串篩選要複製的物件,請在「Choose which objects to replicate」(選擇要複製的物件) 專區中,勾選「Replicate objects based on prefix」(依據前置字串複製物件) 核取方塊。

      • 如要依據前置字串納入物件,請在「Include objects with prefix」(納入有這個前置字串的物件) 區段中輸入前置字串,然後按一下「 Add a prefix」(新增前置字串)。

      • 如要依前置字串排除物件,請在「Exclude objects with prefix」(排除有這個前置字串的物件) 專區輸入前置字串,然後按一下 「Add a prefix」(新增前置字串)。

    • 選用:如要為複製的物件設定儲存空間級別,請在「Set storage class for replicated objects」(為複製的物件設定儲存空間級別) 專區的選單中選取儲存空間級別。

      如果略過這個步驟,複製的物件預設會使用目的地 bucket 的儲存空間級別。

    1. 按一下 [儲存]。

指令列

如要瞭解如何使用 Google Cloud CLI 建立複製工作,請參閱「使用 Google Cloud CLI 建立複製工作」。

REST API

JSON API

如需使用 JSON API 建立複製工作的操作說明,請參閱「使用 JSON API 建立複製工作」。

如要查看複製工作的狀態,請查看 Storage 移轉服務的 Cloud Logging 服務記錄。

列出複製工作

控制台

您無法使用 Google Cloud 控制台列出複製工作,如要瞭解如何一次查看一項複製工作,請參閱「查看複製工作」。

指令列

如要瞭解如何使用 Google Cloud CLI 列出複製工作,請參閱「使用 Google Cloud CLI 列出複製工作」。

REST API

JSON API

如要瞭解如何使用 JSON API 列出複製工作,請參閱「使用 JSON API 列出複製工作」。

查看複製工作

控制台

  1. 前往 Google Cloud 控制台的「Cloud Storage bucket」頁面。

    前往「Buckets」(值區) 頁面

  2. 在 bucket 清單中,點選要查看跨 bucket 複製工作的來源 bucket 名稱。

  3. 在「Bucket details」(bucket 詳細資料) 頁面中,按一下「Configuration」(設定) 分頁標籤。

  4. 找出「Cross-bucket replication」(跨 bucket 複製) 選項,然後按一下 「Edit」(編輯)。

    「Edit cross-bucket replication」(編輯跨 bucket 複製作業) 窗格隨即顯示,當中列出每個目的地 bucket 的複製工作。

在「Buckets」頁面中,您可以查看「Replication」(複製) 欄,瞭解 bucket 是否有強化型複製工作或跨 bucket 複製工作正在執行。如要瞭解如何顯示「Replication」(複製) 欄,請參閱「顯示資料欄」。

指令列

如要瞭解如何使用 Google Cloud CLI 查看複製工作,請參閱「使用 Google Cloud CLI 查看複製工作」。

REST API

JSON API

如需 JSON API 操作說明,瞭解如何查看複製工作,請參閱「使用 JSON API 查看複製工作」。

更新複製工作

您可以更新複製工作的下列欄位:

  • 複製工作的說明

  • 執行複製工作的設定

  • 發布至 Pub/Sub 的通知設定

  • 複製工作作業的記錄行為

  • 複製工作的狀態 (已啟用、已停用或已刪除)

控制台

使用 Google Cloud 控制台時,只能透過暫停或取消暫停工作來更新複製工作。

  1. 前往 Google Cloud 控制台的「Cloud Storage bucket」頁面。

    前往「Buckets」(值區) 頁面

  2. 在 bucket 清單中,點選要暫停或取消暫停複製作業的來源 bucket 名稱。

  3. 在「Bucket details」(bucket 詳細資料) 頁面中,按一下「Configuration」(設定) 分頁標籤。

  4. 找出「Cross-bucket replication」(跨 bucket 複製) 選項,然後按一下 「Edit」(編輯)。

  5. 在顯示的「Edit cross-bucket replication」(編輯跨 bucket 複製作業) 窗格中,找出要更新的複製工作,然後按一下旁邊的 「Pause」(暫停) 或 「Unpause」(取消暫停)。

指令列

如要瞭解如何使用 Google Cloud CLI 更新複製工作,請參閱「使用 Google Cloud CLI 更新複製工作」。

REST API

JSON API

如要瞭解如何使用 JSON API 更新複製工作,請參閱「使用 JSON API 更新複製工作」。

刪除複製工作

控制台

  1. 前往 Google Cloud 控制台的「Cloud Storage bucket」頁面。

    前往「Buckets」(值區) 頁面

  2. 在 bucket 清單中,點選要停止複製的來源 bucket 名稱。

  3. 在「Bucket details」(bucket 詳細資料) 頁面中,按一下「Configuration」(設定) 分頁標籤。

  4. 找出「Cross-bucket replication」(跨 bucket 複製) 選項,然後按一下 「Edit」(編輯)。

  5. 在顯示的「Edit cross-bucket replication」(編輯跨 bucket 複製作業) 窗格中,按一下要刪除的複製作業旁的 「Delete」(刪除)。

  6. 在隨即顯示的對話方塊中,按一下「確認」。

指令列

如需刪除複製工作的 Google Cloud CLI 操作說明,請參閱「使用 Google Cloud CLI 刪除複製工作」。

REST API

JSON API

如需 JSON API 操作說明,瞭解如何刪除複製工作,請參閱「使用 JSON API 刪除複製工作」。

後續步驟

監控複製的物件。