本頁面說明如何對雙區域 bucket 使用強化型複製功能。
必要的角色
如要取得使用強化型複製功能所需的權限,請要求系統管理員授予您 bucket 的 Storage 管理員 (roles/storage.admin) IAM 角色。
這個預先定義的角色具備使用 Turbo 複製功能所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
storage.buckets.getstorage.buckets.updatestorage.buckets.list- 只有在您打算使用Google Cloud 控制台執行本頁操作說明時,才需要這項權限。
如需授予 bucket 角色的操作說明,請參閱「在 bucket 上設定及管理 IAM 政策」。
設定強化型複製功能
如要為現有 bucket 啟用或停用強化型複製功能,請按照下列指示操作:
控制台
- 前往 Google Cloud 控制台的「Cloud Storage bucket」頁面。
在 bucket 清單中,按一下所需 bucket 的名稱。
按一下 [設定] 標籤。
在「Replication」列中,按一下「Edit」。
顯示的視窗會指出您即將啟用強化型複製功能或停用強化型複製功能。
按一下「儲存」確認新設定。
指令列
使用 gcloud storage buckets update 指令,並加上 --rpo 旗標:
gcloud storage buckets update gs://BUCKET_NAME --rpo=STATE
其中:
BUCKET_NAME是相關 bucket 的名稱。例如:my-bucket。STATE是ASYNC_TURBO(啟用強化型複製功能) 或DEFAULT(停用強化型複製功能)。
如果成功,回應如下所示:
Updating gs://my-bucket/... Completed 1
用戶端程式庫
C++
詳情請參閱「Cloud Storage C++ API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
以下範例會在 bucket 上啟用強化型複製功能:
下列範例會啟用 bucket 的預設複製功能:
C#
詳情請參閱 Cloud Storage C# API 參考文件。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
以下範例會在 bucket 上啟用強化型複製功能:
下列範例會啟用 bucket 的預設複製功能:
Go
詳情請參閱 Cloud Storage Go API 參考文件。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
下列範例會為 bucket 啟用強化型複製功能:
以下範例會為 bucket 啟用預設複製功能:
Java
詳情請參閱 Cloud Storage Java API 參考文件。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
以下範例會在 bucket 上啟用強化型複製功能:
下列範例會啟用 bucket 的預設複製功能:
Node.js
詳情請參閱 Cloud Storage Node.js API 參考文件。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
下列範例會為 bucket 啟用強化型複製功能:
下列範例會啟用 bucket 的預設複製功能:
PHP
詳情請參閱「Cloud Storage PHP API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
以下範例會在 bucket 上啟用強化型複製功能:
下列範例會啟用 bucket 的預設複製功能:
Python
詳情請參閱「Cloud Storage Python API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
以下範例會在 bucket 上啟用強化型複製功能:
下列範例會啟用 bucket 的預設複製功能:
Ruby
詳情請參閱 Cloud Storage Ruby API 參考文件。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
下列範例會啟用 bucket 的強化型複製功能:
以下範例會為 bucket 啟用預設複製功能:
Rust
以下範例會在 bucket 上啟用強化型複製功能:
以下範例會在 bucket 上啟用預設複寫:
REST API
JSON API
安裝並初始化 gcloud CLI,以便為
Authorization標頭產生存取權杖。建立包含下列資訊的 JSON 檔案:
{ "rpo": "STATE" }
其中
STATE是ASYNC_TURBO(啟用強化型複製功能) 或DEFAULT(停用強化型複製功能)。使用
cURL來透過PATCH值區要求呼叫 JSON API:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"
其中:
JSON_FILE_NAME是您在步驟 2 建立的 JSON 檔案路徑。BUCKET_NAME是相關 bucket 的名稱。例如:my-bucket。
如果要求成功,系統不會傳回任何回應。
XML API
這項功能無法透過 XML API 管理。請改用 JSON API。
查看 bucket 的複製狀態
如要查看 bucket 的復原點目標 (RPO) 或複製狀態,請完成下列操作:
控制台
- 前往 Google Cloud 控制台的「Cloud Storage bucket」頁面。
在 bucket 清單中,按一下要驗證的 bucket 名稱。
按一下 [設定] 標籤。
如果 bucket 已啟用強化型複製功能,「複製」會設為「強化型」。
指令列
使用 gcloud storage buckets describe 指令搭配 --format 旗標:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(rpo)"
其中:
BUCKET_NAME是相關 bucket 的名稱。例如:my-bucket。
如果成功,回應會類似以下範例:
rpo: ASYNC_TURBO
用戶端程式庫
C++
詳情請參閱 Cloud Storage C++ API 參考文件。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
C#
詳情請參閱 Cloud Storage C# API 參考文件。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
Go
詳情請參閱 Cloud Storage Go API 參考文件。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
Java
詳情請參閱「Cloud Storage Java API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
Node.js
詳情請參閱「Cloud Storage Node.js API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
PHP
詳情請參閱「Cloud Storage PHP API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
Python
詳情請參閱 Cloud Storage Python API 參考文件。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
Ruby
詳情請參閱 Cloud Storage Ruby API 參考文件。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
Rust
REST API
JSON API
安裝並初始化 gcloud CLI,以便為
Authorization標頭產生存取權杖。使用
cURL呼叫 JSON API,並傳送GETBucket 要求:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"
其中
BUCKET_NAME是相關 bucket 的名稱。例如:my-bucket。回應類似下列範例:
{ "name": "my-bucket", "projectNumber": "234...", ... "rpo": "ASYNC_TURBO" }
請留意
rpo鍵。值ASYNC_TURBO表示已啟用強化型複製功能。DEFAULT表示已套用預設複製作業。雙區域和多區域 bucket 一律會顯示rpo欄位,但單一區域 bucket 不會。
XML API
這項功能無法透過 XML API 管理。請改用 JSON API。
後續步驟
- 進一步瞭解強化型複製功能。
- 進一步瞭解強化型複製功能定價。
- 瞭解監控值區成效的指標,包括複製效能。
- 瞭解如何使用 Cloud Monitoring 警告,根據指定指標建立警告政策,並管理相關通知。