REST Resource: projects.locations.agentGateways

Ressource : AgentGateway

AgentGateway représente la ressource de passerelle d'agent.

Représentation 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.
}
Champs
name

string

Identifiant. Nom de la ressource AgentGateway. Il correspond au schéma projects/*/locations/*/agentGateways/<agentGateway>.
createTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la création de la ressource.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la mise à jour de la ressource.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Facultatif. Ensemble d'étiquettes associées à la ressource AgentGateway.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
description

string

Facultatif. Description en texte libre de la ressource. Longueur recommandée : 1 024 caractères.
etag

string

Facultatif. Etag de la ressource. Si elle est fournie, elle doit correspondre à celle du serveur. Si l'etag fourni ne correspond pas à l'etag du serveur, la requête échoue et une erreur 409 ABORTED est renvoyée.
protocols[]

enum (Protocol)

Obligatoire. Liste des protocoles compatibles avec une Agent Gateway
registries[]

string

Facultatif. Liste des registres d'agents contenant les agents, les serveurs MCP et les outils régis par l'Agent Gateway. Remarque : Actuellement limité aux registres à portée de projet. Doit être au format `//agentregistry.googleapis.com/projects/{project}/locations/{location}/
networkConfig

object (NetworkConfig)

Facultatif. Configuration réseau pour AgentGateway.
agentGatewayCard

object (AgentGatewayOutputCard)

Uniquement en sortie. Champ pour la carte AgentGateway renseignée.
Champ d'union deployment_mode. Mode de déploiement du proxy réseau. Exactement un des champs de ce oneof doit être défini. La deployment_mode ne peut être qu'un des éléments suivants :
googleManaged

object (GoogleManaged)

Facultatif. Le proxy est orchestré et géré par Google Cloud dans un projet locataire.
selfManaged

object (SelfManaged)

Facultatif. Se connecter aux équilibreurs de charge d'applications ou aux proxys Web sécurisés existants.

GoogleManaged

Configuration pour le mode de déploiement géré par Google. Le proxy est orchestré et géré par Google Cloud dans un projet locataire.

Représentation JSON 
{
  "governedAccessPath": enum (GovernedAccessPath)
}
Champs
governedAccessPath

enum (GovernedAccessPath)

Facultatif. Mode de fonctionnement d'Agent Gateway.

GovernedAccessPath

GovernedAccessPath définit le type d'accès à protéger.

Enums
GOVERNED_ACCESS_PATH_UNSPECIFIED Le chemin d'accès contrôlé n'est pas spécifié.
AGENT_TO_ANYWHERE Gouvernez les connexions des agents aux destinations.
CLIENT_TO_AGENT Protéger la connexion à l'agent ou à l'outil.

SelfManaged

Configuration pour le mode de déploiement autogéré. Associez-les à des équilibreurs de charge d'application ou à des proxys Web sécurisés existants.

Représentation JSON 
{
  "resourceUri": string
}
Champs
resourceUri

string

Facultatif. Un proxy réseau Google Cloud compatible dans le projet et l'emplacement

Protocole

Énumérations de tous les protocoles compatibles

Enums
PROTOCOL_UNSPECIFIED Protocole non spécifié.
MCP Protocole du plan de contrôle des messages.

NetworkConfig

NetworkConfig contient les configurations réseau pour AgentGateway.

Représentation JSON 
{
  "egress": {
    object (Egress)
  },
  "dnsPeeringConfig": {
    object (DnsPeeringConfig)
  }
}
Champs
egress

object (Egress)

Facultatif. Rattachement de réseau d'interface PSC facultatif pour la connectivité à votre réseau VPC privé.
dnsPeeringConfig

object (DnsPeeringConfig)

Facultatif. Configuration facultative de l'appairage DNS pour la connectivité à votre réseau VPC privé.

Sortie

Configuration pour la sortie

Représentation JSON 
{
  "networkAttachment": string
}
Champs
networkAttachment

string

Facultatif. URI de la ressource NetworkAttachment.

DnsPeeringConfig

Configuration de l'appairage DNS pour le réseau VPC de l'utilisateur.

Représentation JSON 
{
  "domains": [
    string
  ],
  "targetProject": string,
  "targetNetwork": string
}
Champs
domains[]

string

Obligatoire. Noms de domaine pour lesquels les requêtes DNS doivent être transférées vers le réseau cible.
targetProject

string

Obligatoire. ID du projet cible vers lequel les requêtes DNS doivent être redirigées. Il peut s'agir du même projet que celui contenant AgentGateway ou d'un autre projet.
targetNetwork

string

Obligatoire. Réseau cible dans le projet cible vers lequel les requêtes DNS doivent être transférées. Doit être au format projects/{project}/global/networks/{network}.

AgentGatewayOutputCard

AgentGatewayOutputCard contient des champs informatifs en sortie uniquement

Représentation JSON 
{
  "mtlsEndpoint": string,
  "rootCertificates": [
    string
  ],
  "serviceExtensionsServiceAccount": string
}
Champs
mtlsEndpoint

string

Uniquement en sortie. Point de terminaison mTLS associé à cette passerelle AgentGateway.
rootCertificates[]

string

Uniquement en sortie. Certificats racines permettant aux agents de valider ce AgentGateway
serviceExtensionsServiceAccount

string

Uniquement en sortie. Compte de service utilisé par les Service Extensions pour fonctionner.

Méthodes

create

 Crée une passerelle d'agent dans un projet et un emplacement donnés.

delete

 Supprime une seule passerelle AgentGateway.

get

 Obtient les détails d'une seule passerelle AgentGateway.

list

 Liste les AgentGateways d'un projet et d'un emplacement donnés.

patch

 Met à jour les paramètres d'une seule passerelle AgentGateway.