REST Resource: projects.locations.agentGateways

Ressource: AgentGateway

AgentGateway stellt die Agent-Gateway-Ressource dar.

JSON-Darstellung 
{
  "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.
}
Felder
name

string

ID. Name der AgentGateway-Ressource. Entspricht dem Muster projects/*/locations/*/agentGateways/<agentGateway>.
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann die Ressource erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel der Ressourcenaktualisierung.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Optional. Eine Reihe von Label-Tags, die der AgentGateway-Ressource zugeordnet sind.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
description

string

Optional. Eine Textbeschreibung der Ressource. Maximale Länge: 1.024 Zeichen.
etag

string

Optional. Etag der Ressource. Wenn dieser Wert angegeben wird, muss er mit dem ETag des Servers übereinstimmen. Wenn das angegebene ETag nicht mit dem ETag des Servers übereinstimmt, schlägt die Anfrage mit dem Fehler „409 ABORTED“ fehl.
protocols[]

enum (Protocol)

Erforderlich. Liste der von einem KI-Agenten-Gateway unterstützten Protokolle
registries[]

string

Optional. Eine Liste der Agent-Registries mit den KI-Agenten, MCP-Servern und Tools, die vom Agent Gateway verwaltet werden. Hinweis: Derzeit auf projektbezogene Registries beschränkt. Muss das Format „//agentregistry.googleapis.com/projects/{project}/locations/{location}/“ haben.
networkConfig

object (NetworkConfig)

Optional. Netzwerkkonfiguration für das AgentGateway.
agentGatewayCard

object (AgentGatewayOutputCard)

Nur Ausgabe. Feld für ausgefüllte AgentGateway-Karte.
Union-Feld deployment_mode. Bereitstellungsmodus des Netzwerkproxys. Genau eines der Felder in diesem oneof muss festgelegt werden. Für deployment_mode ist nur einer der folgenden Werte zulässig:
googleManaged

object (GoogleManaged)

Optional. Der Proxy wird von Google Cloud in einem Mandantenprojekt orchestriert und verwaltet.
selfManaged

object (SelfManaged)

Optional. An vorhandene Application Load Balancer oder Secure Web Proxys anhängen.

GoogleManaged

Konfiguration für den von Google verwalteten Bereitstellungsmodus. Der Proxy wird von Google Cloud in einem Mandantenprojekt orchestriert und verwaltet.

JSON-Darstellung 
{
  "governedAccessPath": enum (GovernedAccessPath)
}
Felder
governedAccessPath

enum (GovernedAccessPath)

Optional. Betriebsmodus des Agent Gateways.

GovernedAccessPath

„GovernedAccessPath“ definiert den Zugriffstyp, der geschützt werden soll.

Enums
GOVERNED_ACCESS_PATH_UNSPECIFIED Der verwaltete Zugriffspfad ist nicht angegeben.
AGENT_TO_ANYWHERE Verbindungen von KI-Agenten zu Zielen verwalten.
CLIENT_TO_AGENT Verbindung zum Agenten oder Tool schützen.

SelfManaged

Konfiguration für den selbstverwalteten Bereitstellungsmodus. An vorhandene Application Load Balancer oder Secure Web Proxys anhängen.

JSON-Darstellung 
{
  "resourceUri": string
}
Felder
resourceUri

string

Optional. Ein unterstützter Google Cloud-Netzwerkproxy im Projekt und am Standort

Protokoll

Enums aller unterstützten Protokolle

Enums
PROTOCOL_UNSPECIFIED Nicht angegebenes Protokoll.
MCP Message Control Plane-Protokoll.

NetworkConfig

NetworkConfig enthält Netzwerkkonfigurationen für das AgentGateway.

JSON-Darstellung 
{
  "egress": {
    object (Egress)
  },
  "dnsPeeringConfig": {
    object (DnsPeeringConfig)
  }
}
Felder
egress

object (Egress)

Optional. Optionaler PSC-Schnittstellen-Netzwerkanhang für die Verbindung zu Ihrem privaten VPC-Netzwerk.
dnsPeeringConfig

object (DnsPeeringConfig)

Optional. Optionale DNS-Peering-Konfiguration für die Verbindung zu Ihrem privaten VPC-Netzwerk.

Ausgehender Traffic

Konfiguration für ausgehenden Traffic

JSON-Darstellung 
{
  "networkAttachment": string
}
Felder
networkAttachment

string

Optional. Der URI der Netzwerkanhangsressource.

DnsPeeringConfig

DNS-Peering-Konfiguration für das Nutzer-VPC-Netzwerk.

JSON-Darstellung 
{
  "domains": [
    string
  ],
  "targetProject": string,
  "targetNetwork": string
}
Felder
domains[]

string

Erforderlich. Domainnamen, für die DNS-Abfragen an das Zielnetzwerk weitergeleitet werden sollen.
targetProject

string

Erforderlich. Zielprojekt-ID, an die DNS-Abfragen weitergeleitet werden sollen. Dies kann dasselbe Projekt sein, das das AgentGateway enthält, oder ein anderes Projekt.
targetNetwork

string

Erforderlich. Zielnetzwerk im „Zielprojekt“, an das DNS-Abfragen weitergeleitet werden sollen. Muss das Format projects/{project}/global/networks/{network} haben.

AgentGatewayOutputCard

AgentGatewayOutputCard enthält schreibgeschützte Informationsfelder

JSON-Darstellung 
{
  "mtlsEndpoint": string,
  "rootCertificates": [
    string
  ],
  "serviceExtensionsServiceAccount": string
}
Felder
mtlsEndpoint

string

Nur Ausgabe. mTLS-Endpunkt, der diesem AgentGateway zugeordnet ist.
rootCertificates[]

string

Nur Ausgabe. Root-Zertifikate für Agenten zur Validierung dieses AgentGateway
serviceExtensionsServiceAccount

string

Nur Ausgabe. Dienstkonto, das von Service Extensions verwendet wird.

Methoden

create

 Erstellt ein neues AgentGateway in einem bestimmten Projekt und an einem bestimmten Standort.

delete

 Löscht ein einzelnes AgentGateway.

get

 Ruft Details zu einem einzelnen AgentGateway ab.

list

 Listet AgentGateways in einem angegebenen Projekt und an einem angegebenen Standort auf.

patch

 Aktualisiert die Parameter eines einzelnen AgentGateway.