REST Resource: projects.locations.agentGateways

資源：AgentGateway

AgentGateway 代表 Agent Gateway 資源。

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

ID。AgentGateway 資源的名稱。符合 projects/*/locations/*/agentGateways/<agentGateway> 模式。
createTime

string (Timestamp format)

僅供輸出。資源的建立時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

僅供輸出。資源的更新時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「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

選用。資源的文字說明，長度上限為 1024 個半形字元。
etag

string

選用。資源的 Etag。如有提供，則必須與伺服器的 etag 相符。如果提供的 etag 與伺服器的 etag 不符，要求就會失敗，並傳回 409 ABORTED 錯誤。
protocols[]

enum (Protocol)

這是必要旗標，Agent Gateway 支援的通訊協定清單
registries[]

string

選用。Agent Registry 清單，包含由 Agent Gateway 管理的代理、MCP 伺服器和工具。注意：目前僅限專案範圍的登錄檔，格式須為「//agentregistry.googleapis.com/projects/{project}/locations/{location}/
networkConfig

object (NetworkConfig)

選用。AgentGateway 的網路設定。
agentGatewayCard

object (AgentGatewayOutputCard)

僅供輸出。已填入內容的 AgentGateway 卡片欄位。
聯集欄位 deployment_mode。網路 Proxy 的部署模式。這個 oneof 中必須設定一個欄位。deployment_mode 只能是下列其中一個設定：
googleManaged

object (GoogleManaged)

選用。Proxy 由 Google Cloud 在租戶專案中自動調度及管理。
selfManaged

object (SelfManaged)

選用。附加至現有的應用程式負載平衡器或 Secure Web Proxy。

GoogleManaged

Google 代管部署模式的設定。Proxy 由 Google Cloud 在租戶專案中自動調度及管理。

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 網路 Proxy

通訊協定

所有支援通訊協定的列舉

列舉
PROTOCOL_UNSPECIFIED 未指定通訊協定。
MCP 訊息控制層通訊協定。

NetworkConfig

NetworkConfig 包含 AgentGateway 的網路設定。

JSON 表示法 
{
  "egress": {
    object (Egress)
  },
  "dnsPeeringConfig": {
    object (DnsPeeringConfig)
  }
}
欄位
egress

object (Egress)

選用。選用 PSC 介面網路連結，可連至私人虛擬私有雲網路。
dnsPeeringConfig

object (DnsPeeringConfig)

選用。選用的 DNS 對接設定，用於連線至私人虛擬私有雲網路。

輸出

輸出設定

JSON 表示法 
{
  "networkAttachment": string
}
欄位
networkAttachment

string

選用。網路連結資源的 URI。

DnsPeeringConfig

使用者虛擬私有雲網路的 DNS 對接設定。

JSON 表示法 
{
  "domains": [
    string
  ],
  "targetProject": string,
  "targetNetwork": string
}
欄位
domains[]

string

這是必要旗標，DNS 查詢應轉送至目標網路的網域名稱。
targetProject

string

這是必要旗標，DNS 查詢應轉送至的目標專案 ID。這個專案可以與包含 AgentGateway 的專案相同，也可以是其他專案。
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

 列出指定專案和位置中的 AgentGateway。

patch

 更新單一 AgentGateway 的參數。