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