REST Resource: projects.locations.agentGateways

Ressource : AgentGateway

AgentGateway représente la ressource Agent Gateway.

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 de tags d'étiquette associés à 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 cette valeur est fournie, elle doit correspondre à l'ETag du serveur. Si l'etag fourni ne correspond pas à celui du serveur, la requête échoue avec une erreur 409 ABORTED.
protocols[]
(deprecated)

enum (Protocol)

Facultatif. Obsolète.
registries[]

string

Facultatif. Liste des registres d'agents contenant les agents, les serveurs MCP et les outils régis par Agent Gateway. Remarque : Actuellement limité aux registres limités au 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 de la fiche AgentGateway renseignée.
Champ d'union deployment_mode. Mode de déploiement du proxy réseau. Un seul 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. Associez-les à des équilibreurs de charge d'application ou à des 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 Gérez les connexions des agents aux destinations.
CLIENT_TO_AGENT Protégez 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,
  "resourceUris": [
    string
  ]
}
Champs
resourceUri

string

Facultatif. Un proxy de mise en réseau Google Cloud compatible dans le projet et l'emplacement
resourceUris[]

string

Facultatif. Liste des proxys de mise en réseau Google Cloud compatibles dans le projet et l'emplacement. resourceUris s'exclut mutuellement avec resourceUri.

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 de l'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 d'appairage DNS facultative 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 de rattachement de réseau.

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 au réseau cible.
targetProject

string

Obligatoire. ID du projet cible vers lequel les requêtes DNS doivent être transférées. Il peut s'agir du même projet que celui qui contient 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 d'informations en sortie uniquement.

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

string

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

string

Uniquement en sortie. Certificats racine permettant aux agents de valider cet AgentGateway
serviceExtensionsServiceAccount

string

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

Méthodes

create

 Crée un AgentGateway dans un projet et un emplacement donnés.

delete

 Supprime une seule ressource AgentGateway.

get

 Récupère les détails d'une seule ressource AgentGateway.

list

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

patch

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