Google Cloud API 端点概览

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 服务的名称,例如 storagecomputebigquery
  • REGION: Google Cloud 区域名称,例如 us-central1europe-west1

私有区域 API 端点采用以下格式:

SERVICE.REGION.p.rep.googleapis.com

  • SERVICE: Google Cloud 服务的名称,例如 storagecomputebigquery
  • REGION: Google Cloud 区域名称,例如 us-central1europe-west1
  • .p.:表示旨在用于 Private Service Connect 连接的私密目标。

多区域端点

多区域 API 端点通过限定为同一国家/地区(例如美国、印度或加拿大)或管辖区(例如欧盟)内的一组 Google Cloud 区域的 API 端点提供对 Google Cloud 服务的访问权限。发送到多区域端点的流量会在指定管辖区内进行处理并终止 TLS。

对于大多数 Google Cloud 服务,您可以使用多区域端点来处理指定多区域内的多区域资源。通常不支持对其他司法管辖区的全球资源、区域资源和多区域资源执行操作。

多区域 API 端点将管辖区指定为子网域。公共多区域端点的格式如下:

SERVICE.MULTIREGION.rep.googleapis.com

  • SERVICE: Google Cloud 服务的名称,例如 storagecomputebigquery
  • MULTIREGION: Google Cloud 多区域名称,例如 useu

专用多区域 API 端点采用以下格式:

SERVICE.MULTIREGION.p.rep.googleapis.com

  • SERVICE: Google Cloud 服务的名称,例如 storagecomputebigquery
  • MULTIREGION:多区域的名称,例如 useu。 Google Cloud
  • .p.:表示旨在用于 Private Service Connect 连接的私密目标。

全球端点

全球 API 端点不会在网址主机名中指定位置。这些全局范围的端点提供高可用性服务端点,可尽可能靠近客户端终止 TLS 会话,从而最大限度地减少通过互联网为分散的客户端群体提供 API 调用服务时的延迟。不过,这些端点不提供任何区域隔离或数据留存合规性。

对于可以处理全局依赖项且需要 Google 全球网络提供快速性能的应用,您可以使用全局端点。

全球端点采用以下格式:

SERVICE.googleapis.com

其中,SERVICE 是 Google Cloud 服务的名称,例如 storagecomputebigquery

位置端点

区域 API 端点正在取代位置端点。 位置端点是单区域或多区域服务主机名,可用于访问特定位置的数据。

不过,位置端点不支持以下功能:

  • 通过互联网从本地建立符合数据驻留规定的连接
  • 故障域隔离

位置端点在网址主机名中指定位置,格式如下:

LOCATION-SERVICE.googleapis.com

  • LOCATION: Google Cloud 区域名称,例如 us-central1europe-west1us
  • SERVICE: Google Cloud 服务的名称,例如 storagecomputebigquery

参考文档

后续步骤