REST Resource: projects.locations.agentGateways

Recurso: AgentGateway

AgentGateway representa el recurso de puerta de enlace del agente.

Representación 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.
}
Campos
name

string

Es el identificador. Es el nombre del recurso AgentGateway. Coincide con el patrón projects/*/locations/*/agentGateways/<agentGateway>.
createTime

string (Timestamp format)

Solo salida. Marca de tiempo cuando se creó el recurso.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. La marca de tiempo cuando se creó el recurso.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Es opcional. Es un conjunto de etiquetas asociadas con el recurso AgentGateway.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
description

string

Es opcional. Es una descripción de texto libre del recurso. La longitud máxima es de 1,024 caracteres.
etag

string

Es opcional. Es la ETag del recurso. Si se proporciona, debe coincidir con la ETag del servidor. Si la ETag proporcionada no coincide con la ETag del servidor, la solicitud fallará con un error ABORTED 409.
protocols[]

enum (Protocol)

Obligatorio. Lista de protocolos compatibles con una puerta de enlace de agente
registries[]

string

Es opcional. Es una lista de registros de agentes que contienen los agentes, los servidores de MCP y las herramientas que rige la puerta de enlace de agentes. Nota: Actualmente, se limita a los registros con alcance del proyecto. Debe tener el formato `//agentregistry.googleapis.com/projects/{project}/locations/{location}/`
networkConfig

object (NetworkConfig)

Es opcional. Es la configuración de red para AgentGateway.
agentGatewayCard

object (AgentGatewayOutputCard)

Solo salida. Es el campo para la tarjeta AgentGateway completada.
Campo de unión deployment_mode. Modo de Deployment del proxy de red. Se debe establecer exactamente uno de los campos de este oneof. deployment_mode puede ser solo uno de los siguientes:
googleManaged

object (GoogleManaged)

Es opcional. Google Cloud coordina y administra el proxy en un proyecto de usuario.
selfManaged

object (SelfManaged)

Es opcional. Se pueden adjuntar a balanceadores de cargas de aplicaciones o proxies web seguros existentes.

GoogleManaged

Es la configuración para el modo de implementación administrado por Google. Google Cloud coordina y administra el proxy en un proyecto de usuario.

Representación JSON 
{
  "governedAccessPath": enum (GovernedAccessPath)
}
Campos
governedAccessPath

enum (GovernedAccessPath)

Es opcional. Modo de operación de la puerta de enlace de agente.

GovernedAccessPath

GovernedAccessPath define el tipo de acceso que se debe proteger.

Enums
GOVERNED_ACCESS_PATH_UNSPECIFIED No se especificó la ruta de acceso administrada.
AGENT_TO_ANYWHERE Administrar las conexiones de los agentes con los destinos
CLIENT_TO_AGENT Protege la conexión al agente o la herramienta.

SelfManaged

Es la configuración para el modo de implementación autoadministrado. Se pueden adjuntar a balanceadores de cargas de aplicaciones o proxies web seguros existentes.

Representación JSON 
{
  "resourceUri": string
}
Campos
resourceUri

string

Es opcional. Un proxy de redes de Google Cloud compatible en el proyecto y la ubicación

Protocolo

Enumeraciones de todos los protocolos admitidos

Enums
PROTOCOL_UNSPECIFIED Protocolo sin especificar.
MCP Es el protocolo del plano de control de mensajes.

NetworkConfig

NetworkConfig contiene la configuración de red para AgentGateway.

Representación JSON 
{
  "egress": {
    object (Egress)
  },
  "dnsPeeringConfig": {
    object (DnsPeeringConfig)
  }
}
Campos
egress

object (Egress)

Es opcional. Es un adjunto de red de interfaz de PSC opcional para la conectividad a tu red de VPCs privadas.
dnsPeeringConfig

object (DnsPeeringConfig)

Es opcional. Configuración opcional del intercambio de tráfico de DNS para la conectividad a tu red de VPC privada.

Salida

Configuración de salida

Representación JSON 
{
  "networkAttachment": string
}
Campos
networkAttachment

string

Es opcional. Es el URI del recurso de adjunto de red.

DnsPeeringConfig

Es la configuración del intercambio de tráfico de DNS para la red de VPC del usuario.

Representación JSON 
{
  "domains": [
    string
  ],
  "targetProject": string,
  "targetNetwork": string
}
Campos
domains[]

string

Obligatorio. Nombres de dominio para los que se deben reenviar las consultas de DNS a la red de destino.
targetProject

string

Obligatorio. Es el ID del proyecto de destino al que se deben reenviar las consultas de DNS. Puede ser el mismo proyecto que contiene AgentGateway o uno diferente.
targetNetwork

string

Obligatorio. Es la red de destino en el "proyecto de destino" a la que se deben reenviar las consultas de DNS. Debe tener el formato projects/{project}/global/networks/{network}.

AgentGatewayOutputCard

AgentGatewayOutputCard contiene campos informativos de solo salida

Representación JSON 
{
  "mtlsEndpoint": string,
  "rootCertificates": [
    string
  ],
  "serviceExtensionsServiceAccount": string
}
Campos
mtlsEndpoint

string

Solo salida. Es el extremo de mTLS asociado con este AgentGateway.
rootCertificates[]

string

Solo salida. Certificados raíz para que los agentes validen este AgentGateway
serviceExtensionsServiceAccount

string

Solo salida. Cuenta de servicio que usan las extensiones de servicio para operar.

Métodos

create

 Crea un nuevo AgentGateway en un proyecto y una ubicación determinados.

delete

 Borra un solo AgentGateway.

get

 Obtiene detalles de un solo AgentGateway.

list

 Enumera AgentGateways en una ubicación y un proyecto determinados.

patch

 Actualiza los parámetros de un solo AgentGateway.