REST Resource: projects.locations.agentGateways

Recurso: AgentGateway

AgentGateway representa el recurso de Agent Gateway.

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 etiqueta de entidad del servidor. Si la etag proporcionada no coincide con la etag del servidor, la solicitud fallará con un error 409 ABORTED.
protocols[]
(deprecated)

enum (Protocol)

Es opcional. Obsoleto.
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 de 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. Es el 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 organiza y administra el proxy en un proyecto de usuario.
selfManaged

object (SelfManaged)

Es opcional. Conectar a balanceadores de cargas de aplicaciones o Secure Web Proxies existentes.

GoogleManaged

Es la configuración del modo de implementación administrado por Google. Google Cloud organiza 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 Administra las conexiones de los agentes a los 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. Conectar a balanceadores de cargas de aplicaciones o Secure Web Proxies existentes.

Representación JSON 
{
  "resourceUri": string,
  "resourceUris": [
    string
  ]
}
Campos
resourceUri

string

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

string

Es opcional. Es la lista de proxies de redes de Google Cloud admitidos en el proyecto y la ubicación. resourceUris es un campo que se excluye de forma mutua con resourceUri.

Protocolo

Enums de todos los protocolos admitidos

Enums
PROTOCOL_UNSPECIFIED Protocolo no especificado.
MCP Protocolo del plano de control de mensajes.

NetworkConfig

NetworkConfig contiene parámetros de configuración de red para AgentGateway.

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

object (Egress)

Es opcional. Adjunto de red de interfaz de PSC opcional para la conectividad a tu red de VPC privada.
dnsPeeringConfig

object (DnsPeeringConfig)

Es opcional. Configuración opcional de 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. Son los 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. Este 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. Extremo de mTLS asociado con este AgentGateway
rootCertificates[]

string

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

string

Solo salida. Es la cuenta de servicio que usan las extensiones de servicio para operar.

Métodos

create

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

delete

 Borra un solo AgentGateway.

get

 Obtiene detalles de un solo AgentGateway.

list

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

patch

 Actualiza los parámetros de una sola AgentGateway.