全球和区域级服务端点

本页面介绍 Spanner 的全球和区域服务端点，以及 如何使用它们。

服务端点是一个基础映像， 用于指定 API 服务的网络地址的网址。Spanner 同时具有全球端点和区域端点您可以使用全球性或区域性服务 端点向 Spanner 发出请求。

如果您没有严格的区域限制，请使用全球端点 限制要求。虽然数据存储在所选区域内， 数据可能在区域外进行处理。此区域的全球端点 Spanner 为 spanner.googleapis.com。默认 API 端点 访问全球端点。

区域端点会强制执行区域限制。系统会存储数据 都是在同一个区域内处理的Spanner 的区域端点 确保存储和处理的数据仅限 Spanner 区域实例配置 数据库的存储位置如果您的数据位置必须满足以下条件，请使用区域端点 进行限制和控制，以遵守监管要求。您不能使用 区域端点，用于访问属于其他实例的资源 配置。您必须先在区域级 然后才能使用区域端点 实例配置。

Spanner 区域端点仅在达曼可用 me-central2 区域实例配置。使用 无论发生何种情况，Spanner 存储政策 端点。

区域端点的安全性和合规性

与全球 区域级端点提供区域级隔离功能 以满足安全性、合规性和监管要求。

您只能使用属于该区域实例的区域端点 配置。例如，您不能使用 spanner.me-central2.rep.googleapis.com 来处理请求，前提是 属于 us-central1 区域级实例配置。 该请求将被拒绝，并显示 InvalidRegionalRequest 错误。

区域端点的限制

如果您无法访问双区域或多区域实例配置，则无法访问 区域端点您必须使用全球端点访问您的双区域 或多区域实例配置例如，如果您在 多区域实例配置 nam7，则不能使用区域级 端点spanner.us-central1.rep.googleapis.com，以向您的 nam7 中的实例。

如果您有使用任何服务上的区域端点的有效请求 实例资源、移动实例 会影响使用区域端点的所有请求，因为区域强制执行 可阻止对跨区域实例的访问。使用全球端点的请求 不受影响。

区域端点命名惯例

Spanner 区域端点名称遵循相同的命名惯例 用作区域级实例配置名称区域端点遵循 格式为 spanner.<REGION>.rep.googleapis.com。例如，区域级资源 达曼的实例配置名称和区域端点名称 me-central2.因此，区域端点是 spanner.me-central2.rep.googleapis.com.

只有 me-central2 可用作可能的区域端点。

指定区域端点

您可以使用 Google Cloud CLI、REST 或 RPC API 请求。

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

例如，如果要在区域级实例中强制执行数据保证 配置达曼 (me-central2)，请使用：

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

如需了解详情，请参阅 REST API。

RPC API

默认 API 端点可访问全球端点。要使用区域级集群 端点，请使用 以下格式：

spanner.REGION.rep.googleapis.com

例如，如果要在区域级实例中强制执行数据保证 配置达曼 (me-central2)，请使用：

spanner.me-central2.rep.googleapis.com

如需了解详情，请参阅 RPC API。

后续步骤