REST Resource: projects.locations.agentGateways

리소스: AgentGateway

AgentGateway는 에이전트 게이트웨이 리소스를 나타냅니다.

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.
}
필드
name

string

식별자. AgentGateway 리소스의 이름입니다. projects/*/locations/*/agentGateways/<agentGateway> 패턴과 일치합니다.
createTime

string (Timestamp format)

출력 전용입니다. 리소스가 생성된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 리소스가 업데이트된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
labels

map (key: string, value: string)

선택사항입니다. AgentGateway 리소스와 연결된 라벨 태그 집합입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
description

string

선택사항입니다. 리소스에 대한 자유 텍스트 설명입니다. 최대 길이는 1,024자(영문 기준)입니다.
etag

string

선택사항입니다. 리소스의 ETag입니다. 제공되는 경우, 서버의 ETag와 일치해야 합니다. 제공된 ETag가 서버의 ETag와 일치하지 않으면 요청이 409 ABORTED 오류와 함께 실패합니다.
protocols[]

enum (Protocol)

필수 항목입니다. Agent Gateway에서 지원하는 프로토콜 목록
registries[]

string

선택사항입니다. 에이전트 게이트웨이에서 관리하는 에이전트, MCP 서버 및 도구가 포함된 에이전트 레지스트리 목록입니다. 참고: 현재 프로젝트 범위 레지스트리로 제한됩니다. `//agentregistry.googleapis.com/projects/{project}/locations/{location}/` 형식이어야 합니다.
networkConfig

object (NetworkConfig)

선택사항입니다. AgentGateway의 네트워크 구성입니다.
agentGatewayCard

object (AgentGatewayOutputCard)

출력 전용입니다. 채워진 AgentGateway 카드의 필드입니다.
통합 필드 deployment_mode. 네트워크 프록시의 배포 모드입니다. 이 oneof의 필드 중 정확히 하나를 설정해야 합니다. deployment_mode은 다음 중 하나일 수 있습니다.
googleManaged

object (GoogleManaged)

선택사항입니다. 프록시는 테넌트 프로젝트에서 GoogleCloud에 의해 오케스트레이션되고 관리됩니다.
selfManaged

object (SelfManaged)

선택사항입니다. 기존 애플리케이션 부하 분산기 또는 Secure Web Proxy에 연결

GoogleManaged

Google 관리 배포 모드의 구성입니다. 프록시는 테넌트 프로젝트에서 GoogleCloud에 의해 오케스트레이션되고 관리됩니다.

JSON 표현 
{
  "governedAccessPath": enum (GovernedAccessPath)
}
필드
governedAccessPath

enum (GovernedAccessPath)

선택사항입니다. Agent Gateway의 작동 모드입니다.

GovernedAccessPath

GovernedAccessPath는 보호할 액세스 유형을 정의합니다.

열거형
GOVERNED_ACCESS_PATH_UNSPECIFIED 관리되는 액세스 경로가 지정되지 않았습니다.
AGENT_TO_ANYWHERE 대상에 대한 에이전트 연결을 관리합니다.
CLIENT_TO_AGENT 에이전트 또는 도구에 대한 연결을 보호합니다.

SelfManaged

자체 관리형 배포 모드의 구성입니다. 기존 애플리케이션 부하 분산기 또는 Secure Web Proxy에 연결

JSON 표현 
{
  "resourceUri": string
}
필드
resourceUri

string

선택사항입니다. 프로젝트 및 위치에서 지원되는 Google Cloud 네트워킹 프록시

프로토콜

지원되는 모든 프로토콜의 열거형

열거형
PROTOCOL_UNSPECIFIED 지정되지 않은 프로토콜입니다.
MCP 메시지 제어 영역 프로토콜입니다.

NetworkConfig

NetworkConfig에는 AgentGateway의 네트워크 구성이 포함됩니다.

JSON 표현 
{
  "egress": {
    object (Egress)
  },
  "dnsPeeringConfig": {
    object (DnsPeeringConfig)
  }
}
필드
egress

object (Egress)

선택사항입니다. 비공개 VPC 네트워크에 연결하기 위한 선택적 PSC 인터페이스 네트워크 연결입니다.
dnsPeeringConfig

object (DnsPeeringConfig)

선택사항입니다. 비공개 VPC 네트워크에 연결하기 위한 선택적 DNS 피어링 구성입니다.

이그레스

이그레스 구성

JSON 표현 
{
  "networkAttachment": string
}
필드
networkAttachment

string

선택사항입니다. 네트워크 연결 리소스의 URI입니다.

DnsPeeringConfig

사용자 VPC 네트워크의 DNS 피어링 구성입니다.

JSON 표현 
{
  "domains": [
    string
  ],
  "targetProject": string,
  "targetNetwork": string
}
필드
domains[]

string

필수 항목입니다. DNS 쿼리를 대상 네트워크로 전달해야 하는 도메인 이름입니다.
targetProject

string

필수 항목입니다. DNS 쿼리가 전달되어야 하는 타겟 프로젝트 ID입니다. 에이전트 게이트웨이가 포함된 프로젝트와 동일한 프로젝트이거나 다른 프로젝트일 수 있습니다.
targetNetwork

string

필수 항목입니다. DNS 쿼리가 전달되어야 하는 '대상 프로젝트'의 대상 네트워크입니다. projects/{project}/global/networks/{network} 형식이어야 합니다.

AgentGatewayOutputCard

AgentGatewayOutputCard에는 정보 출력 전용 필드가 포함되어 있습니다.

JSON 표현 
{
  "mtlsEndpoint": string,
  "rootCertificates": [
    string
  ],
  "serviceExtensionsServiceAccount": string
}
필드
mtlsEndpoint

string

출력 전용입니다. 이 AgentGateway와 연결된 mTLS 엔드포인트입니다.
rootCertificates[]

string

출력 전용입니다. 에이전트가 이 AgentGateway를 검증하는 데 사용하는 루트 인증서
serviceExtensionsServiceAccount

string

출력 전용입니다. Service Extensions가 작동하는 데 사용하는 서비스 계정입니다.

메서드

create

 특정 프로젝트와 위치에 새 AgentGateway를 만듭니다.

delete

 단일 AgentGateway를 삭제합니다.

get

 단일 AgentGateway의 세부정보를 가져옵니다.

list

 특정 프로젝트와 위치의 AgentGateways를 나열합니다.

patch

 단일 AgentGateway의 파라미터를 업데이트합니다.