REST Resource: projects.locations.agentGateways

Risorsa: AgentGateway

AgentGateway rappresenta la risorsa gateway dell'agente.

Rappresentazione 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.
}
Campi
name

string

Identificatore. Nome della risorsa AgentGateway. Corrisponde al pattern projects/*/locations/*/agentGateways/<agentGateway>.
createTime

string (Timestamp format)

Solo output. Timestamp di creazione della risorsa.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Timestamp di aggiornamento della risorsa.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "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)

Facoltativo. Insieme di tag di etichette associati alla risorsa AgentGateway.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
description

string

Facoltativo. Una descrizione in formato libero della risorsa. Lunghezza massima: 1024 caratteri.
etag

string

Facoltativo. Etag della risorsa. Se fornito, deve corrispondere all'etag del server. Se l'ETag fornito non corrisponde all'ETag del server, la richiesta non andrà a buon fine e verrà restituito un errore 409 ABORTED.
protocols[]

enum (Protocol)

Obbligatorio. Elenco dei protocolli supportati da un Agent Gateway
registries[]

string

Facoltativo. Un elenco di Agent Registry contenenti gli agenti, i server MCP e gli strumenti regolati da Agent Gateway. Nota: attualmente limitato ai registri con ambito progetto. Deve essere nel formato `//agentregistry.googleapis.com/projects/{project}/locations/{location}/
networkConfig

object (NetworkConfig)

Facoltativo. Configurazione di rete per AgentGateway.
agentGatewayCard

object (AgentGatewayOutputCard)

Solo output. Campo per la scheda AgentGateway compilata.
Campo unione deployment_mode. Modalità di deployment del proxy di rete. Esattamente uno dei campi in questo oneof deve essere impostato. deployment_mode può essere solo uno dei seguenti tipi:
googleManaged

object (GoogleManaged)

Facoltativo. Il proxy è orchestrato e gestito da Google Cloud in un progetto tenant.
selfManaged

object (SelfManaged)

Facoltativo. Collegati a bilanciatori del carico delle applicazioni o Secure Web Proxy esistenti.

GoogleManaged

Configurazione per la modalità di distribuzione gestita da Google. Il proxy è orchestrato e gestito da Google Cloud in un progetto tenant.

Rappresentazione JSON 
{
  "governedAccessPath": enum (GovernedAccessPath)
}
Campi
governedAccessPath

enum (GovernedAccessPath)

Facoltativo. Modalità operativa di Agent Gateway.

GovernedAccessPath

GovernedAccessPath definisce il tipo di accesso da proteggere.

Enum
GOVERNED_ACCESS_PATH_UNSPECIFIED Il percorso di accesso governato non è specificato.
AGENT_TO_ANYWHERE Controlla le connessioni degli agenti alle destinazioni.
CLIENT_TO_AGENT Proteggere la connessione all'agente o allo strumento.

SelfManaged

Configurazione per la modalità di deployment con gestione indipendente. Collegati a bilanciatori del carico delle applicazioni o Secure Web Proxy esistenti.

Rappresentazione JSON 
{
  "resourceUri": string
}
Campi
resourceUri

string

Facoltativo. Un proxy di rete Google Cloud supportato nel progetto e nella posizione

Protocollo

Enumerazioni di tutti i protocolli supportati

Enum
PROTOCOL_UNSPECIFIED Protocollo non specificato.
MCP Protocollo del control plane dei messaggi.

NetworkConfig

NetworkConfig contiene le configurazioni di rete per AgentGateway.

Rappresentazione JSON 
{
  "egress": {
    object (Egress)
  },
  "dnsPeeringConfig": {
    object (DnsPeeringConfig)
  }
}
Campi
egress

object (Egress)

Facoltativo. (Facoltativo) Collegamento di rete dell'interfaccia PSC per la connettività alla rete VPC privata.
dnsPeeringConfig

object (DnsPeeringConfig)

Facoltativo. (Facoltativo) Configurazione del peering DNS per la connettività alla tua rete VPC privata.

In uscita

Configurazione per il traffico in uscita

Rappresentazione JSON 
{
  "networkAttachment": string
}
Campi
networkAttachment

string

Facoltativo. L'URI della risorsa di collegamento di rete.

DnsPeeringConfig

Configurazione del peering DNS per la rete VPC dell'utente.

Rappresentazione JSON 
{
  "domains": [
    string
  ],
  "targetProject": string,
  "targetNetwork": string
}
Campi
domains[]

string

Obbligatorio. Nomi di dominio per i quali le query DNS devono essere inoltrate alla rete di destinazione.
targetProject

string

Obbligatorio. L'ID progetto di destinazione a cui devono essere inoltrate le query DNS. Può trattarsi dello stesso progetto che contiene AgentGateway o di un progetto diverso.
targetNetwork

string

Obbligatorio. La rete di destinazione nel "progetto di destinazione" a cui devono essere inoltrate le query DNS. Deve essere nel formato projects/{project}/global/networks/{network}.

AgentGatewayOutputCard

AgentGatewayOutputCard contiene campi informativi di solo output

Rappresentazione JSON 
{
  "mtlsEndpoint": string,
  "rootCertificates": [
    string
  ],
  "serviceExtensionsServiceAccount": string
}
Campi
mtlsEndpoint

string

Solo output. Endpoint mTLS associato a questo AgentGateway
rootCertificates[]

string

Solo output. Certificati radice per gli agenti per convalidare questo AgentGateway
serviceExtensionsServiceAccount

string

Solo output. Service account utilizzato da Service Extensions per funzionare.

Metodi

create

 Crea un nuovo AgentGateway in un progetto e una località specifici.

delete

 Elimina un singolo AgentGateway.

get

 Recupera i dettagli di una singola risorsa AgentGateway.

list

 Elenca gli AgentGateway in un determinato progetto e posizione.

patch

 Aggiorna i parametri di una singola risorsa AgentGateway.