REST Resource: projects.locations.agentGateways

Recurso: AgentGateway

AgentGateway representa o recurso do Gateway de 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 fornecido, ele precisa corresponder à etag do servidor. Se a etag fornecida não corresponder à do servidor, a solicitação vai falhar com um erro 409 ABORTED.
protocols[]

enum (Protocol)

Obrigatório. Lista de protocolos compatíveis com um Gateway de Agente
registries[]

string

Opcional. Uma lista de registros de agentes que contêm os agentes, servidores MCP e ferramentas controlados pelo Gateway de Agente. Observação: no momento, limitado a registros com escopo de 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 preenchido do AgentGateway.
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 Secure Web Proxies 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 Controlar as conexões do agente com os destinos.
CLIENT_TO_AGENT Proteja 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 Secure Web Proxies atuais.

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

string

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

Protocolo

Tipos enumerados 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 opcional da interface do PSC para conectividade com sua rede VPC particular.
dnsPeeringConfig

object (DnsPeeringConfig)

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

Saída

Configuração de 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 o qual as consultas DNS precisam ser encaminhadas. 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 DNS precisam 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 extensões de serviço 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.