REST Resource: projects.locations.agentGateways

资源：AgentGateway

AgentGateway 表示代理网关资源。

JSON 表示法 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "description": string,
  "etag": string,
  "protocols": [
    enum (Protocol)
  ],
  "registries": [
    string
  ],
  "networkConfig": {
    object (NetworkConfig)
  },
  "agentGatewayCard": {
    object (AgentGatewayOutputCard)
  },

  // Union field deployment_mode can be only one of the following:
  "googleManaged": {
    object (GoogleManaged)
  },
  "selfManaged": {
    object (SelfManaged)
  }
  // End of list of possible types for union field deployment_mode.
}
字段
name

string

标识符。AgentGateway 资源的名称。它符合格式 projects/*/locations/*/agentGateways/<agentGateway>。
createTime

string (Timestamp format)

仅限输出。创建资源时的时间戳。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

仅限输出。更新资源时的时间戳。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
labels

map (key: string, value: string)

可选。与 AgentGateway 资源关联的一组标签标记。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
description

string

可选。资源的自由文本说明。长度上限为 1024 个字符。
etag

string

可选。资源的 ETag。如果提供此值，则必须与服务器的 ETag 相匹配。如果提供的 etag 与服务器的 etag 不匹配，则请求会失败并返回 409 ABORTED 错误。
protocols[]

enum (Protocol)

必需。智能体网关支持的协议列表
registries[]

string

可选。包含由代理网关管理的代理、MCP 服务器和工具的代理注册表列表。注意：目前仅限项目级注册表，必须采用以下格式：`//agentregistry.googleapis.com/projects/{project}/locations/{location}/
networkConfig

object (NetworkConfig)

可选。AgentGateway 的网络配置。
agentGatewayCard

object (AgentGatewayOutputCard)

仅限输出。已填充的 AgentGateway 卡片的字段。
联合字段 deployment_mode。网络代理的部署模式。必须且只能设置此 oneof 中的一个字段。deployment_mode 只能是下列其中一项：
googleManaged

object (GoogleManaged)

可选。代理由 Google Cloud 在租户项目中进行编排和管理。
selfManaged

object (SelfManaged)

可选。附加到现有的应用负载平衡器或 Secure Web Proxy。

GoogleManaged

Google 管理的部署模式的配置。代理由 Google Cloud 在租户项目中进行编排和管理。

JSON 表示法 
{
  "governedAccessPath": enum (GovernedAccessPath)
}
字段
governedAccessPath

enum (GovernedAccessPath)

可选。Agent Gateway 的运行模式。

GovernedAccessPath

GovernedAccessPath 定义了要保护的访问权限类型。

枚举
GOVERNED_ACCESS_PATH_UNSPECIFIED 未指定受控访问路径。
AGENT_TO_ANYWHERE 管理智能体与目的地之间的连接。
CLIENT_TO_AGENT 保护与智能体或工具的连接。

SelfManaged

自行管理的部署模式的配置。附加到现有的应用负载平衡器或 Secure Web Proxy。

JSON 表示法 
{
  "resourceUri": string
}
字段
resourceUri

string

可选。项目和位置中受支持的 Google Cloud 网络代理

协议

所有受支持协议的枚举

枚举
PROTOCOL_UNSPECIFIED 未指定协议。
MCP 消息控制平面协议。

NetworkConfig

NetworkConfig 包含 AgentGateway 的网络配置。

JSON 表示法 
{
  "egress": {
    object (Egress)
  },
  "dnsPeeringConfig": {
    object (DnsPeeringConfig)
  }
}
字段
egress

object (Egress)

可选。用于连接到专用 VPC 网络的 PSC 接口网络连接（可选）。
dnsPeeringConfig

object (DnsPeeringConfig)

可选。用于连接到专用 VPC 网络的可选 DNS 对等互连配置。

出站

出站流量配置

JSON 表示法 
{
  "networkAttachment": string
}
字段
networkAttachment

string

可选。网络附件资源的 URI。

DnsPeeringConfig

用户 VPC 网络的 DNS 对等互连配置。

JSON 表示法 
{
  "domains": [
    string
  ],
  "targetProject": string,
  "targetNetwork": string
}
字段
domains[]

string

必需。应将 DNS 查询转发到目标网络的域名。
targetProject

string

必需。应将 DNS 查询转发到的目标项目 ID。此项目可以是包含 AgentGateway 的项目，也可以是其他项目。
targetNetwork

string

必需。应将 DNS 查询转发到的“目标项目”中的目标网络。必须采用 projects/{project}/global/networks/{network} 格式。

AgentGatewayOutputCard

AgentGatewayOutputCard 包含仅限输出的信息字段

JSON 表示法 
{
  "mtlsEndpoint": string,
  "rootCertificates": [
    string
  ],
  "serviceExtensionsServiceAccount": string
}
字段
mtlsEndpoint

string

仅限输出。与相应 AgentGateway 关联的 mTLS 端点
rootCertificates[]

string

仅限输出。代理用于验证此 AgentGateway 的根证书
serviceExtensionsServiceAccount

string

仅限输出。Service Extensions 用于运行的服务账号。

方法

create

 在给定的项目和位置中创建新 AgentGateway。

delete

 删除单个 AgentGateway。

get

 获取单个 AgentGateway 的详细信息。

list

 列出给定项目和位置中的 AgentGateway。

patch

 更新单个 AgentGateway 的参数。