REST Resource: projects.locations.agentGateways

Recurso: AgentGateway

AgentGateway representa el recurso de la 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. Una descripción del recurso en texto libre. Longitud máxima: 1024 caracteres.
etag

string

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

enum (Protocol)

Obligatorio. Lista de protocolos compatibles con un Agent Gateway
registries[]

string

Es opcional. Es una lista de registros de agentes que contienen los agentes, los servidores de MCP y las herramientas que rige Agent Gateway. 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. Conéctese a los balanceadores de carga de aplicaciones o proxies web seguros existentes.

GoogleManaged

Es la configuración del 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. Es el modo de operación de Agent Gateway.

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 agentes a destinos
CLIENT_TO_AGENT Protege la conexión con el agente o la herramienta.

SelfManaged

Es la configuración para el modo de implementación autoadministrado. Conéctese a los balanceadores de carga 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 no especificado.
MCP Es el protocolo del plano de control de mensajes.

NetworkConfig

NetworkConfig contiene las configuraciones 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 de emparejamiento DNS para la conectividad con su 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

Configuración de emparejamiento 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 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 esta puerta de enlace de agente.
serviceExtensionsServiceAccount

string

Solo salida. Cuenta de servicio que usan las Service Extensions 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.