@googleapis/networkservices 32.1.0 → 32.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -70,12 +70,145 @@ export declare namespace networkservices_v1beta1 {
70
70
  projects: Resource$Projects;
71
71
  constructor(options: GlobalOptions, google?: GoogleConfigurable);
72
72
  }
73
+ /**
74
+ * AgentGateway represents the agent gateway resource.
75
+ */
76
+ export interface Schema$AgentGateway {
77
+ /**
78
+ * Output only. Field for populated AgentGateway card.
79
+ */
80
+ agentGatewayCard?: Schema$AgentGatewayAgentGatewayOutputCard;
81
+ /**
82
+ * Output only. The timestamp when the resource was created.
83
+ */
84
+ createTime?: string | null;
85
+ /**
86
+ * Optional. A free-text description of the resource. Max length 1024 characters.
87
+ */
88
+ description?: string | null;
89
+ /**
90
+ * 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.
91
+ */
92
+ etag?: string | null;
93
+ /**
94
+ * Optional. Proxy is orchestrated and managed by GoogleCloud in a tenant project.
95
+ */
96
+ googleManaged?: Schema$AgentGatewayGoogleManaged;
97
+ /**
98
+ * Optional. Set of label tags associated with the AgentGateway resource.
99
+ */
100
+ labels?: {
101
+ [key: string]: string;
102
+ } | null;
103
+ /**
104
+ * Identifier. Name of the AgentGateway resource. It matches pattern `projects/x/locations/x/agentGateways/`.
105
+ */
106
+ name?: string | null;
107
+ /**
108
+ * Optional. Network configuration for the AgentGateway.
109
+ */
110
+ networkConfig?: Schema$AgentGatewayNetworkConfig;
111
+ /**
112
+ * Required. List of protocols supported by an Agent Gateway
113
+ */
114
+ protocols?: string[] | null;
115
+ /**
116
+ * 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\}/
117
+ */
118
+ registries?: string[] | null;
119
+ /**
120
+ * Optional. Attach to existing Application Load Balancers or Secure Web Proxies.
121
+ */
122
+ selfManaged?: Schema$AgentGatewaySelfManaged;
123
+ /**
124
+ * Output only. The timestamp when the resource was updated.
125
+ */
126
+ updateTime?: string | null;
127
+ }
128
+ /**
129
+ * AgentGatewayOutputCard contains informational output-only fields
130
+ */
131
+ export interface Schema$AgentGatewayAgentGatewayOutputCard {
132
+ /**
133
+ * Output only. mTLS Endpoint associated with this AgentGateway
134
+ */
135
+ mtlsEndpoint?: string | null;
136
+ /**
137
+ * Output only. Root Certificates for Agents to validate this AgentGateway
138
+ */
139
+ rootCertificates?: string[] | null;
140
+ /**
141
+ * Output only. Service Account used by Service Extensions to operate.
142
+ */
143
+ serviceExtensionsServiceAccount?: string | null;
144
+ }
145
+ /**
146
+ * Configuration for Google Managed deployment mode. Proxy is orchestrated and managed by GoogleCloud in a tenant project.
147
+ */
148
+ export interface Schema$AgentGatewayGoogleManaged {
149
+ /**
150
+ * Optional. Operating Mode of Agent Gateway.
151
+ */
152
+ governedAccessPath?: string | null;
153
+ }
154
+ /**
155
+ * NetworkConfig contains network configurations for the AgentGateway.
156
+ */
157
+ export interface Schema$AgentGatewayNetworkConfig {
158
+ /**
159
+ * Optional. Optional DNS peering configuration for connectivity to your private VPC network.
160
+ */
161
+ dnsPeeringConfig?: Schema$AgentGatewayNetworkConfigDnsPeeringConfig;
162
+ /**
163
+ * Optional. Optional PSC-Interface network attachment for connectivity to your private VPCs network.
164
+ */
165
+ egress?: Schema$AgentGatewayNetworkConfigEgress;
166
+ }
167
+ /**
168
+ * DNS peering config for the user VPC network.
169
+ */
170
+ export interface Schema$AgentGatewayNetworkConfigDnsPeeringConfig {
171
+ /**
172
+ * Required. Domain names for which DNS queries should be forwarded to the target network.
173
+ */
174
+ domains?: string[] | null;
175
+ /**
176
+ * Required. Target network in 'target project' to which DNS queries should be forwarded to. Must be in format of `projects/{project\}/global/networks/{network\}`.
177
+ */
178
+ targetNetwork?: string | null;
179
+ /**
180
+ * 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.
181
+ */
182
+ targetProject?: string | null;
183
+ }
184
+ /**
185
+ * Configuration for Egress
186
+ */
187
+ export interface Schema$AgentGatewayNetworkConfigEgress {
188
+ /**
189
+ * Optional. The URI of the Network Attachment resource.
190
+ */
191
+ networkAttachment?: string | null;
192
+ }
193
+ /**
194
+ * Configuration for Self Managed deployment mode. Attach to existing Application Load Balancers or Secure Web Proxies.
195
+ */
196
+ export interface Schema$AgentGatewaySelfManaged {
197
+ /**
198
+ * Optional. A supported Google Cloud networking proxy in the Project and Location
199
+ */
200
+ resourceUri?: string | null;
201
+ /**
202
+ * Optional. List of supported Google Cloud networking proxies in the Project and Location. resource_uris is mutually exclusive with resource_uri.
203
+ */
204
+ resourceUris?: string[] | null;
205
+ }
73
206
  /**
74
207
  * `AuthzExtension` is a resource that allows traffic forwarding to a callout backend service to make an authorization decision.
75
208
  */
76
209
  export interface Schema$AuthzExtension {
77
210
  /**
78
- * Required. The `:authority` header in the gRPC request sent from Envoy to the extension service.
211
+ * 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.
79
212
  */
80
213
  authority?: string | null;
81
214
  /**
@@ -90,6 +223,10 @@ export declare namespace networkservices_v1beta1 {
90
223
  * 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.
91
224
  */
92
225
  failOpen?: boolean | null;
226
+ /**
227
+ * 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.
228
+ */
229
+ forwardAttributes?: string[] | null;
93
230
  /**
94
231
  * 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.
95
232
  */
@@ -101,7 +238,7 @@ export declare namespace networkservices_v1beta1 {
101
238
  [key: string]: string;
102
239
  } | null;
103
240
  /**
104
- * 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).
241
+ * 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).
105
242
  */
106
243
  loadBalancingScheme?: string | null;
107
244
  /**
@@ -238,6 +375,10 @@ export declare namespace networkservices_v1beta1 {
238
375
  * 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.
239
376
  */
240
377
  failOpen?: boolean | null;
378
+ /**
379
+ * 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.
380
+ */
381
+ forwardAttributes?: string[] | null;
241
382
  /**
242
383
  * 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.
243
384
  */
@@ -253,7 +394,7 @@ export declare namespace networkservices_v1beta1 {
253
394
  */
254
395
  name?: string | null;
255
396
  /**
256
- * 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.
397
+ * 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.
257
398
  */
258
399
  observabilityMode?: boolean | null;
259
400
  /**
@@ -294,6 +435,14 @@ export declare namespace networkservices_v1beta1 {
294
435
  * 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.
295
436
  */
296
437
  addresses?: string[] | null;
438
+ /**
439
+ * 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.
440
+ */
441
+ allowGlobalAccess?: boolean | null;
442
+ /**
443
+ * 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'.
444
+ */
445
+ allPorts?: boolean | null;
297
446
  /**
298
447
  * 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'.
299
448
  */
@@ -1209,6 +1358,23 @@ export declare namespace networkservices_v1beta1 {
1209
1358
  */
1210
1359
  updateTime?: string | null;
1211
1360
  }
1361
+ /**
1362
+ * Response returned by the ListAgentGateways method.
1363
+ */
1364
+ export interface Schema$ListAgentGatewaysResponse {
1365
+ /**
1366
+ * List of AgentGateway resources.
1367
+ */
1368
+ agentGateways?: Schema$AgentGateway[];
1369
+ /**
1370
+ * 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`.
1371
+ */
1372
+ nextPageToken?: string | null;
1373
+ /**
1374
+ * Unreachable resources. Populated when the request attempts to list all resources across all supported locations, while some locations are temporarily unavailable.
1375
+ */
1376
+ unreachable?: string[] | null;
1377
+ }
1212
1378
  /**
1213
1379
  * Message for response to listing `AuthzExtension` resources.
1214
1380
  */
@@ -2006,6 +2172,10 @@ export declare namespace networkservices_v1beta1 {
2006
2172
  * Output only. Server-defined URL of this resource
2007
2173
  */
2008
2174
  selfLink?: string | null;
2175
+ /**
2176
+ * 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/`
2177
+ */
2178
+ targetProxies?: string[] | null;
2009
2179
  /**
2010
2180
  * Output only. The timestamp when the resource was updated.
2011
2181
  */
@@ -2248,6 +2418,7 @@ export declare namespace networkservices_v1beta1 {
2248
2418
  }
2249
2419
  export class Resource$Projects$Locations {
2250
2420
  context: APIRequestContext;
2421
+ agentGateways: Resource$Projects$Locations$Agentgateways;
2251
2422
  authzExtensions: Resource$Projects$Locations$Authzextensions;
2252
2423
  endpointPolicies: Resource$Projects$Locations$Endpointpolicies;
2253
2424
  gateways: Resource$Projects$Locations$Gateways;
@@ -2330,7 +2501,7 @@ export declare namespace networkservices_v1beta1 {
2330
2501
  get(params: Params$Resource$Projects$Locations$Get, callback: BodyResponseCallback<Schema$Location>): void;
2331
2502
  get(callback: BodyResponseCallback<Schema$Location>): void;
2332
2503
  /**
2333
- * Lists information about the supported locations for this service.
2504
+ * 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.
2334
2505
  * @example
2335
2506
  * ```js
2336
2507
  * // Before running the sample:
@@ -2360,7 +2531,7 @@ export declare namespace networkservices_v1beta1 {
2360
2531
  *
2361
2532
  * // Do the magic
2362
2533
  * const res = await networkservices.projects.locations.list({
2363
- * // Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.
2534
+ * // Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage.
2364
2535
  * extraLocationTypes: 'placeholder-value',
2365
2536
  * // 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).
2366
2537
  * filter: 'placeholder-value',
@@ -2407,7 +2578,7 @@ export declare namespace networkservices_v1beta1 {
2407
2578
  }
2408
2579
  export interface Params$Resource$Projects$Locations$List extends StandardParameters {
2409
2580
  /**
2410
- * Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.
2581
+ * Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage.
2411
2582
  */
2412
2583
  extraLocationTypes?: string[];
2413
2584
  /**
@@ -2427,6 +2598,447 @@ export declare namespace networkservices_v1beta1 {
2427
2598
  */
2428
2599
  pageToken?: string;
2429
2600
  }
2601
+ export class Resource$Projects$Locations$Agentgateways {
2602
+ context: APIRequestContext;
2603
+ constructor(context: APIRequestContext);
2604
+ /**
2605
+ * Creates a new AgentGateway in a given project and location.
2606
+ * @example
2607
+ * ```js
2608
+ * // Before running the sample:
2609
+ * // - Enable the API at:
2610
+ * // https://console.developers.google.com/apis/api/networkservices.googleapis.com
2611
+ * // - Login into gcloud by running:
2612
+ * // ```sh
2613
+ * // $ gcloud auth application-default login
2614
+ * // ```
2615
+ * // - Install the npm module by running:
2616
+ * // ```sh
2617
+ * // $ npm install googleapis
2618
+ * // ```
2619
+ *
2620
+ * const {google} = require('googleapis');
2621
+ * const networkservices = google.networkservices('v1beta1');
2622
+ *
2623
+ * async function main() {
2624
+ * const auth = new google.auth.GoogleAuth({
2625
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2626
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
2627
+ * });
2628
+ *
2629
+ * // Acquire an auth client, and bind it to all future calls
2630
+ * const authClient = await auth.getClient();
2631
+ * google.options({auth: authClient});
2632
+ *
2633
+ * // Do the magic
2634
+ * const res = await networkservices.projects.locations.agentGateways.create({
2635
+ * // Required. Short name of the AgentGateway resource to be created.
2636
+ * agentGatewayId: 'placeholder-value',
2637
+ * // Required. The parent resource of the AgentGateway. Must be in the format `projects/x/locations/x`.
2638
+ * parent: 'projects/my-project/locations/my-location',
2639
+ *
2640
+ * // Request body metadata
2641
+ * requestBody: {
2642
+ * // request body parameters
2643
+ * // {
2644
+ * // "agentGatewayCard": {},
2645
+ * // "createTime": "my_createTime",
2646
+ * // "description": "my_description",
2647
+ * // "etag": "my_etag",
2648
+ * // "googleManaged": {},
2649
+ * // "labels": {},
2650
+ * // "name": "my_name",
2651
+ * // "networkConfig": {},
2652
+ * // "protocols": [],
2653
+ * // "registries": [],
2654
+ * // "selfManaged": {},
2655
+ * // "updateTime": "my_updateTime"
2656
+ * // }
2657
+ * },
2658
+ * });
2659
+ * console.log(res.data);
2660
+ *
2661
+ * // Example response
2662
+ * // {
2663
+ * // "done": false,
2664
+ * // "error": {},
2665
+ * // "metadata": {},
2666
+ * // "name": "my_name",
2667
+ * // "response": {}
2668
+ * // }
2669
+ * }
2670
+ *
2671
+ * main().catch(e => {
2672
+ * console.error(e);
2673
+ * throw e;
2674
+ * });
2675
+ *
2676
+ * ```
2677
+ *
2678
+ * @param params - Parameters for request
2679
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
2680
+ * @param callback - Optional callback that handles the response.
2681
+ * @returns A promise if used with async/await, or void if used with a callback.
2682
+ */
2683
+ create(params: Params$Resource$Projects$Locations$Agentgateways$Create, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
2684
+ create(params?: Params$Resource$Projects$Locations$Agentgateways$Create, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
2685
+ create(params: Params$Resource$Projects$Locations$Agentgateways$Create, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
2686
+ create(params: Params$Resource$Projects$Locations$Agentgateways$Create, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
2687
+ create(params: Params$Resource$Projects$Locations$Agentgateways$Create, callback: BodyResponseCallback<Schema$Operation>): void;
2688
+ create(callback: BodyResponseCallback<Schema$Operation>): void;
2689
+ /**
2690
+ * Deletes a single AgentGateway.
2691
+ * @example
2692
+ * ```js
2693
+ * // Before running the sample:
2694
+ * // - Enable the API at:
2695
+ * // https://console.developers.google.com/apis/api/networkservices.googleapis.com
2696
+ * // - Login into gcloud by running:
2697
+ * // ```sh
2698
+ * // $ gcloud auth application-default login
2699
+ * // ```
2700
+ * // - Install the npm module by running:
2701
+ * // ```sh
2702
+ * // $ npm install googleapis
2703
+ * // ```
2704
+ *
2705
+ * const {google} = require('googleapis');
2706
+ * const networkservices = google.networkservices('v1beta1');
2707
+ *
2708
+ * async function main() {
2709
+ * const auth = new google.auth.GoogleAuth({
2710
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2711
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
2712
+ * });
2713
+ *
2714
+ * // Acquire an auth client, and bind it to all future calls
2715
+ * const authClient = await auth.getClient();
2716
+ * google.options({auth: authClient});
2717
+ *
2718
+ * // Do the magic
2719
+ * const res = await networkservices.projects.locations.agentGateways.delete({
2720
+ * // Optional. The etag of the AgentGateway to delete.
2721
+ * etag: 'placeholder-value',
2722
+ * // Required. A name of the AgentGateway to delete. Must be in the format `projects/x/locations/x/agentGateways/x`.
2723
+ * name: 'projects/my-project/locations/my-location/agentGateways/my-agentGateway',
2724
+ * });
2725
+ * console.log(res.data);
2726
+ *
2727
+ * // Example response
2728
+ * // {
2729
+ * // "done": false,
2730
+ * // "error": {},
2731
+ * // "metadata": {},
2732
+ * // "name": "my_name",
2733
+ * // "response": {}
2734
+ * // }
2735
+ * }
2736
+ *
2737
+ * main().catch(e => {
2738
+ * console.error(e);
2739
+ * throw e;
2740
+ * });
2741
+ *
2742
+ * ```
2743
+ *
2744
+ * @param params - Parameters for request
2745
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
2746
+ * @param callback - Optional callback that handles the response.
2747
+ * @returns A promise if used with async/await, or void if used with a callback.
2748
+ */
2749
+ delete(params: Params$Resource$Projects$Locations$Agentgateways$Delete, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
2750
+ delete(params?: Params$Resource$Projects$Locations$Agentgateways$Delete, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
2751
+ delete(params: Params$Resource$Projects$Locations$Agentgateways$Delete, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
2752
+ delete(params: Params$Resource$Projects$Locations$Agentgateways$Delete, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
2753
+ delete(params: Params$Resource$Projects$Locations$Agentgateways$Delete, callback: BodyResponseCallback<Schema$Operation>): void;
2754
+ delete(callback: BodyResponseCallback<Schema$Operation>): void;
2755
+ /**
2756
+ * Gets details of a single AgentGateway.
2757
+ * @example
2758
+ * ```js
2759
+ * // Before running the sample:
2760
+ * // - Enable the API at:
2761
+ * // https://console.developers.google.com/apis/api/networkservices.googleapis.com
2762
+ * // - Login into gcloud by running:
2763
+ * // ```sh
2764
+ * // $ gcloud auth application-default login
2765
+ * // ```
2766
+ * // - Install the npm module by running:
2767
+ * // ```sh
2768
+ * // $ npm install googleapis
2769
+ * // ```
2770
+ *
2771
+ * const {google} = require('googleapis');
2772
+ * const networkservices = google.networkservices('v1beta1');
2773
+ *
2774
+ * async function main() {
2775
+ * const auth = new google.auth.GoogleAuth({
2776
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2777
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
2778
+ * });
2779
+ *
2780
+ * // Acquire an auth client, and bind it to all future calls
2781
+ * const authClient = await auth.getClient();
2782
+ * google.options({auth: authClient});
2783
+ *
2784
+ * // Do the magic
2785
+ * const res = await networkservices.projects.locations.agentGateways.get({
2786
+ * // Required. A name of the AgentGateway to get. Must be in the format `projects/x/locations/x/agentGateways/x`.
2787
+ * name: 'projects/my-project/locations/my-location/agentGateways/my-agentGateway',
2788
+ * });
2789
+ * console.log(res.data);
2790
+ *
2791
+ * // Example response
2792
+ * // {
2793
+ * // "agentGatewayCard": {},
2794
+ * // "createTime": "my_createTime",
2795
+ * // "description": "my_description",
2796
+ * // "etag": "my_etag",
2797
+ * // "googleManaged": {},
2798
+ * // "labels": {},
2799
+ * // "name": "my_name",
2800
+ * // "networkConfig": {},
2801
+ * // "protocols": [],
2802
+ * // "registries": [],
2803
+ * // "selfManaged": {},
2804
+ * // "updateTime": "my_updateTime"
2805
+ * // }
2806
+ * }
2807
+ *
2808
+ * main().catch(e => {
2809
+ * console.error(e);
2810
+ * throw e;
2811
+ * });
2812
+ *
2813
+ * ```
2814
+ *
2815
+ * @param params - Parameters for request
2816
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
2817
+ * @param callback - Optional callback that handles the response.
2818
+ * @returns A promise if used with async/await, or void if used with a callback.
2819
+ */
2820
+ get(params: Params$Resource$Projects$Locations$Agentgateways$Get, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
2821
+ get(params?: Params$Resource$Projects$Locations$Agentgateways$Get, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$AgentGateway>>;
2822
+ get(params: Params$Resource$Projects$Locations$Agentgateways$Get, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
2823
+ get(params: Params$Resource$Projects$Locations$Agentgateways$Get, options: MethodOptions | BodyResponseCallback<Schema$AgentGateway>, callback: BodyResponseCallback<Schema$AgentGateway>): void;
2824
+ get(params: Params$Resource$Projects$Locations$Agentgateways$Get, callback: BodyResponseCallback<Schema$AgentGateway>): void;
2825
+ get(callback: BodyResponseCallback<Schema$AgentGateway>): void;
2826
+ /**
2827
+ * Lists AgentGateways in a given project and location.
2828
+ * @example
2829
+ * ```js
2830
+ * // Before running the sample:
2831
+ * // - Enable the API at:
2832
+ * // https://console.developers.google.com/apis/api/networkservices.googleapis.com
2833
+ * // - Login into gcloud by running:
2834
+ * // ```sh
2835
+ * // $ gcloud auth application-default login
2836
+ * // ```
2837
+ * // - Install the npm module by running:
2838
+ * // ```sh
2839
+ * // $ npm install googleapis
2840
+ * // ```
2841
+ *
2842
+ * const {google} = require('googleapis');
2843
+ * const networkservices = google.networkservices('v1beta1');
2844
+ *
2845
+ * async function main() {
2846
+ * const auth = new google.auth.GoogleAuth({
2847
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2848
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
2849
+ * });
2850
+ *
2851
+ * // Acquire an auth client, and bind it to all future calls
2852
+ * const authClient = await auth.getClient();
2853
+ * google.options({auth: authClient});
2854
+ *
2855
+ * // Do the magic
2856
+ * const res = await networkservices.projects.locations.agentGateways.list({
2857
+ * // Optional. Maximum number of AgentGateways to return per call.
2858
+ * pageSize: 'placeholder-value',
2859
+ * // 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.
2860
+ * pageToken: 'placeholder-value',
2861
+ * // Required. The project and location from which the AgentGateways should be listed, specified in the format `projects/x/locations/x`.
2862
+ * parent: 'projects/my-project/locations/my-location',
2863
+ * // 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.
2864
+ * returnPartialSuccess: 'placeholder-value',
2865
+ * });
2866
+ * console.log(res.data);
2867
+ *
2868
+ * // Example response
2869
+ * // {
2870
+ * // "agentGateways": [],
2871
+ * // "nextPageToken": "my_nextPageToken",
2872
+ * // "unreachable": []
2873
+ * // }
2874
+ * }
2875
+ *
2876
+ * main().catch(e => {
2877
+ * console.error(e);
2878
+ * throw e;
2879
+ * });
2880
+ *
2881
+ * ```
2882
+ *
2883
+ * @param params - Parameters for request
2884
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
2885
+ * @param callback - Optional callback that handles the response.
2886
+ * @returns A promise if used with async/await, or void if used with a callback.
2887
+ */
2888
+ list(params: Params$Resource$Projects$Locations$Agentgateways$List, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
2889
+ list(params?: Params$Resource$Projects$Locations$Agentgateways$List, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$ListAgentGatewaysResponse>>;
2890
+ list(params: Params$Resource$Projects$Locations$Agentgateways$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
2891
+ list(params: Params$Resource$Projects$Locations$Agentgateways$List, options: MethodOptions | BodyResponseCallback<Schema$ListAgentGatewaysResponse>, callback: BodyResponseCallback<Schema$ListAgentGatewaysResponse>): void;
2892
+ list(params: Params$Resource$Projects$Locations$Agentgateways$List, callback: BodyResponseCallback<Schema$ListAgentGatewaysResponse>): void;
2893
+ list(callback: BodyResponseCallback<Schema$ListAgentGatewaysResponse>): void;
2894
+ /**
2895
+ * Updates the parameters of a single AgentGateway.
2896
+ * @example
2897
+ * ```js
2898
+ * // Before running the sample:
2899
+ * // - Enable the API at:
2900
+ * // https://console.developers.google.com/apis/api/networkservices.googleapis.com
2901
+ * // - Login into gcloud by running:
2902
+ * // ```sh
2903
+ * // $ gcloud auth application-default login
2904
+ * // ```
2905
+ * // - Install the npm module by running:
2906
+ * // ```sh
2907
+ * // $ npm install googleapis
2908
+ * // ```
2909
+ *
2910
+ * const {google} = require('googleapis');
2911
+ * const networkservices = google.networkservices('v1beta1');
2912
+ *
2913
+ * async function main() {
2914
+ * const auth = new google.auth.GoogleAuth({
2915
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2916
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
2917
+ * });
2918
+ *
2919
+ * // Acquire an auth client, and bind it to all future calls
2920
+ * const authClient = await auth.getClient();
2921
+ * google.options({auth: authClient});
2922
+ *
2923
+ * // Do the magic
2924
+ * const res = await networkservices.projects.locations.agentGateways.patch({
2925
+ * // Identifier. Name of the AgentGateway resource. It matches pattern `projects/x/locations/x/agentGateways/`.
2926
+ * name: 'projects/my-project/locations/my-location/agentGateways/my-agentGateway',
2927
+ * // 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.
2928
+ * updateMask: 'placeholder-value',
2929
+ *
2930
+ * // Request body metadata
2931
+ * requestBody: {
2932
+ * // request body parameters
2933
+ * // {
2934
+ * // "agentGatewayCard": {},
2935
+ * // "createTime": "my_createTime",
2936
+ * // "description": "my_description",
2937
+ * // "etag": "my_etag",
2938
+ * // "googleManaged": {},
2939
+ * // "labels": {},
2940
+ * // "name": "my_name",
2941
+ * // "networkConfig": {},
2942
+ * // "protocols": [],
2943
+ * // "registries": [],
2944
+ * // "selfManaged": {},
2945
+ * // "updateTime": "my_updateTime"
2946
+ * // }
2947
+ * },
2948
+ * });
2949
+ * console.log(res.data);
2950
+ *
2951
+ * // Example response
2952
+ * // {
2953
+ * // "done": false,
2954
+ * // "error": {},
2955
+ * // "metadata": {},
2956
+ * // "name": "my_name",
2957
+ * // "response": {}
2958
+ * // }
2959
+ * }
2960
+ *
2961
+ * main().catch(e => {
2962
+ * console.error(e);
2963
+ * throw e;
2964
+ * });
2965
+ *
2966
+ * ```
2967
+ *
2968
+ * @param params - Parameters for request
2969
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
2970
+ * @param callback - Optional callback that handles the response.
2971
+ * @returns A promise if used with async/await, or void if used with a callback.
2972
+ */
2973
+ patch(params: Params$Resource$Projects$Locations$Agentgateways$Patch, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
2974
+ patch(params?: Params$Resource$Projects$Locations$Agentgateways$Patch, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
2975
+ patch(params: Params$Resource$Projects$Locations$Agentgateways$Patch, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
2976
+ patch(params: Params$Resource$Projects$Locations$Agentgateways$Patch, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
2977
+ patch(params: Params$Resource$Projects$Locations$Agentgateways$Patch, callback: BodyResponseCallback<Schema$Operation>): void;
2978
+ patch(callback: BodyResponseCallback<Schema$Operation>): void;
2979
+ }
2980
+ export interface Params$Resource$Projects$Locations$Agentgateways$Create extends StandardParameters {
2981
+ /**
2982
+ * Required. Short name of the AgentGateway resource to be created.
2983
+ */
2984
+ agentGatewayId?: string;
2985
+ /**
2986
+ * Required. The parent resource of the AgentGateway. Must be in the format `projects/x/locations/x`.
2987
+ */
2988
+ parent?: string;
2989
+ /**
2990
+ * Request body metadata
2991
+ */
2992
+ requestBody?: Schema$AgentGateway;
2993
+ }
2994
+ export interface Params$Resource$Projects$Locations$Agentgateways$Delete extends StandardParameters {
2995
+ /**
2996
+ * Optional. The etag of the AgentGateway to delete.
2997
+ */
2998
+ etag?: string;
2999
+ /**
3000
+ * Required. A name of the AgentGateway to delete. Must be in the format `projects/x/locations/x/agentGateways/x`.
3001
+ */
3002
+ name?: string;
3003
+ }
3004
+ export interface Params$Resource$Projects$Locations$Agentgateways$Get extends StandardParameters {
3005
+ /**
3006
+ * Required. A name of the AgentGateway to get. Must be in the format `projects/x/locations/x/agentGateways/x`.
3007
+ */
3008
+ name?: string;
3009
+ }
3010
+ export interface Params$Resource$Projects$Locations$Agentgateways$List extends StandardParameters {
3011
+ /**
3012
+ * Optional. Maximum number of AgentGateways to return per call.
3013
+ */
3014
+ pageSize?: number;
3015
+ /**
3016
+ * 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.
3017
+ */
3018
+ pageToken?: string;
3019
+ /**
3020
+ * Required. The project and location from which the AgentGateways should be listed, specified in the format `projects/x/locations/x`.
3021
+ */
3022
+ parent?: string;
3023
+ /**
3024
+ * 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.
3025
+ */
3026
+ returnPartialSuccess?: boolean;
3027
+ }
3028
+ export interface Params$Resource$Projects$Locations$Agentgateways$Patch extends StandardParameters {
3029
+ /**
3030
+ * Identifier. Name of the AgentGateway resource. It matches pattern `projects/x/locations/x/agentGateways/`.
3031
+ */
3032
+ name?: string;
3033
+ /**
3034
+ * 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.
3035
+ */
3036
+ updateMask?: string;
3037
+ /**
3038
+ * Request body metadata
3039
+ */
3040
+ requestBody?: Schema$AgentGateway;
3041
+ }
2430
3042
  export class Resource$Projects$Locations$Authzextensions {
2431
3043
  context: APIRequestContext;
2432
3044
  constructor(context: APIRequestContext);
@@ -2476,6 +3088,7 @@ export declare namespace networkservices_v1beta1 {
2476
3088
  * // "createTime": "my_createTime",
2477
3089
  * // "description": "my_description",
2478
3090
  * // "failOpen": false,
3091
+ * // "forwardAttributes": [],
2479
3092
  * // "forwardHeaders": [],
2480
3093
  * // "labels": {},
2481
3094
  * // "loadBalancingScheme": "my_loadBalancingScheme",
@@ -2626,6 +3239,7 @@ export declare namespace networkservices_v1beta1 {
2626
3239
  * // "createTime": "my_createTime",
2627
3240
  * // "description": "my_description",
2628
3241
  * // "failOpen": false,
3242
+ * // "forwardAttributes": [],
2629
3243
  * // "forwardHeaders": [],
2630
3244
  * // "labels": {},
2631
3245
  * // "loadBalancingScheme": "my_loadBalancingScheme",
@@ -2772,6 +3386,7 @@ export declare namespace networkservices_v1beta1 {
2772
3386
  * // "createTime": "my_createTime",
2773
3387
  * // "description": "my_description",
2774
3388
  * // "failOpen": false,
3389
+ * // "forwardAttributes": [],
2775
3390
  * // "forwardHeaders": [],
2776
3391
  * // "labels": {},
2777
3392
  * // "loadBalancingScheme": "my_loadBalancingScheme",
@@ -3369,6 +3984,8 @@ export declare namespace networkservices_v1beta1 {
3369
3984
  * // request body parameters
3370
3985
  * // {
3371
3986
  * // "addresses": [],
3987
+ * // "allPorts": false,
3988
+ * // "allowGlobalAccess": false,
3372
3989
  * // "certificateUrls": [],
3373
3990
  * // "createTime": "my_createTime",
3374
3991
  * // "description": "my_description",
@@ -3522,6 +4139,8 @@ export declare namespace networkservices_v1beta1 {
3522
4139
  * // Example response
3523
4140
  * // {
3524
4141
  * // "addresses": [],
4142
+ * // "allPorts": false,
4143
+ * // "allowGlobalAccess": false,
3525
4144
  * // "certificateUrls": [],
3526
4145
  * // "createTime": "my_createTime",
3527
4146
  * // "description": "my_description",
@@ -3667,6 +4286,8 @@ export declare namespace networkservices_v1beta1 {
3667
4286
  * // request body parameters
3668
4287
  * // {
3669
4288
  * // "addresses": [],
4289
+ * // "allPorts": false,
4290
+ * // "allowGlobalAccess": false,
3670
4291
  * // "certificateUrls": [],
3671
4292
  * // "createTime": "my_createTime",
3672
4293
  * // "description": "my_description",
@@ -4395,6 +5016,8 @@ export declare namespace networkservices_v1beta1 {
4395
5016
  * httpRouteId: 'placeholder-value',
4396
5017
  * // Required. The parent resource of the HttpRoute. Must be in the format `projects/x/locations/x`.
4397
5018
  * parent: 'projects/my-project/locations/my-location',
5019
+ * // Optional. Idempotent request UUID.
5020
+ * requestId: 'placeholder-value',
4398
5021
  *
4399
5022
  * // Request body metadata
4400
5023
  * requestBody: {
@@ -4607,6 +5230,8 @@ export declare namespace networkservices_v1beta1 {
4607
5230
  *
4608
5231
  * // Do the magic
4609
5232
  * const res = await networkservices.projects.locations.httpRoutes.list({
5233
+ * // Optional. Filter expression to restrict the list.
5234
+ * filter: 'placeholder-value',
4610
5235
  * // Maximum number of HttpRoutes to return per call.
4611
5236
  * pageSize: 'placeholder-value',
4612
5237
  * // 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.
@@ -4737,6 +5362,10 @@ export declare namespace networkservices_v1beta1 {
4737
5362
  * Required. The parent resource of the HttpRoute. Must be in the format `projects/x/locations/x`.
4738
5363
  */
4739
5364
  parent?: string;
5365
+ /**
5366
+ * Optional. Idempotent request UUID.
5367
+ */
5368
+ requestId?: string;
4740
5369
  /**
4741
5370
  * Request body metadata
4742
5371
  */
@@ -4755,6 +5384,10 @@ export declare namespace networkservices_v1beta1 {
4755
5384
  name?: string;
4756
5385
  }
4757
5386
  export interface Params$Resource$Projects$Locations$Httproutes$List extends StandardParameters {
5387
+ /**
5388
+ * Optional. Filter expression to restrict the list.
5389
+ */
5390
+ filter?: string;
4758
5391
  /**
4759
5392
  * Maximum number of HttpRoutes to return per call.
4760
5393
  */
@@ -8786,6 +9419,7 @@ export declare namespace networkservices_v1beta1 {
8786
9419
  * // "name": "my_name",
8787
9420
  * // "rules": [],
8788
9421
  * // "selfLink": "my_selfLink",
9422
+ * // "targetProxies": [],
8789
9423
  * // "updateTime": "my_updateTime"
8790
9424
  * // }
8791
9425
  * },
@@ -8930,6 +9564,7 @@ export declare namespace networkservices_v1beta1 {
8930
9564
  * // "name": "my_name",
8931
9565
  * // "rules": [],
8932
9566
  * // "selfLink": "my_selfLink",
9567
+ * // "targetProxies": [],
8933
9568
  * // "updateTime": "my_updateTime"
8934
9569
  * // }
8935
9570
  * }
@@ -9068,6 +9703,7 @@ export declare namespace networkservices_v1beta1 {
9068
9703
  * // "name": "my_name",
9069
9704
  * // "rules": [],
9070
9705
  * // "selfLink": "my_selfLink",
9706
+ * // "targetProxies": [],
9071
9707
  * // "updateTime": "my_updateTime"
9072
9708
  * // }
9073
9709
  * },