REST Resource: projects.locations.agentGateways

Recurso: AgentGateway

"AgentGateway" representa o recurso de gateway do agente.

Representação 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.
}
Campos
name

string

Identificador. Nome do recurso AgentGateway. Ele corresponde ao padrão projects/*/locations/*/agentGateways/<agentGateway>.
createTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o recurso foi criado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o recurso foi atualizado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "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)

Opcional. Conjunto de tags de rótulo associadas ao recurso AgentGateway.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
description

string

Opcional. Uma descrição de texto livre do recurso. O tamanho máximo é de 1.024 caracteres.
etag

string

Opcional. ETag do recurso. Se esses dados forem fornecidos, eles precisarão corresponder ao etag do servidor. Se a etag fornecida não corresponder à do servidor, a solicitação vai falhar com um erro 409 ABORTED.
protocols[]
(deprecated)

enum (Protocol)

Opcional. Obsoleto.
registries[]

string

Opcional. Uma lista de registros de agentes que contêm os agentes, servidores MCP e ferramentas gerenciados pelo gateway de agente. Observação: atualmente limitado a registros no escopo do projeto. Precisa estar no formato //agentregistry.googleapis.com/projects/{project}/locations/{location}/
networkConfig

object (NetworkConfig)

Opcional. Configuração de rede para o AgentGateway.
agentGatewayCard

object (AgentGatewayOutputCard)

Apenas saída. Campo para o card AgentGateway preenchido.
Campo de união deployment_mode. Modo de implantação do proxy de rede. Exatamente um dos campos neste oneof precisa ser definido. deployment_mode pode ser apenas de um dos tipos a seguir:
googleManaged

object (GoogleManaged)

Opcional. O proxy é orquestrado e gerenciado pelo Google Cloud em um projeto de locatário.
selfManaged

object (SelfManaged)

Opcional. Anexar a balanceadores de carga de aplicativo ou proxies da Web seguros atuais.

GoogleManaged

Configuração para o modo de implantação gerenciado pelo Google. O proxy é orquestrado e gerenciado pelo Google Cloud em um projeto de locatário.

Representação JSON 
{
  "governedAccessPath": enum (GovernedAccessPath)
}
Campos
governedAccessPath

enum (GovernedAccessPath)

Opcional. Modo de operação do Gateway de Agente.

GovernedAccessPath

GovernedAccessPath define o tipo de acesso a ser protegido.

Tipos enumerados
GOVERNED_ACCESS_PATH_UNSPECIFIED O caminho de acesso governado não foi especificado.
AGENT_TO_ANYWHERE Governar as conexões de agentes com destinos.
CLIENT_TO_AGENT Proteger a conexão com o agente ou a ferramenta.

SelfManaged

Configuração para o modo de implantação autogerenciado. Anexar a balanceadores de carga de aplicativo ou proxies da Web seguros atuais.

Representação JSON 
{
  "resourceUri": string,
  "resourceUris": [
    string
  ]
}
Campos
resourceUri

string

Opcional. Um proxy de rede do Google Cloud compatível no projeto e local
resourceUris[]

string

Opcional. Lista de proxies de rede do Google Cloud compatíveis no projeto e no local. "resourceUris" e "resourceUri" são mutuamente exclusivos.

Protocolo

Enums de todos os protocolos compatíveis

Tipos enumerados
PROTOCOL_UNSPECIFIED Protocolo não especificado.
MCP Protocolo do plano de controle de mensagens.

NetworkConfig

NetworkConfig contém configurações de rede para o AgentGateway.

Representação JSON 
{
  "egress": {
    object (Egress)
  },
  "dnsPeeringConfig": {
    object (DnsPeeringConfig)
  }
}
Campos
egress

object (Egress)

Opcional. Anexo de rede de interface PSC opcional para conectividade com sua rede VPC particular.
dnsPeeringConfig

object (DnsPeeringConfig)

Opcional. Configuração opcional de peering de DNS para conectividade com sua rede VPC particular.

Saída

Configuração para saída

Representação JSON 
{
  "networkAttachment": string
}
Campos
networkAttachment

string

Opcional. O URI do recurso de anexo de rede.

DnsPeeringConfig

Configuração de peering de DNS para a rede VPC do usuário.

Representação JSON 
{
  "domains": [
    string
  ],
  "targetProject": string,
  "targetNetwork": string
}
Campos
domains[]

string

Obrigatório. Nomes de domínio para os quais as consultas DNS precisam ser encaminhadas à rede de destino.
targetProject

string

Obrigatório. ID do projeto de destino para onde as consultas de DNS precisam ser encaminhadas. Esse pode ser o mesmo projeto que contém o AgentGateway ou um projeto diferente.
targetNetwork

string

Obrigatório. Rede de destino no "projeto de destino" para onde as consultas de DNS devem ser encaminhadas. Precisa estar no formato projects/{project}/global/networks/{network}.

AgentGatewayOutputCard

AgentGatewayOutputCard contém campos informativos somente de saída.

Representação JSON 
{
  "mtlsEndpoint": string,
  "rootCertificates": [
    string
  ],
  "serviceExtensionsServiceAccount": string
}
Campos
mtlsEndpoint

string

Somente saída. Endpoint mTLS associado a este AgentGateway.
rootCertificates[]

string

Apenas saída. Certificados raiz para os agentes validarem este AgentGateway.
serviceExtensionsServiceAccount

string

Apenas saída. Conta de serviço usada pelas Service Extensions para operar.

Métodos

create

 Cria um novo AgentGateway em determinado projeto e local.

delete

 Exclui um único AgentGateway.

get

 Recebe detalhes de um único AgentGateway.

list

 Lista os AgentGateways em determinado projeto e local.

patch

 Atualiza os parâmetros de um único AgentGateway.