註冊端點

在代理程式登錄中，端點代表目標網址 (通常是 REST API)，代理程式會存取該網址。在 Agent Registry 中將這些目的地註冊為受管理代理功能元件，即可集中控管代理程式機群可連線的外部端點。

本文說明如何在登錄檔中明確註冊外部端點。

事前準備

開始前，請設定 Agent Registry。您需要專案 ID 才能執行這些工作。

如要使用本文中的 Google Cloud CLI 指令，請務必設定 gcloud CLI 環境。

必要的角色

如要取得在 Agent Registry 中註冊端點所需的權限，請要求系統管理員授予您專案的 Agent Registry API 編輯者 (roles/agentregistry.editor) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

註冊端點

由於端點是自訂的外部目的地，請使用手動註冊，將端點新增至 Agent Registry：

控制台

  1. 前往 Google Cloud 控制台的「Agent Registry」：

    前往 Agent Registry

  2. 在專案選擇工具中，選取 Google Cloud 您設定 Agent Registry 的專案。

  3. 選取「端點」分頁標籤。

  4. 按一下「新增端點」。

  5. 在「端點詳細資料」面板中，輸入顯示名稱、說明、地理區域和到達網頁網址。

    (選用) 按一下這個面板中的「測試連線」，測試與到達網頁網址的連線。

  6. 按一下 [儲存]。

gcloud

您可以使用 no-spec 的 endpoint-spec-type 建立 Service 資源。

註冊端點並定義介面連線詳細資料：

gcloud alpha agent-registry services create ENDPOINT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --endpoint-spec-type=no-spec \
  --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL

更改下列內容：

  • ENDPOINT_NAME：您要為端點指定的名稱，例如 my-external-api。
  • PROJECT_ID：專案 ID。
  • REGION：登錄檔區域。
  • DISPLAY_NAME：端點的名稱，方便使用者辨識。
  • ENDPOINT_URL：目標網址，例如 https://api.example.com/v1/data。
  • PROTOCOL：介面的通訊協定繫結。有效值為 HTTP_JSON、GRPC 或 JSONRPC。

Service 資源建立完成後，代理程式登錄服務會在消費者端自動產生唯讀的 Endpoint 資源，供代理程式和協調器探索及使用。