全球和区域级服务端点

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

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

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

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

Spanner 区域端点仅在达曼可用 me-central2 区域实例配置。使用 无论发生何种情况，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。

只有 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。

后续步骤