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 サーバー、ツールを含む Agent Registry のリスト。注: 現在、プロジェクト スコープのレジストリに限定されています。`//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

下り（外向き）の構成

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

 単一の AgentGateway のパラメータを更新します。