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

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

省略可。フリーテキストでのリソースの説明。最大長は 1,024 文字です。
etag

string

省略可。リソースの Etag。これが提供される場合、サーバーの ETag に一致する必要があります。指定された ETag がサーバーの ETag と一致しない場合、リクエストは失敗し、409 ABORTED エラーが返されます。
protocols[]

enum (Protocol)

必須。Agent Gateway でサポートされているプロトコルのリスト
registries[]

string

省略可。Agent Gateway に則って管理されるエージェント、MCP サーバー、ツールを含むエージェント レジストリのリスト。注: 現在はプロジェクト スコープのレジストリに限定されています。`//agentregistry.googleapis.com/projects/{project}/locations/{location}/` の形式にする必要があります。
networkConfig

object (NetworkConfig)

省略可。AgentGateway のネットワーク構成。
agentGatewayCard

object (AgentGatewayOutputCard)

出力専用。AgentGateway カードに入力するフィールド。
共用体フィールド deployment_mode。ネットワーク プロキシのデプロイモード。この oneof のフィールドを 1 つだけ設定する必要があります。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 ピアリング構成（省略可）。

Egress

Egress の構成

JSON 表現 
{
  "networkAttachment": string
}
フィールド
networkAttachment

string

省略可。ネットワーク アタッチメント リソースの URI。

DnsPeeringConfig

ユーザー VPC ネットワークの 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

 1 つの AgentGateway を削除します。

get

 1 つの AgentGateway の詳細を取得します。

list

 指定されたプロジェクトとロケーションの AgentGateway の一覧を取得します。

patch

 1 つの AgentGateway のパラメータを更新します。