API 端点(或服务端点)是一个网址,用于指定 Google Cloud API 服务(例如 bigquery.googleapis.com)的网络地址。Google Cloud 服务允许使用不同类型的 API 端点(包括区域级、多区域级、全球级和位置级)访问资源。对每种端点类型的支持取决于服务。
本文档简要介绍了每种类型的端点,以便您清楚了解它们之间的区别,并指导您选择要使用的端点类型。
区域端点
区域级 API 端点通过限定在单个 Google Cloud 区域内的 API 端点提供对 Google Cloud 服务的访问权限。发送到区域端点的流量会在指定区域内进行处理并终止 TLS。
对于大多数 Google Cloud 服务,您可以使用区域级端点来处理指定区域内的区域级资源。区域端点通常不支持对全球资源、多区域资源和区域外区域资源执行操作。
区域级 API 端点将位置指定为子网域。公共区域端点的格式如下:
SERVICE.REGION.rep.googleapis.com
SERVICE: Google Cloud 服务的名称,例如storage、compute或bigquery。REGION: Google Cloud 区域名称,例如us-central1或europe-west1。
私有区域 API 端点采用以下格式:
SERVICE.REGION.p.rep.googleapis.com
SERVICE: Google Cloud 服务的名称,例如storage、compute或bigquery。REGION: Google Cloud 区域名称,例如us-central1或europe-west1。.p.:表示旨在用于 Private Service Connect 连接的私密目标。
多区域端点
多区域 API 端点通过限定为同一国家/地区(例如美国、印度或加拿大)或管辖区(例如欧盟)内的一组 Google Cloud 区域的 API 端点提供对 Google Cloud 服务的访问权限。发送到多区域端点的流量会在指定管辖区内进行处理并终止 TLS。
对于大多数 Google Cloud 服务,您可以使用多区域端点来处理指定多区域内的多区域资源。通常不支持对其他司法管辖区的全球资源、区域资源和多区域资源执行操作。
多区域 API 端点将管辖区指定为子网域。公共多区域端点的格式如下:
SERVICE.MULTIREGION.rep.googleapis.com
SERVICE: Google Cloud 服务的名称,例如storage、compute或bigquery。MULTIREGION: Google Cloud 多区域名称,例如us或eu。
专用多区域 API 端点采用以下格式:
SERVICE.MULTIREGION.p.rep.googleapis.com
SERVICE: Google Cloud 服务的名称,例如storage、compute或bigquery。MULTIREGION:多区域的名称,例如us或eu。 Google Cloud.p.:表示旨在用于 Private Service Connect 连接的私密目标。
全球端点
全球 API 端点不会在网址主机名中指定位置。这些全局范围的端点提供高可用性服务端点,可尽可能靠近客户端终止 TLS 会话,从而最大限度地减少通过互联网为分散的客户端群体提供 API 调用服务时的延迟。不过,这些端点不提供任何区域隔离或数据留存合规性。
对于可以处理全局依赖项且需要 Google 全球网络提供快速性能的应用,您可以使用全局端点。
全球端点采用以下格式:
SERVICE.googleapis.com
其中,SERVICE 是 Google Cloud 服务的名称,例如 storage、compute 或 bigquery。
位置端点
区域 API 端点正在取代位置端点。 位置端点是单区域或多区域服务主机名,可用于访问特定位置的数据。
不过,位置端点不支持以下功能:
- 通过互联网从本地建立符合数据驻留规定的连接
- 故障域隔离
位置端点在网址主机名中指定位置,格式如下:
LOCATION-SERVICE.googleapis.com
LOCATION: Google Cloud 区域名称,例如us-central1、europe-west1或us。SERVICE: Google Cloud 服务的名称,例如storage、compute或bigquery。
参考文档
后续步骤
- 详细了解区域级端点和多区域级端点。
- 通过后端访问区域性 Google API。
- 请参阅 Google Cloud 支持的区域服务端点。