注册端点

在代理注册表中，端点表示代理访问的目标网址（通常是 REST API）。通过将这些目的地注册为受管理资源，您可以集中控制您的代理群组可以连接到哪些外部服务。

本文档介绍了如何在注册表中显式注册外部端点。

准备工作

开始之前，请先设置代理注册表。您需要项目 ID 才能执行这些任务。

如需使用本文档中的 gcloud CLI 命令，请确保您已设置 Google Cloud CLI 环境。

所需的角色

如需获得在代理注册表中注册端点所需的权限，请让您的管理员为您授予项目的 Agent Registry API Editor (roles/agentregistry.editor) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

注册端点

由于端点是自定义的外部目的地，因此请使用手动注册将其添加到代理注册表中：

控制台

  1. 在 Google Cloud 控制台中，前往 Agent Registry：

    前往 Agent Registry

  2. 在项目选择器中，选择设置代理注册表的 Google Cloud 项目。

  3. 选择端点标签页。

  4. 点击添加端点。

  5. 在端点详情面板中，输入显示名称、说明、地理区域和目标网址。您可以在此面板中测试与目标网址的连接。

  6. 点击保存。

gcloud

您可以使用 no-spec 的 endpoint-spec-type 创建 Service 资源。

注册端点并定义其接口连接详细信息：

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

替换以下内容：

  • SERVICE_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 资源，供代理和编排器发现和使用。