API 端点(或服务端点)是一个网址,用于指定 API 服务的网络
地址,例如 bigquery.googleapis.com。
Google Cloud 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:区域名称,例如us-central1或europe-west1。 Google Cloud
专用区域 API 端点采用以下格式:
SERVICE.REGION.p.rep.googleapis.com
SERVICE: Google Cloud 服务的名称,例如storage、compute或bigquery。REGION:区域名称,例如us-central1或europe-west1。 Google Cloud.p.:表示用于 Private Service Connect 连接的专用目标。
多区域端点
多区域 API 端点通过限定为同一国家/地区(例如美国、印度或加拿大)或司法管辖区(例如欧盟)内的一组区域的 API 端点提供对 Google Cloud 服务的访问权限。 Google Cloud 发送到多区域端点的流量完全在指定司法管辖区内处理和终止 TLS。
对于大多数 Google Cloud 服务,您可以使用多区域端点来处理 指定多区域内的多区域资源。通常不支持对全球资源、区域资源和其他司法管辖区的多区域资源执行操作。
多区域 API 端点将司法管辖区指定为子网域。公共多区域端点采用以下格式:
SERVICE.MULTI_REGION.rep.googleapis.com
SERVICE: Google Cloud 服务的名称,例如storage、compute或bigquery。MULTI_REGION:多区域名称,例如us或eu。 Google Cloud
专用多区域 API 端点采用以下格式:
SERVICE.MULTI_REGION.p.rep.googleapis.com
SERVICE: Google Cloud 服务的名称,例如storage、compute或bigquery。MULTI_REGION:多区域的名称,例如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。usSERVICE: Google Cloud 服务的名称,例如storage、compute或bigquery。
参考文档
后续步骤
- 了解区域端点和多区域端点。
- 通过后端访问区域性 Google API。
- 请参阅 Google Cloud 支持的区域服务端点。