REST Resource: projects.locations.agentGateways

Ressource: AgentGateway

AgentGateway repräsentiert die Agent-Gateway-Ressource.

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. Die Reihe an Label-Tags, die mit der AgentGateway-Ressource verknüpft 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 es angegeben wird, muss es 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 Agent Gateway unterstützten Protokolle
registries[]

string

Optional. Eine Liste der Agent-Registries, die die vom Agent Gateway verwalteten Agents, MCP-Server und Tools enthalten. Hinweis: Derzeit auf projektbezogene Registrierungen 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 die 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 Gateway.

GovernedAccessPath

Mit GovernedAccessPath wird der zu schützende Zugriffstyp definiert.

Enums
GOVERNED_ACCESS_PATH_UNSPECIFIED Der verwaltete Zugriffspfad ist nicht angegeben.
AGENT_TO_ANYWHERE Verbindungen von Agents zu Zielen verwalten.
CLIENT_TO_AGENT Verbindung zu Agent oder Tool schützen

SelfManaged

Konfiguration für den Bereitstellungsmodus „Selbstverwaltet“. 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

Aufzählungen aller unterstützten Protokolle

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

NetworkConfig

NetworkConfig enthält Netzwerkkonfigurationen für das AgentGateway.

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

object (Egress)

Optional. Optionaler Netzwerkanhang für die PSC-Schnittstelle 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 Ressource für den Netzwerkanhang.

DnsPeeringConfig

DNS-Peering-Konfiguration für das Benutzer-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. Das kann dasselbe Projekt sein, das auch das AgentGateway enthält, oder ein anderes Projekt.
targetNetwork

string

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

AgentGatewayOutputCard

AgentGatewayOutputCard enthält Felder, die ausschließlich Informationen ausgeben.

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

string

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

string

Nur Ausgabe. Root-Zertifikate für Agents zur Validierung dieses AgentGateways
serviceExtensionsServiceAccount

string

Nur Ausgabe. Von Service Extensions verwendetes Dienstkonto.

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 bestimmten Projekt und an einem bestimmten Standort auf.

patch

 Aktualisiert die Parameter eines einzelnen AgentGateway.