Google Cloud API 端點總覽

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 服務的名稱,例如 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 端點可讓您透過 API 端點存取 Google Cloud 服務,這些端點的範圍限定於同一國家/地區 (例如美國、印度或加拿大) 或管轄區 (例如歐盟) 內的一組 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:多區域的 Google Cloud 名稱,例如 useu
  • .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

參考說明文件

後續步驟