關於 Cloud Endpoints

Endpoints 是一個分散式 API 管理系統,這項服務提供 API 控制台、託管、記錄、監控及其他多項功能,可協助您建立、共用、維護及保護 API。本頁面提供 gRPC 專用的 Cloud Endpoints 總覽。如要瞭解 Endpoints 支援的其他類型 API 架構,請參閱所有 Endpoints 說明文件

Endpoints 可搭配分散式可擴充服務 Proxy (ESP) 或可擴充服務 Proxy V2 (ESPv2) 使用。每個 Proxy 都支援下列平台:

  • App Engine 彈性環境 (僅限 ESP)
  • Google Kubernetes Engine (ESP 或 ESPv2)
  • Compute Engine (ESP 或 ESPv2)
  • Kubernetes (ESP 或 ESPv2)
  • App Engine 標準環境 (僅限 ESPv2)
  • Cloud Run functions (僅限 ESPv2)
  • Cloud Run (僅限 ESPv2)
  • Knative serving (僅限 ESPv2)

透過 ESP 使用 Endpoints

Endpoints 使用分散式可擴充服務 Proxy (ESP),即使是需求最高的 API,也能提供低延遲和高效能的服務。ESP 是以 NGINX 為基礎的服務 Proxy,因此您可以放心,ESP 會視需要擴充,以處理對 API 的並行要求。ESP 會在自己的 Docker 容器中執行,以提升隔離性和擴充性,並在 Container Registry 中發布。你可以搭配以下裝置使用:

透過 ESPv2 使用 Endpoints

ESPv2 是以 Envoy 為基礎的高效能可擴充 Proxy,會在 OpenAPI 或 gRPC API 後端的前面執行。ESPv2 支援第 2 版的 OpenAPI 規格和 gRPC 規格。你可以搭配以下裝置使用:

Endpoints API 管理功能

無論您使用 Endpoints 搭配 ESP 或 ESPv2,都能享有許多重要的 API 管理功能,以便開發、監控及控管 API 存取權。

記錄檔和指標

Endpoints 使用服務基礎架構來管理 API 及回報記錄與指標,大多數 Google Cloud API 都使用相同的基礎架構。您可以在 Google Cloud 控制台的「Endpoints Services」(Endpoints 服務) 頁面管理及監控 API。

API 託管

Endpoints 已針對 Docker 容器環境進行最佳化,您可以在任何支援 Docker 且可透過網際網路存取Google Cloud之處託管您的 API。

使用 Endpoints 開發 gRPC API

  1. 使用通訊協定緩衝區定義 gRPC API 服務,並使用任何支援 gRPC 的語言進行實作。

  2. 在 Endpoints 寫入您的 gRPC API 服務設定。

  3. 產生 API 的執行階段 API 設定,並將其部署至 Service Management。

  4. 部署您的 API 伺服器。

如要進一步瞭解如何搭配 Endpoints 使用 gRPC,請參閱 gRPC 專用的 Endpoints API 和相關的教學課程

控管 API 存取權

Endpoints 可讓您將 API 設定為任何呼叫都需要 API 金鑰,並驗證 API 金鑰。您也可以使用 Google Cloud 控制台來與其他開發人員共用您的 API,讓他們可以啟用您的 API 並產生 API 金鑰來呼叫該 API。

驗證 API 使用者

對於大多數 API 呼叫,每個呼叫的另一端都有一位使用者。雖然 API 金鑰可以指出哪個應用程式正在呼叫您的 API,但是驗證程序可以確定哪位使用者正在使用該應用程式。

請注意,您的 API 伺服器仍需要決定通過驗證的使用者可以對您的 API 進行哪些操作。詳情請參閱Google Cloud 驗證指南

後續步驟

  • 請參閱 Endpoints 快速入門導覽課程來熟悉部署步驟和瞭解 Endpoints 功能的實務應用,瞭解如何使用指令碼將範例 API 部署至 App Engine 彈性後端。

  • 進行其中一個教學課程,進一步瞭解如何使用 Endpoints。