- [Resource: AgentGateway](https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#AgentGateway)
  - [JSON representation](https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#AgentGateway.SCHEMA_REPRESENTATION)
- [GoogleManaged](https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#GoogleManaged)
  - [JSON representation](https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#GoogleManaged.SCHEMA_REPRESENTATION)
- [GovernedAccessPath](https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#GovernedAccessPath)
- [SelfManaged](https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#SelfManaged)
  - [JSON representation](https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#SelfManaged.SCHEMA_REPRESENTATION)
- [Protocol](https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#Protocol)
- [NetworkConfig](https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#NetworkConfig)
  - [JSON representation](https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#NetworkConfig.SCHEMA_REPRESENTATION)
- [Egress](https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#Egress)
  - [JSON representation](https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#Egress.SCHEMA_REPRESENTATION)
- [DnsPeeringConfig](https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#DnsPeeringConfig)
  - [JSON representation](https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#DnsPeeringConfig.SCHEMA_REPRESENTATION)
- [AgentGatewayOutputCard](https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#AgentGatewayOutputCard)
  - [JSON representation](https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#AgentGatewayOutputCard.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#METHODS_SUMMARY)

## Resource: AgentGateway

AgentGateway represents the agent gateway resource.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "description": string, "etag": string, "protocols": [ enum (`https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#Protocol`) ], "registries": [ string ], "networkConfig": { object (`https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#NetworkConfig`) }, "agentGatewayCard": { object (`https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#AgentGatewayOutputCard`) }, // Union field `deployment_mode` can be only one of the following: "googleManaged": { object (`https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#GoogleManaged`) }, "selfManaged": { object (`https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#SelfManaged`) } // End of list of possible types for union field `deployment_mode`. } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. Name of the AgentGateway resource. It matches pattern `projects/*/locations/*/agentGateways/<agentGateway>`. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The timestamp when the resource was created. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The timestamp when the resource was updated. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `labels` | `map (key: string, value: string)` Optional. Set of label tags associated with the AgentGateway resource. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `description` | `string` Optional. A free-text description of the resource. Max length 1024 characters. |
| `etag` | `string` Optional. Etag of the resource. If this is provided, it must match the server's etag. If the provided etag does not match the server's etag, the request will fail with a 409 ABORTED error. |
| `protocols[] (deprecated)` | ``enum (`https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#Protocol`)`` > [!WARNING] > This item is deprecated! Optional. Deprecated. |
| `registries[]` | `string` Optional. A list of Agent registries containing the agents, MCP servers and tools governed by the Agent Gateway. Note: Currently limited to project-scoped registries Must be of format `//agentregistry.googleapis.com/projects/{project}/locations/{location}/` |
| `networkConfig` | ``object (`https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#NetworkConfig`)`` Optional. Network configuration for the AgentGateway. |
| `agentGatewayCard` | ``object (`https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#AgentGatewayOutputCard`)`` Output only. Field for populated AgentGateway card. |
| Union field `deployment_mode`. Deployment mode of the network proxy. Exactly one of the fields in this `oneof` must be set. `deployment_mode` can be only one of the following: ||
| `googleManaged` | ``object (`https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#GoogleManaged`)`` Optional. Proxy is orchestrated and managed by GoogleCloud in a tenant project. |
| `selfManaged` | ``object (`https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#SelfManaged`)`` Optional. Attach to existing Application Load Balancers or Secure Web Proxies. |

## GoogleManaged

Configuration for Google Managed deployment mode. Proxy is orchestrated and managed by GoogleCloud in a tenant project.

| JSON representation |
|---|
| ``` { "governedAccessPath": enum (`https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#GovernedAccessPath`) } ``` |

| Fields ||
|---|---|
| `governedAccessPath` | ``enum (`https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#GovernedAccessPath`)`` Optional. Operating Mode of Agent Gateway. |

## GovernedAccessPath

GovernedAccessPath defines the type of access to protect.

| Enums ||
|---|---|
| `GOVERNED_ACCESS_PATH_UNSPECIFIED` | Governed access path is not specified. |
| `AGENT_TO_ANYWHERE` | Govern agent conections to destinations. |
| `CLIENT_TO_AGENT` | Protect connection to Agent or Tool. |

## SelfManaged

Configuration for Self Managed deployment mode. Attach to existing Application Load Balancers or Secure Web Proxies.

| JSON representation |
|---|
| ``` { "resourceUri": string, "resourceUris": [ string ] } ``` |

| Fields ||
|---|---|
| `resourceUri` | `string` Optional. A supported Google Cloud networking proxy in the Project and Location |
| `resourceUris[]` | `string` Optional. List of supported Google Cloud networking proxies in the Project and Location. resourceUris is mutually exclusive with resourceUri. |

## Protocol

Enums of all supported protocols

| Enums ||
|---|---|
| `PROTOCOL_UNSPECIFIED` | Unspecified protocol. |
| `MCP` | Message Control Plane protocol. |

## NetworkConfig

NetworkConfig contains network configurations for the AgentGateway.

| JSON representation |
|---|
| ``` { "egress": { object (`https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#Egress`) }, "dnsPeeringConfig": { object (`https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#DnsPeeringConfig`) } } ``` |

| Fields ||
|---|---|
| `egress` | ``object (`https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#Egress`)`` Optional. Optional PSC-Interface network attachment for connectivity to your private VPCs network. |
| `dnsPeeringConfig` | ``object (`https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways#DnsPeeringConfig`)`` Optional. Optional DNS peering configuration for connectivity to your private VPC network. |

## Egress

Configuration for Egress

| JSON representation |
|---|
| ``` { "networkAttachment": string } ``` |

| Fields ||
|---|---|
| `networkAttachment` | `string` Optional. The URI of the Network Attachment resource. |

## DnsPeeringConfig

DNS peering config for the user VPC network.

| JSON representation |
|---|
| ``` { "domains": [ string ], "targetProject": string, "targetNetwork": string } ``` |

| Fields ||
|---|---|
| `domains[]` | `string` Required. Domain names for which DNS queries should be forwarded to the target network. |
| `targetProject` | `string` Required. Target project ID to which DNS queries should be forwarded to. This can be the same project that contains the AgentGateway or a different project. |
| `targetNetwork` | `string` Required. Target network in 'target project' to which DNS queries should be forwarded to. Must be in format of `projects/{project}/global/networks/{network}`. |

## AgentGatewayOutputCard

AgentGatewayOutputCard contains informational output-only fields

| JSON representation |
|---|
| ``` { "mtlsEndpoint": string, "rootCertificates": [ string ], "serviceExtensionsServiceAccount": string } ``` |

| Fields ||
|---|---|
| `mtlsEndpoint` | `string` Output only. mTLS Endpoint associated with this AgentGateway |
| `rootCertificates[]` | `string` Output only. Root Certificates for Agents to validate this AgentGateway |
| `serviceExtensionsServiceAccount` | `string` Output only. Service Account used by Service Extensions to operate. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways/create` | Creates a new AgentGateway in a given project and location. |
| ### `https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways/delete` | Deletes a single AgentGateway. |
| ### `https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways/get` | Gets details of a single AgentGateway. |
| ### `https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways/list` | Lists AgentGateways in a given project and location. |
| ### `https://docs.cloud.google.com/service-mesh/docs/reference/network-services/rest/v1/projects.locations.agentGateways/patch` | Updates the parameters of a single AgentGateway. |