@googleapis/networkservices 32.0.1 → 32.2.0

package/build/v1beta1.d.ts

@@ -70,12 +70,145 @@ export declare namespace networkservices_v1beta1 {
         projects: Resource$Projects;
         constructor(options: GlobalOptions, google?: GoogleConfigurable);
     }
+    /**
+     * AgentGateway represents the agent gateway resource.
+     */
+    export interface Schema$AgentGateway {
+        /**
+         * Output only. Field for populated AgentGateway card.
+         */
+        agentGatewayCard?: Schema$AgentGatewayAgentGatewayOutputCard;
+        /**
+         * Output only. The timestamp when the resource was created.
+         */
+        createTime?: string | null;
+        /**
+         * Optional. A free-text description of the resource. Max length 1024 characters.
+         */
+        description?: string | null;
+        /**
+         * 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.
+         */
+        etag?: string | null;
+        /**
+         * Optional. Proxy is orchestrated and managed by GoogleCloud in a tenant project.
+         */
+        googleManaged?: Schema$AgentGatewayGoogleManaged;
+        /**
+         * Optional. Set of label tags associated with the AgentGateway resource.
+         */
+        labels?: {
+            [key: string]: string;
+        } | null;
+        /**
+         * Identifier. Name of the AgentGateway resource. It matches pattern `projects/x/locations/x/agentGateways/`.
+         */
+        name?: string | null;
+        /**
+         * Optional. Network configuration for the AgentGateway.
+         */
+        networkConfig?: Schema$AgentGatewayNetworkConfig;
+        /**
+         * Required. List of protocols supported by an Agent Gateway
+         */
+        protocols?: string[] | null;
+        /**
+         * 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\}/
+         */
+        registries?: string[] | null;
+        /**
+         * Optional. Attach to existing Application Load Balancers or Secure Web Proxies.
+         */
+        selfManaged?: Schema$AgentGatewaySelfManaged;
+        /**
+         * Output only. The timestamp when the resource was updated.
+         */
+        updateTime?: string | null;
+    }
+    /**
+     * AgentGatewayOutputCard contains informational output-only fields
+     */
+    export interface Schema$AgentGatewayAgentGatewayOutputCard {
+        /**
+         * Output only. mTLS Endpoint associated with this AgentGateway
+         */
+        mtlsEndpoint?: string | null;
+        /**
+         * Output only. Root Certificates for Agents to validate this AgentGateway
+         */
+        rootCertificates?: string[] | null;
+        /**
+         * Output only. Service Account used by Service Extensions to operate.
+         */
+        serviceExtensionsServiceAccount?: string | null;
+    }
+    /**
+     * Configuration for Google Managed deployment mode. Proxy is orchestrated and managed by GoogleCloud in a tenant project.
+     */
+    export interface Schema$AgentGatewayGoogleManaged {
+        /**
+         * Optional. Operating Mode of Agent Gateway.
+         */
+        governedAccessPath?: string | null;
+    }
+    /**
+     * NetworkConfig contains network configurations for the AgentGateway.
+     */
+    export interface Schema$AgentGatewayNetworkConfig {
+        /**
+         * Optional. Optional DNS peering configuration for connectivity to your private VPC network.
+         */
+        dnsPeeringConfig?: Schema$AgentGatewayNetworkConfigDnsPeeringConfig;
+        /**
+         * Optional. Optional PSC-Interface network attachment for connectivity to your private VPCs network.
+         */
+        egress?: Schema$AgentGatewayNetworkConfigEgress;
+    }
+    /**
+     * DNS peering config for the user VPC network.
+     */
+    export interface Schema$AgentGatewayNetworkConfigDnsPeeringConfig {
+        /**
+         * Required. Domain names for which DNS queries should be forwarded to the target network.
+         */
+        domains?: string[] | null;
+        /**
+         * Required. Target network in 'target project' to which DNS queries should be forwarded to. Must be in format of `projects/{project\}/global/networks/{network\}`.
+         */
+        targetNetwork?: string | null;
+        /**
+         * 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.
+         */
+        targetProject?: string | null;
+    }
+    /**
+     * Configuration for Egress
+     */
+    export interface Schema$AgentGatewayNetworkConfigEgress {
+        /**
+         * Optional. The URI of the Network Attachment resource.
+         */
+        networkAttachment?: string | null;
+    }
+    /**
+     * Configuration for Self Managed deployment mode. Attach to existing Application Load Balancers or Secure Web Proxies.
+     */
+    export interface Schema$AgentGatewaySelfManaged {
+        /**
+         * Optional. A supported Google Cloud networking proxy in the Project and Location
+         */
+        resourceUri?: string | null;
+        /**
+         * Optional. List of supported Google Cloud networking proxies in the Project and Location. resource_uris is mutually exclusive with resource_uri.
+         */
+        resourceUris?: string[] | null;
+    }
     /**
      * `AuthzExtension` is a resource that allows traffic forwarding to a callout backend service to make an authorization decision.
      */
     export interface Schema$AuthzExtension {
         /**
-         * Required. The `:authority` header in the gRPC request sent from Envoy to the extension service.
+         * Optional. The `:authority` header in the gRPC request sent from Envoy to the extension service. It is required when the `service` field points to a backend service or a wasm plugin.
          */
         authority?: string | null;
         /**
@@ -90,6 +223,10 @@ export declare namespace networkservices_v1beta1 {
          * Optional. Determines how the proxy behaves if the call to the extension fails or times out. When set to `TRUE`, request or response processing continues without error. Any subsequent extensions in the extension chain are also executed. When set to `FALSE` or the default setting of `FALSE` is used, one of the following happens: * If response headers have not been delivered to the downstream client, a generic 500 error is returned to the client. The error response can be tailored by configuring a custom error response in the load balancer. * If response headers have been delivered, then the HTTP stream to the downstream client is reset.
          */
         failOpen?: boolean | null;
+        /**
+         * Optional. List of the Envoy attributes to forward to the extension server. The attributes provided here are included as part of the `ProcessingRequest.attributes` field (of type `map`), where the keys are the attribute names. Refer to the [documentation](https://cloud.google.com/service-extensions/docs/cel-matcher-language-reference#attributes) for the names of attributes that can be forwarded. If omitted, no attributes are sent. Each element is a string indicating the attribute name.
+         */
+        forwardAttributes?: string[] | null;
         /**
          * Optional. List of the HTTP headers to forward to the extension (from the client). If omitted, all headers are sent. Each element is a string indicating the header name.
          */
@@ -101,7 +238,7 @@ export declare namespace networkservices_v1beta1 {
             [key: string]: string;
         } | null;
         /**
-         * Required. All backend services and forwarding rules referenced by this extension must share the same load balancing scheme. Supported values: `INTERNAL_MANAGED`, `EXTERNAL_MANAGED`. For more information, refer to [Backend services overview](https://cloud.google.com/load-balancing/docs/backend-service).
+         * Optional. All backend services and forwarding rules referenced by this extension must share the same load balancing scheme. Supported values: `INTERNAL_MANAGED`, `EXTERNAL_MANAGED`. Can be omitted for AuthzExtensions that do not reference a backend service. For more information, refer to [Backend services overview](https://cloud.google.com/load-balancing/docs/backend-service).
          */
         loadBalancingScheme?: string | null;
         /**
@@ -127,7 +264,7 @@ export declare namespace networkservices_v1beta1 {
          */
         updateTime?: string | null;
         /**
-         * Optional. The format of communication supported by the callout extension. If not specified, the default value `EXT_PROC_GRPC` is used.
+         * Optional. The format of communication supported by the callout extension. This field is supported only for regional `AuthzExtension` resources. If not specified, the default value `EXT_PROC_GRPC` is used. Global `AuthzExtension` resources use the `EXT_PROC_GRPC` wire format.
          */
         wireFormat?: string | null;
     }
@@ -238,6 +375,10 @@ export declare namespace networkservices_v1beta1 {
          * Optional. Determines how the proxy behaves if the call to the extension fails or times out. When set to `TRUE`, request or response processing continues without error. Any subsequent extensions in the extension chain are also executed. When set to `FALSE` or the default setting of `FALSE` is used, one of the following happens: * If response headers have not been delivered to the downstream client, a generic 500 error is returned to the client. The error response can be tailored by configuring a custom error response in the load balancer. * If response headers have been delivered, then the HTTP stream to the downstream client is reset.
          */
         failOpen?: boolean | null;
+        /**
+         * Optional. List of the Envoy attributes to forward to the extension server. The attributes provided here are included as part of the `ProcessingRequest.attributes` field (of type `map`), where the keys are the attribute names. Refer to the [documentation](https://cloud.google.com/service-extensions/docs/cel-matcher-language-reference#attributes) for the names of attributes that can be forwarded. If omitted, no attributes are sent. Each element is a string indicating the attribute name.
+         */
+        forwardAttributes?: string[] | null;
         /**
          * Optional. List of the HTTP headers to forward to the extension (from the client or backend). If omitted, all headers are sent. Each element is a string indicating the header name.
          */
@@ -253,7 +394,7 @@ export declare namespace networkservices_v1beta1 {
          */
         name?: string | null;
         /**
-         * Optional. When set to `TRUE`, enables `observability_mode` on the `ext_proc` filter. This makes `ext_proc` calls asynchronous. Envoy doesn't check for the response from `ext_proc` calls. For more information about the filter, see: https://www.envoyproxy.io/docs/envoy/v1.32.3/api-v3/extensions/filters/http/ext_proc/v3/ext_proc.proto#extensions-filters-http-ext-proc-v3-externalprocessor This field is helpful when you want to try out the extension in async log-only mode. Supported by regional `LbTrafficExtension` and `LbRouteExtension` resources. Only `STREAMED` (default) body processing mode is supported.
+         * Optional. When set to `true`, the calls to the extension backend are performed asynchronously, without pausing the processing of the ongoing request. In this mode, only `STREAMED` (default) body processing is supported. Responses, if any, are ignored. Supported by regional `LbTrafficExtension` and `LbRouteExtension` resources.
          */
         observabilityMode?: boolean | null;
         /**
@@ -294,6 +435,14 @@ export declare namespace networkservices_v1beta1 {
          * Optional. Zero or one IPv4 or IPv6 address on which the Gateway will receive the traffic. When no address is provided, an IP from the subnetwork is allocated This field only applies to gateways of type 'SECURE_WEB_GATEWAY'. Gateways of type 'OPEN_MESH' listen on 0.0.0.0 for IPv4 and :: for IPv6.
          */
         addresses?: string[] | null;
+        /**
+         * Optional. If true, the gateway will allow traffic from clients outside of the region where the gateway is located. This field is configurable only for gateways of type SECURE_WEB_GATEWAY.
+         */
+        allowGlobalAccess?: boolean | null;
+        /**
+         * Optional. If true, the Gateway will listen on all ports. This is mutually exclusive with the `ports` field. This field only applies to gateways of type 'SECURE_WEB_GATEWAY'.
+         */
+        allPorts?: boolean | null;
         /**
          * Optional. A fully-qualified Certificates URL reference. The proxy presents a Certificate (selected based on SNI) when establishing a TLS connection. This feature only applies to gateways of type 'SECURE_WEB_GATEWAY'.
          */
@@ -1209,6 +1358,23 @@ export declare namespace networkservices_v1beta1 {
          */
         updateTime?: string | null;
     }
+    /**
+     * Response returned by the ListAgentGateways method.
+     */
+    export interface Schema$ListAgentGatewaysResponse {
+        /**
+         * List of AgentGateway resources.
+         */
+        agentGateways?: Schema$AgentGateway[];
+        /**
+         * If there might be more results than those appearing in this response, then `next_page_token` is included. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`.
+         */
+        nextPageToken?: string | null;
+        /**
+         * Unreachable resources. Populated when the request attempts to list all resources across all supported locations, while some locations are temporarily unavailable.
+         */
+        unreachable?: string[] | null;
+    }
     /**
      * Message for response to listing `AuthzExtension` resources.
      */
@@ -1439,7 +1605,7 @@ export declare namespace networkservices_v1beta1 {
          */
         operations?: Schema$Operation[];
         /**
-         * Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections e.g. when attempting to list all resources across all supported locations.
+         * Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.
          */
         unreachable?: string[] | null;
     }
@@ -2006,6 +2172,10 @@ export declare namespace networkservices_v1beta1 {
          * Output only. Server-defined URL of this resource
          */
         selfLink?: string | null;
+        /**
+         * Optional. TargetProxies defines a list of TargetTcpProxies this TlsRoute is attached to, as one of the routing rules to route the requests served by the TargetTcpProxy. Each TargetTcpProxy reference should match the pattern: `projects/x/locations/x/targetTcpProxies/`
+         */
+        targetProxies?: string[] | null;
         /**
          * Output only. The timestamp when the resource was updated.
          */
@@ -2084,6 +2254,14 @@ export declare namespace networkservices_v1beta1 {
          * Optional. A human-readable description of the resource.
          */
         description?: string | null;
+        /**
+         * Optional. The name of the customer managed Cloud KMS key to be used to encrypt the `WasmPlugin` image (provided by image_uri) and configuration (provided by plugin_config_data or plugin_config_uri) that are stored by the `Service Extensions` product at rest. Format: "projects/{project\}/locations/{location\}/keyRings/{keyring\}/cryptoKeys/{key\}" By default, Google Cloud automatically encrypts all data at rest using Google-owned and Google-managed encryption keys. If you need ownership and control of the keys that protect your data at rest, you can specify a customer-managed encryption key (CMEK) to encrypt your `WasmPlugin` data. For more information, see [Using customer-managed encryption keys](https://cloud.google.com/kms/docs/cmek).
+         */
+        kmsKeyName?: string | null;
+        /**
+         * Output only. The name of the specific CryptoKeyVersion used to encrypt the `WasmPlugin` data, if the kms_key_name field is set. Format: "projects/{project\}/locations/{location\}/keyRings/{keyring\}/cryptoKeys/{key\}/cryptoKeyVersions/{version\}" This is a read-only field. `WasmPlugin` data is automatically encrypted using the most recent `CryptoKeyVersion` of the `CryptoKey` provided in the `kms_key_name` field. See [Cloud KMS resources](https://cloud.google.com/kms/docs/resource-hierarchy) for more information.
+         */
+        kmsKeyVersion?: string | null;
         /**
          * Optional. Set of labels associated with the `WasmPlugin` resource. The format must comply with [the following requirements](/compute/docs/labeling-resources#requirements).
          */
@@ -2240,6 +2418,7 @@ export declare namespace networkservices_v1beta1 {
     }
     export class Resource$Projects$Locations {
         context: APIRequestContext;
+        agentGateways: Resource$Projects$Locations$Agentgateways;
         authzExtensions: Resource$Projects$Locations$Authzextensions;
         endpointPolicies: Resource$Projects$Locations$Endpointpolicies;
         gateways: Resource$Projects$Locations$Gateways;
@@ -2322,7 +2501,7 @@ export declare namespace networkservices_v1beta1 {
         get(params: Params$Resource$Projects$Locations$Get, callback: BodyResponseCallback<Schema$Location>): void;
         get(callback: BodyResponseCallback<Schema$Location>): void;
         /**
-         * Lists information about the supported locations for this service.
+         * Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project\}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.
          * @example
          * ```js
          * // Before running the sample:
@@ -2352,7 +2531,7 @@ export declare namespace networkservices_v1beta1 {
          *
          *   // Do the magic
          *   const res = await networkservices.projects.locations.list({
-         *     // Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.
+         *     // Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage.
          *     extraLocationTypes: 'placeholder-value',
          *     // A filter to narrow down results to a preferred subset. The filtering language accepts strings like `"displayName=tokyo"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).
          *     filter: 'placeholder-value',
@@ -2399,7 +2578,7 @@ export declare namespace networkservices_v1beta1 {
     }
     export interface Params$Resource$Projects$Locations$List extends StandardParameters {
         /**
-         * Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.
+         * Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage.
          */
         extraLocationTypes?: string[];
         /**
@@ -2419,6 +2598,447 @@ export declare namespace networkservices_v1beta1 {
          */
         pageToken?: string;
     }
+    export class Resource$Projects$Locations$Agentgateways {
+        context: APIRequestContext;
+        constructor(context: APIRequestContext);
+        /**
+         * Creates a new AgentGateway in a given project and location.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/networkservices.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const networkservices = google.networkservices('v1beta1');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await networkservices.projects.locations.agentGateways.create({
+         *     // Required. Short name of the AgentGateway resource to be created.
+         *     agentGatewayId: 'placeholder-value',
+         *     // Required. The parent resource of the AgentGateway. Must be in the format `projects/x/locations/x`.
+         *     parent: 'projects/my-project/locations/my-location',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "agentGatewayCard": {},
+         *       //   "createTime": "my_createTime",
+         *       //   "description": "my_description",
+         *       //   "etag": "my_etag",
+         *       //   "googleManaged": {},
+         *       //   "labels": {},
+         *       //   "name": "my_name",
+         *       //   "networkConfig": {},
+         *       //   "protocols": [],
+         *       //   "registries": [],
+         *       //   "selfManaged": {},
+         *       //   "updateTime": "my_updateTime"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        create(params: Params$Resource$Projects$Locations$Agentgateways$Create, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        create(params?: Params$Resource$Projects$Locations$Agentgateways$Create, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
+        create(params: Params$Resource$Projects$Locations$Agentgateways$Create, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        create(params: Params$Resource$Projects$Locations$Agentgateways$Create, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
+        create(params: Params$Resource$Projects$Locations$Agentgateways$Create, callback: BodyResponseCallback<Schema$Operation>): void;
+        create(callback: BodyResponseCallback<Schema$Operation>): void;
+        /**
+         * Deletes a single AgentGateway.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/networkservices.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const networkservices = google.networkservices('v1beta1');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await networkservices.projects.locations.agentGateways.delete({
+         *     // Optional. The etag of the AgentGateway to delete.
+         *     etag: 'placeholder-value',
+         *     // Required. A name of the AgentGateway to delete. Must be in the format `projects/x/locations/x/agentGateways/x`.
+         *     name: 'projects/my-project/locations/my-location/agentGateways/my-agentGateway',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        delete(params: Params$Resource$Projects$Locations$Agentgateways$Delete, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        delete(params?: Params$Resource$Projects$Locations$Agentgateways$Delete, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
+        delete(params: Params$Resource$Projects$Locations$Agentgateways$Delete, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        delete(params: Params$Resource$Projects$Locations$Agentgateways$Delete, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
+        delete(params: Params$Resource$Projects$Locations$Agentgateways$Delete, callback: BodyResponseCallback<Schema$Operation>): void;
+        delete(callback: BodyResponseCallback<Schema$Operation>): void;
+        /**
+         * Gets details of a single AgentGateway.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/networkservices.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const networkservices = google.networkservices('v1beta1');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await networkservices.projects.locations.agentGateways.get({
+         *     // Required. A name of the AgentGateway to get. Must be in the format `projects/x/locations/x/agentGateways/x`.
+         *     name: 'projects/my-project/locations/my-location/agentGateways/my-agentGateway',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "agentGatewayCard": {},
+         *   //   "createTime": "my_createTime",
+         *   //   "description": "my_description",
+         *   //   "etag": "my_etag",
+         *   //   "googleManaged": {},
+         *   //   "labels": {},
+         *   //   "name": "my_name",
+         *   //   "networkConfig": {},
+         *   //   "protocols": [],
+         *   //   "registries": [],
+         *   //   "selfManaged": {},
+         *   //   "updateTime": "my_updateTime"
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        get(params: Params$Resource$Projects$Locations$Agentgateways$Get, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        get(params?: Params$Resource$Projects$Locations$Agentgateways$Get, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$AgentGateway>>;
+        get(params: Params$Resource$Projects$Locations$Agentgateways$Get, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        get(params: Params$Resource$Projects$Locations$Agentgateways$Get, options: MethodOptions | BodyResponseCallback<Schema$AgentGateway>, callback: BodyResponseCallback<Schema$AgentGateway>): void;
+        get(params: Params$Resource$Projects$Locations$Agentgateways$Get, callback: BodyResponseCallback<Schema$AgentGateway>): void;
+        get(callback: BodyResponseCallback<Schema$AgentGateway>): void;
+        /**
+         * Lists AgentGateways in a given project and location.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/networkservices.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const networkservices = google.networkservices('v1beta1');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await networkservices.projects.locations.agentGateways.list({
+         *     // Optional. Maximum number of AgentGateways to return per call.
+         *     pageSize: 'placeholder-value',
+         *     // Optional. The value returned by the last `ListAgentGatewaysResponse` Indicates that this is a continuation of a prior `ListAgentGateways` call, and that the system should return the next page of data.
+         *     pageToken: 'placeholder-value',
+         *     // Required. The project and location from which the AgentGateways should be listed, specified in the format `projects/x/locations/x`.
+         *     parent: 'projects/my-project/locations/my-location',
+         *     // Optional. If true, allow partial responses for multi-regional Aggregated List requests. Otherwise if one of the locations is down or unreachable, the Aggregated List request will fail.
+         *     returnPartialSuccess: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "agentGateways": [],
+         *   //   "nextPageToken": "my_nextPageToken",
+         *   //   "unreachable": []
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        list(params: Params$Resource$Projects$Locations$Agentgateways$List, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        list(params?: Params$Resource$Projects$Locations$Agentgateways$List, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$ListAgentGatewaysResponse>>;
+        list(params: Params$Resource$Projects$Locations$Agentgateways$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        list(params: Params$Resource$Projects$Locations$Agentgateways$List, options: MethodOptions | BodyResponseCallback<Schema$ListAgentGatewaysResponse>, callback: BodyResponseCallback<Schema$ListAgentGatewaysResponse>): void;
+        list(params: Params$Resource$Projects$Locations$Agentgateways$List, callback: BodyResponseCallback<Schema$ListAgentGatewaysResponse>): void;
+        list(callback: BodyResponseCallback<Schema$ListAgentGatewaysResponse>): void;
+        /**
+         * Updates the parameters of a single AgentGateway.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/networkservices.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const networkservices = google.networkservices('v1beta1');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await networkservices.projects.locations.agentGateways.patch({
+         *     // Identifier. Name of the AgentGateway resource. It matches pattern `projects/x/locations/x/agentGateways/`.
+         *     name: 'projects/my-project/locations/my-location/agentGateways/my-agentGateway',
+         *     // Optional. Field mask is used to specify the fields to be overwritten in the AgentGateway resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.
+         *     updateMask: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "agentGatewayCard": {},
+         *       //   "createTime": "my_createTime",
+         *       //   "description": "my_description",
+         *       //   "etag": "my_etag",
+         *       //   "googleManaged": {},
+         *       //   "labels": {},
+         *       //   "name": "my_name",
+         *       //   "networkConfig": {},
+         *       //   "protocols": [],
+         *       //   "registries": [],
+         *       //   "selfManaged": {},
+         *       //   "updateTime": "my_updateTime"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        patch(params: Params$Resource$Projects$Locations$Agentgateways$Patch, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        patch(params?: Params$Resource$Projects$Locations$Agentgateways$Patch, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
+        patch(params: Params$Resource$Projects$Locations$Agentgateways$Patch, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        patch(params: Params$Resource$Projects$Locations$Agentgateways$Patch, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
+        patch(params: Params$Resource$Projects$Locations$Agentgateways$Patch, callback: BodyResponseCallback<Schema$Operation>): void;
+        patch(callback: BodyResponseCallback<Schema$Operation>): void;
+    }
+    export interface Params$Resource$Projects$Locations$Agentgateways$Create extends StandardParameters {
+        /**
+         * Required. Short name of the AgentGateway resource to be created.
+         */
+        agentGatewayId?: string;
+        /**
+         * Required. The parent resource of the AgentGateway. Must be in the format `projects/x/locations/x`.
+         */
+        parent?: string;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$AgentGateway;
+    }
+    export interface Params$Resource$Projects$Locations$Agentgateways$Delete extends StandardParameters {
+        /**
+         * Optional. The etag of the AgentGateway to delete.
+         */
+        etag?: string;
+        /**
+         * Required. A name of the AgentGateway to delete. Must be in the format `projects/x/locations/x/agentGateways/x`.
+         */
+        name?: string;
+    }
+    export interface Params$Resource$Projects$Locations$Agentgateways$Get extends StandardParameters {
+        /**
+         * Required. A name of the AgentGateway to get. Must be in the format `projects/x/locations/x/agentGateways/x`.
+         */
+        name?: string;
+    }
+    export interface Params$Resource$Projects$Locations$Agentgateways$List extends StandardParameters {
+        /**
+         * Optional. Maximum number of AgentGateways to return per call.
+         */
+        pageSize?: number;
+        /**
+         * Optional. The value returned by the last `ListAgentGatewaysResponse` Indicates that this is a continuation of a prior `ListAgentGateways` call, and that the system should return the next page of data.
+         */
+        pageToken?: string;
+        /**
+         * Required. The project and location from which the AgentGateways should be listed, specified in the format `projects/x/locations/x`.
+         */
+        parent?: string;
+        /**
+         * Optional. If true, allow partial responses for multi-regional Aggregated List requests. Otherwise if one of the locations is down or unreachable, the Aggregated List request will fail.
+         */
+        returnPartialSuccess?: boolean;
+    }
+    export interface Params$Resource$Projects$Locations$Agentgateways$Patch extends StandardParameters {
+        /**
+         * Identifier. Name of the AgentGateway resource. It matches pattern `projects/x/locations/x/agentGateways/`.
+         */
+        name?: string;
+        /**
+         * Optional. Field mask is used to specify the fields to be overwritten in the AgentGateway resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.
+         */
+        updateMask?: string;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$AgentGateway;
+    }
     export class Resource$Projects$Locations$Authzextensions {
         context: APIRequestContext;
         constructor(context: APIRequestContext);
@@ -2468,6 +3088,7 @@ export declare namespace networkservices_v1beta1 {
          *       //   "createTime": "my_createTime",
          *       //   "description": "my_description",
          *       //   "failOpen": false,
+         *       //   "forwardAttributes": [],
          *       //   "forwardHeaders": [],
          *       //   "labels": {},
          *       //   "loadBalancingScheme": "my_loadBalancingScheme",
@@ -2618,6 +3239,7 @@ export declare namespace networkservices_v1beta1 {
          *   //   "createTime": "my_createTime",
          *   //   "description": "my_description",
          *   //   "failOpen": false,
+         *   //   "forwardAttributes": [],
          *   //   "forwardHeaders": [],
          *   //   "labels": {},
          *   //   "loadBalancingScheme": "my_loadBalancingScheme",
@@ -2764,6 +3386,7 @@ export declare namespace networkservices_v1beta1 {
          *       //   "createTime": "my_createTime",
          *       //   "description": "my_description",
          *       //   "failOpen": false,
+         *       //   "forwardAttributes": [],
          *       //   "forwardHeaders": [],
          *       //   "labels": {},
          *       //   "loadBalancingScheme": "my_loadBalancingScheme",
@@ -3361,6 +3984,8 @@ export declare namespace networkservices_v1beta1 {
          *       // request body parameters
          *       // {
          *       //   "addresses": [],
+         *       //   "allPorts": false,
+         *       //   "allowGlobalAccess": false,
          *       //   "certificateUrls": [],
          *       //   "createTime": "my_createTime",
          *       //   "description": "my_description",
@@ -3514,6 +4139,8 @@ export declare namespace networkservices_v1beta1 {
          *   // Example response
          *   // {
          *   //   "addresses": [],
+         *   //   "allPorts": false,
+         *   //   "allowGlobalAccess": false,
          *   //   "certificateUrls": [],
          *   //   "createTime": "my_createTime",
          *   //   "description": "my_description",
@@ -3659,6 +4286,8 @@ export declare namespace networkservices_v1beta1 {
          *       // request body parameters
          *       // {
          *       //   "addresses": [],
+         *       //   "allPorts": false,
+         *       //   "allowGlobalAccess": false,
          *       //   "certificateUrls": [],
          *       //   "createTime": "my_createTime",
          *       //   "description": "my_description",
@@ -4387,6 +5016,8 @@ export declare namespace networkservices_v1beta1 {
          *     httpRouteId: 'placeholder-value',
          *     // Required. The parent resource of the HttpRoute. Must be in the format `projects/x/locations/x`.
          *     parent: 'projects/my-project/locations/my-location',
+         *     // Optional. Idempotent request UUID.
+         *     requestId: 'placeholder-value',
          *
          *     // Request body metadata
          *     requestBody: {
@@ -4599,6 +5230,8 @@ export declare namespace networkservices_v1beta1 {
          *
          *   // Do the magic
          *   const res = await networkservices.projects.locations.httpRoutes.list({
+         *     // Optional. Filter expression to restrict the list.
+         *     filter: 'placeholder-value',
          *     // Maximum number of HttpRoutes to return per call.
          *     pageSize: 'placeholder-value',
          *     // The value returned by the last `ListHttpRoutesResponse` Indicates that this is a continuation of a prior `ListHttpRoutes` call, and that the system should return the next page of data.
@@ -4729,6 +5362,10 @@ export declare namespace networkservices_v1beta1 {
          * Required. The parent resource of the HttpRoute. Must be in the format `projects/x/locations/x`.
          */
         parent?: string;
+        /**
+         * Optional. Idempotent request UUID.
+         */
+        requestId?: string;
         /**
          * Request body metadata
          */
@@ -4747,6 +5384,10 @@ export declare namespace networkservices_v1beta1 {
         name?: string;
     }
     export interface Params$Resource$Projects$Locations$Httproutes$List extends StandardParameters {
+        /**
+         * Optional. Filter expression to restrict the list.
+         */
+        filter?: string;
         /**
          * Maximum number of HttpRoutes to return per call.
          */
@@ -7387,7 +8028,7 @@ export declare namespace networkservices_v1beta1 {
          *     pageSize: 'placeholder-value',
          *     // The standard list page token.
          *     pageToken: 'placeholder-value',
-         *     // When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `"projects/example/locations/-"`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.
+         *     // When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `"projects/example/locations/-"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.
          *     returnPartialSuccess: 'placeholder-value',
          *   });
          *   console.log(res.data);
@@ -7459,7 +8100,7 @@ export declare namespace networkservices_v1beta1 {
          */
         pageToken?: string;
         /**
-         * When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `"projects/example/locations/-"`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.
+         * When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `"projects/example/locations/-"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.
          */
         returnPartialSuccess?: boolean;
     }
@@ -8778,6 +9419,7 @@ export declare namespace networkservices_v1beta1 {
          *       //   "name": "my_name",
          *       //   "rules": [],
          *       //   "selfLink": "my_selfLink",
+         *       //   "targetProxies": [],
          *       //   "updateTime": "my_updateTime"
          *       // }
          *     },
@@ -8922,6 +9564,7 @@ export declare namespace networkservices_v1beta1 {
          *   //   "name": "my_name",
          *   //   "rules": [],
          *   //   "selfLink": "my_selfLink",
+         *   //   "targetProxies": [],
          *   //   "updateTime": "my_updateTime"
          *   // }
          * }
@@ -9060,6 +9703,7 @@ export declare namespace networkservices_v1beta1 {
          *       //   "name": "my_name",
          *       //   "rules": [],
          *       //   "selfLink": "my_selfLink",
+         *       //   "targetProxies": [],
          *       //   "updateTime": "my_updateTime"
          *       // }
          *     },
@@ -9199,6 +9843,8 @@ export declare namespace networkservices_v1beta1 {
          *       // {
          *       //   "createTime": "my_createTime",
          *       //   "description": "my_description",
+         *       //   "kmsKeyName": "my_kmsKeyName",
+         *       //   "kmsKeyVersion": "my_kmsKeyVersion",
          *       //   "labels": {},
          *       //   "logConfig": {},
          *       //   "mainVersionId": "my_mainVersionId",
@@ -9345,6 +9991,8 @@ export declare namespace networkservices_v1beta1 {
          *   // {
          *   //   "createTime": "my_createTime",
          *   //   "description": "my_description",
+         *   //   "kmsKeyName": "my_kmsKeyName",
+         *   //   "kmsKeyVersion": "my_kmsKeyVersion",
          *   //   "labels": {},
          *   //   "logConfig": {},
          *   //   "mainVersionId": "my_mainVersionId",
@@ -9481,6 +10129,8 @@ export declare namespace networkservices_v1beta1 {
          *       // {
          *       //   "createTime": "my_createTime",
          *       //   "description": "my_description",
+         *       //   "kmsKeyName": "my_kmsKeyName",
+         *       //   "kmsKeyVersion": "my_kmsKeyVersion",
          *       //   "labels": {},
          *       //   "logConfig": {},
          *       //   "mainVersionId": "my_mainVersionId",