全球和區域服務端點

本頁說明 Spanner 的全域和區域服務端點，以及如何使用這些端點。

服務端點是指定 API 服務網路位址的基準網址。Spanner 具有全域和區域端點。您可以透過全域或區域服務端點，向 Spanner 發出要求。

如果沒有嚴格的區域限制要求，請使用全球端點。雖然資料會儲存在所選區域，但處理作業可能會在該區域以外進行。Spanner 的全域端點為 spanner.googleapis.com。預設 API 端點會存取全域端點。

區域端點會強制執行區域限制。資料會儲存並處理於同一區域。Spanner 的區域端點可確保並保證儲存及處理的資料僅限於資料庫所在的 Spanner 區域執行個體設定。如果必須限制及控管資料位置，以符合法規要求，請使用區域端點。您無法使用區域端點存取屬於不同執行個體設定的資源。您必須先在區域執行個體設定中建立執行個體，才能使用該執行個體設定的區域端點。

如要瞭解可使用的區域，請參閱可使用區域端點的區域。無論使用哪個端點，基礎 Spanner 儲存空間政策都不會變更。

區域端點的安全性和法規遵循

相較於全域端點，使用 Spanner 區域端點的優點在於，區域端點提供區域隔離和保護功能，可滿足安全性、法規遵循和監管要求。

您只能使用屬於該區域執行個體設定的區域端點。舉例來說，如果您存取的執行個體屬於 us-central1 區域執行個體設定，就無法使用 spanner.me-central2.rep.googleapis.com 處理要求。系統會拒絕要求，並傳回 InvalidRegionalRequest 錯誤。

區域端點的限制

您無法透過區域端點存取雙區域或多區域執行個體設定。如要存取雙區域或多區域執行個體設定，請務必使用全域端點。舉例來說，如果您在多區域執行個體設定 nam7 中有執行個體，就無法使用區域端點 spanner.us-central1.rep.googleapis.com 將要求傳送至 nam7 中的執行個體。

如果您有使用任何執行個體資源區域端點的有效要求，移動執行個體會影響使用區域端點的所有要求，因為區域強制執行會封鎖跨區域執行個體的存取權。使用全域端點的請求不受影響。

區域端點命名慣例

Spanner 地區端點名稱遵循與地區執行個體設定名稱相同的命名慣例。區域端點的格式為 spanner.REGION.rep.googleapis.com。舉例來說，達曼的地區執行個體設定名稱和地區端點名稱都是 me-central2。因此，地區端點為 spanner.me-central2.rep.googleapis.com。

詳情請參閱「地區端點的可用區域」一文。

指定區域端點

您可以使用 Google Cloud CLI、REST 或 RPC API 要求，指定 Spanner 地區端點。

gcloud

如要指定地區端點並覆寫全域端點，請執行下列指令：

gcloud config set api_endpoint_overrides/spanner https://spanner.REGION.rep.googleapis.com/

提供下列值：

REGION
要設定地區端點的區域。例如：me-central2。

舉例來說，如要將區域端點設為 me-central2，請執行下列指令：

gcloud config set api_endpoint_overrides/spanner https://spanner.me-central2.rep.googleapis.com/

如要將區域端點重新設定為全域端點，請執行下列指令：

gcloud config unset api_endpoint_overrides/spanner

REST API

預設 API 端點會存取全域端點。如要使用地區端點，請按照下列模式，將端點設定為地區端點的位址：

https://spanner.REGION.rep.googleapis.com

舉例來說，如要在 Dammam (me-central2) 區域執行個體設定中強制執行資料保證，請使用：

  https://spanner.me-central2.rep.googleapis.com

詳情請參閱 REST API 和區域端點的可用區域。

RPC API

預設 API 端點會存取全域端點。如要使用地區端點，請按照下列模式，將端點設定為地區端點的位址：

spanner.REGION.rep.googleapis.com

舉例來說，如要在 Dammam (me-central2) 區域執行個體設定中強制執行資料保證，請使用：

spanner.me-central2.rep.googleapis.com

詳情請參閱 RPC API 和區域端點的可用地區。

可使用區域端點的區域

Spanner 區域端點適用於下列區域：

基本區域名稱 地區說明
美洲
us-central1 愛荷華州
us-central2 奧克拉荷馬州
us-east1 南卡羅來納州
us-east4 北維吉尼亞州
us-east5 哥倫布
us-east7 阿拉巴馬州
us-south1 達拉斯
us-west1 奧勒岡州
us-west2 洛杉磯
us-west3 鹽湖城
us-west4 拉斯維加斯
us-west8 鳳凰城
中東地區
me-central2 達曼
歐洲
europe-west8 米蘭

限制全球 API 端點用量

如要強制使用區域端點，請使用constraints/gcp.restrictEndpointUsage機構政策限制，封鎖對全域 API 端點的要求。詳情請參閱「限制端點用量」。

後續步驟