本頁面說明如何使用跨 bucket 複製功能,透過 Storage 移轉服務,以非同步方式將新的和更新後的物件從來源 bucket 複製到目的地 bucket。使用跨 bucket 複製功能時,您會建立及管理複製作業,這類作業屬於 Storage 移轉服務中的作業。
事前準備
如要使用跨儲存空間複寫功能,請務必完成必要步驟。如需操作說明,請參閱 Storage 移轉服務說明文件中的「事前準備」一節。
建立複製工作
控制台
使用Google Cloud 控制台建立跨 bucket 複製工作時,Storage 移轉服務代理會自動取得來源 bucket 的storage.legacyBucketOwner角色,以及目的地 bucket 的storage.legacyBucketWriter角色。
使用 Google Cloud 控制台時,您可以為現有值區建立複寫工作,也可以在建立值區時為新值區建立複寫工作。
如要為新 bucket 建立複製工作,請按照建立新 bucket 的操作說明進行。
如要為現有值區建立複寫作業,請完成下列步驟:
- 前往 Google Cloud 控制台的「Cloud Storage bucket」頁面。
在 bucket 清單中,點選要複製物件的來源 bucket 名稱。
在「Bucket details」(值區詳細資料) 頁面中,按一下「Configuration」(設定) 分頁標籤。
找出「Cross-bucket replication」(跨 bucket 複製) 選項,然後按一下 「Edit」(編輯)。
在開啟的「Edit cross-bucket replication」(編輯跨 bucket 複製作業) 窗格中,按一下「Add a destination」(新增目的地)。
在「選擇目的地」部分中,選取目的地 bucket,然後按一下「下一步」。
在「選擇複製設定」部分,執行下列操作:
選用:如要依物件名稱前置字串篩選要複製的物件,請在「Choose which objects to replicate」(選擇要複製的物件) 專區中,勾選「Replicate objects based on prefix」(依據前置字串複製物件) 核取方塊。
如要依據前置字串加入物件,請在「納入有這個前置字串的物件」部分輸入前置字串,然後點按「新增前置字串」。
如要依前置字串排除物件,請在「Exclude objects with prefix」(排除有這個前置字串的物件) 專區輸入前置字串,然後按一下 「Add a prefix」(新增前置字串)。
選用:如要為複製的物件設定儲存空間級別,請在「Set storage class for replicated objects」(為複製的物件設定儲存空間級別) 專區的選單中選取儲存空間級別。
如果略過這個步驟,複製的物件預設會使用目的地 bucket 的儲存空間級別。
- 按一下 [儲存]。
指令列
如要瞭解如何使用 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 列出複製工作」。
查看複製工作
控制台
- 前往 Google Cloud 控制台的「Cloud Storage bucket」頁面。
在 bucket 清單中,點選要查看跨 bucket 複製工作的來源 bucket 名稱。
在「Bucket details」(bucket 詳細資料) 頁面中,按一下「Configuration」(設定) 分頁標籤。
找出「Cross-bucket replication」(跨 bucket 複製) 選項,然後按一下 「Edit」(編輯)。
「Edit cross-bucket replication」(編輯跨 bucket 複製作業) 窗格隨即顯示,當中列出每個目的地 bucket 的複製工作。
在「Bucket」頁面中,您可以查看「複製」欄,瞭解 bucket 是否正在執行強化型複製工作或跨 bucket 複製工作。如要瞭解如何顯示「Replication」(複製) 欄,請參閱「顯示資料欄」。
指令列
如需透過 Google Cloud CLI 查看複寫作業的相關操作說明,請參閱「使用 Google Cloud CLI 查看複寫作業」。
REST API
JSON API
如需 JSON API 操作說明,瞭解如何查看複製工作,請參閱「使用 JSON API 查看複製工作」。
更新複製工作
您可以更新複製工作的下列欄位:
複製工作的說明
執行複製作業的設定
發布至 Pub/Sub 的通知設定
複製工作作業的記錄行為
複製工作的狀態 (已啟用、已停用或已刪除)
控制台
使用 Google Cloud 控制台時,只能透過暫停或取消暫停工作來更新複製工作。
- 前往 Google Cloud 控制台的「Cloud Storage bucket」頁面。
在 bucket 清單中,點選要暫停或取消暫停複製作業的來源 bucket 名稱。
在「Bucket details」(bucket 詳細資料) 頁面中,按一下「Configuration」(設定) 分頁標籤。
找出「跨儲存空間複寫」選項,然後按一下「編輯」。
在隨即顯示的「Edit cross-bucket replication」(編輯跨儲存空間複寫) 窗格中,按一下要更新的複寫工作旁邊的「暫停」圖示 或「取消暫停」圖示 。
指令列
如要瞭解如何使用 Google Cloud CLI 更新複製工作,請參閱「使用 Google Cloud CLI 更新複製工作」。
REST API
JSON API
如要瞭解如何使用 JSON API 更新複製工作,請參閱「使用 JSON API 更新複製工作」。
刪除複製工作
控制台
- 前往 Google Cloud 控制台的「Cloud Storage bucket」頁面。
在 bucket 清單中,點選要停止複製的來源 bucket 名稱。
在「Bucket details」(值區詳細資料) 頁面中,按一下「Configuration」(設定) 分頁標籤。
找出「Cross-bucket replication」(跨 bucket 複製) 選項,然後按一下 「Edit」(編輯)。
在隨即顯示的「編輯跨儲存空間複寫」窗格中,找出要刪除的複寫工作,然後按一下旁邊的 「刪除」。
在隨即顯示的對話方塊中,按一下「確認」。
指令列
如需透過 Google Cloud CLI 刪除複寫作業的相關操作說明,請參閱「使用 Google Cloud CLI 刪除複寫作業」。
REST API
JSON API
如需 JSON API 操作說明,瞭解如何刪除複製工作,請參閱「使用 JSON API 刪除複製工作」。