@maxim_mazurok/gapi.client.compute-alpha 0.0.20240129 → 0.0.20240218

package/index.d.ts

@@ -9,7 +9,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://www.googleapis.com/discovery/v1/apis/compute/alpha/rest
-// Revision: 20240129
+// Revision: 20240218
 
 /// <reference types="gapi.client" />
 
@@ -421,7 +421,7 @@ declare namespace gapi.client {
       onUpdateAction?: string;
       /** Indicates how many IOPS to provision for the disk. This sets the number of I/O operations per second that the disk can handle. Values must be between 10,000 and 120,000. For more details, see the Extreme persistent disk documentation. */
       provisionedIops?: string;
-      /** Indicates how much throughput to provision for the disk. This sets the number of throughput mb per second that the disk can handle. Values must be between 1 and 7,124. */
+      /** Indicates how much throughput to provision for the disk. This sets the number of throughput mb per second that the disk can handle. Values must greater than or equal to 1. */
       provisionedThroughput?: string;
       /** Required for each regional disk associated with the instance. Specify the URLs of the zones where the disk should be replicated to. You must provide exactly two replica zones, and one zone must be the same as the instance zone. */
       replicaZones?: string[];
@@ -1612,7 +1612,7 @@ declare namespace gapi.client {
       physicalBlockSizeBytes?: string;
       /** Indicates how many IOPS to provision for the disk. This sets the number of I/O operations per second that the disk can handle. Values must be between 10,000 and 120,000. For more details, see the Extreme persistent disk documentation. */
       provisionedIops?: string;
-      /** Indicates how much throughput to provision for the disk. This sets the number of throughput mb per second that the disk can handle. Values must be between 1 and 7,124. */
+      /** Indicates how much throughput to provision for the disk. This sets the number of throughput mb per second that the disk can handle. Values must be greater than or equal to 1. */
       provisionedThroughput?: string;
       /** [Output Only] URL of the region where the disk resides. Only applicable for regional resources. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. */
       region?: string;
@@ -1777,11 +1777,23 @@ declare namespace gapi.client {
       resourcePolicies?: string[];
     }
     interface DiskSettings {
+      /** Policy of which locations are allowed to create regional snapshots. */
+      accessLocation?: DiskSettingsAccessLocation;
       /** An optional parameter for storing the default resource policies that will be used for the Disks created in the given scope. The Key is a string type, provided by customers to uniquely identify the default Resource Policy entry. The Value is a Default ResourcePolicyDetails Object used to represent the detailed information of the Resource Policy entry. */
       defaultResourcePolicies?: {
         [P in string]: DiskSettingsResourcePolicyDetails;
       };
     }
+    interface DiskSettingsAccessLocation {
+      /** List of regions that can create a regional snapshot from the current region */
+      locations?: {
+        [P in string]: DiskSettingsAccessLocationAccessLocationPreference;
+      };
+    }
+    interface DiskSettingsAccessLocationAccessLocationPreference {
+      /** Accessible region name */
+      region?: string;
+    }
     interface DiskSettingsResourcePolicyDetails {
       /** [Output Only] A list of Disk Types that will be excluded from applying the Resource Policy referenced here. If absent, Disks created in any DiskType can use the referenced default Resource Policy. */
       excludedDiskTypes?: string[];
@@ -2486,6 +2498,8 @@ declare namespace gapi.client {
       selfLinkWithId?: string;
       /** List of Projects/Folders to share with. */
       shareSettings?: ShareSettings;
+      /** Indicates whether the auto-created reservation can be consumed by VMs with affinity for "any" reservation. If the field is set, then only VMs that target the reservation by name can consume from the delivered reservation. If set to true,the delivered resevervation will have the same name as the future reservation. */
+      specificReservationRequired?: boolean;
       /** Future Reservation configuration to indicate instance properties and total count. */
       specificSkuProperties?: FutureReservationSpecificSKUProperties;
       /** [Output only] Status of the Future Reservation */
@@ -3824,6 +3838,8 @@ declare namespace gapi.client {
       instanceSelections?: {
         [P in string]: InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection;
       };
+      /** Provisioning model configuration used by this managed instance group to create instances. */
+      provisioningModelMix?: InstanceGroupManagerInstanceFlexibilityPolicyProvisioningModelMix;
     }
     interface InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection {
       /** Full machine-type names, e.g. "n1-standard-16". */
@@ -3831,6 +3847,12 @@ declare namespace gapi.client {
       /** Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference. */
       rank?: number;
     }
+    interface InstanceGroupManagerInstanceFlexibilityPolicyProvisioningModelMix {
+      /** The base capacity that will always use Standard VMs to avoid risk of more preemption than the minimum capacity user needs. MIG will create only Standard VMs until it reaches standard_capacity_base and only then will start using standard_capacity_percent_above_base to mix Spot with Standard VMs. */
+      standardCapacityBase?: number;
+      /** The percentage of target capacity that should use Standard VM. The remaining percentage will use Spot VMs. The percentage applies only to the capacity above standard_capacity_base. */
+      standardCapacityPercentAboveBase?: number;
+    }
     interface InstanceGroupManagerInstanceLifecyclePolicy {
       /** The action that a MIG performs on a failed or an unhealthy VM. A VM is marked as unhealthy when the application running on that VM fails a health check. Valid values are - REPAIR (default): MIG automatically repairs a failed or an unhealthy VM by recreating it. For more information, see About repairing VMs in a MIG. - DO_NOTHING: MIG does not repair a failed or an unhealthy VM. */
       defaultActionOnFailure?: string;
@@ -5776,6 +5798,8 @@ declare namespace gapi.client {
     interface ManagedInstancePropertiesFromFlexibilityPolicy {
       /** The machine type to be used for this instance. */
       machineType?: string;
+      /** The provisioning model to be used for this instance. */
+      provisioningModel?: string;
     }
     interface ManagedInstanceVersion {
       /** [Output Only] The intended template of the instance. This field is empty when current_action is one of { DELETING, ABANDONING }. */
@@ -6105,17 +6129,17 @@ declare namespace gapi.client {
     interface NetworkEndpointGroup {
       /** Metadata defined as annotations on the network endpoint group. */
       annotations?: {[P in string]: string};
-      /** Only valid when networkEndpointType is "SERVERLESS". Only one of cloudRun, appEngine or cloudFunction may be set. */
+      /** Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set. */
       appEngine?: NetworkEndpointGroupAppEngine;
-      /** Only valid when networkEndpointType is "GCE_VM_IP_PORT" and the NEG is regional. */
+      /** Only valid when networkEndpointType is GCE_VM_IP_PORT and the NEG is regional. */
       clientPortMappingMode?: string;
-      /** Only valid when networkEndpointType is "SERVERLESS". Only one of cloudRun, appEngine or cloudFunction may be set. */
+      /** Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set. */
       cloudFunction?: NetworkEndpointGroupCloudFunction;
-      /** Only valid when networkEndpointType is "SERVERLESS". Only one of cloudRun, appEngine or cloudFunction may be set. */
+      /** Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set. */
       cloudRun?: NetworkEndpointGroupCloudRun;
       /** [Output Only] Creation timestamp in RFC3339 text format. */
       creationTimestamp?: string;
-      /** The default port used if the port number is not specified in the network endpoint. */
+      /** The default port used if the port number is not specified in the network endpoint. If the network endpoint type is either GCE_VM_IP, SERVERLESS or PRIVATE_SERVICE_CONNECT, this field must not be specified. */
       defaultPort?: number;
       /** An optional description of this resource. Provide this property when you create the resource. */
       description?: string;
@@ -6127,12 +6151,12 @@ declare namespace gapi.client {
       loadBalancer?: NetworkEndpointGroupLbNetworkEndpointGroup;
       /** Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. */
       name?: string;
-      /** The URL of the network to which all network endpoints in the NEG belong. Uses "default" project network if unspecified. */
+      /** The URL of the network to which all network endpoints in the NEG belong. Uses default project network if unspecified. */
       network?: string;
       /** Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT. */
       networkEndpointType?: string;
       pscData?: NetworkEndpointGroupPscData;
-      /** The target service url used to set up private service connection to a Google API or a PSC Producer Service Attachment. An example value is: "asia-northeast3-cloudkms.googleapis.com" */
+      /** The target service url used to set up private service connection to a Google API or a PSC Producer Service Attachment. An example value is: asia-northeast3-cloudkms.googleapis.com */
       pscTargetService?: string;
       /** [Output Only] The URL of the region where the network endpoint group is located. */
       region?: string;
@@ -6140,7 +6164,7 @@ declare namespace gapi.client {
       selfLink?: string;
       /** [Output Only] Server-defined URL for this resource with the resource id. */
       selfLinkWithId?: string;
-      /** Only valid when networkEndpointType is "SERVERLESS". Only one of cloudRun, appEngine, cloudFunction or serverlessDeployment may be set. */
+      /** Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine, cloudFunction or serverlessDeployment may be set. */
       serverlessDeployment?: NetworkEndpointGroupServerlessDeployment;
       /** [Output only] Number of network endpoints in the network endpoint group. */
       size?: number;
@@ -6180,17 +6204,17 @@ declare namespace gapi.client {
       };
     }
     interface NetworkEndpointGroupAppEngine {
-      /** Optional serving service. The service name is case-sensitive and must be 1-63 characters long. Example value: "default", "my-service". */
+      /** Optional serving service. The service name is case-sensitive and must be 1-63 characters long. Example value: default, my-service. */
       service?: string;
-      /** A template to parse service and version fields from a request URL. URL mask allows for routing to multiple App Engine services without having to create multiple Network Endpoint Groups and backend services. For example, the request URLs "foo1-dot-appname.appspot.com/v1" and "foo1-dot-appname.appspot.com/v2" can be backed by the same Serverless NEG with URL mask "<service>-dot-appname.appspot.com/<version>". The URL mask will parse them to { service = "foo1", version = "v1" } and { service = "foo1", version = "v2" } respectively. */
+      /** An URL mask is one of the main components of the Cloud Function. A template to parse service and version fields from a request URL. URL mask allows for routing to multiple App Engine services without having to create multiple Network Endpoint Groups and backend services. For example, the request URLs foo1-dot-appname.appspot.com/v1 and foo1-dot-appname.appspot.com/v2 can be backed by the same Serverless NEG with URL mask <service>-dot-appname.appspot.com/<version>. The URL mask will parse them to { service = "foo1", version = "v1" } and { service = "foo1", version = "v2" } respectively. */
       urlMask?: string;
-      /** Optional serving version. The version name is case-sensitive and must be 1-100 characters long. Example value: "v1", "v2". */
+      /** Optional serving version. The version name is case-sensitive and must be 1-100 characters long. Example value: v1, v2. */
       version?: string;
     }
     interface NetworkEndpointGroupCloudFunction {
-      /** A user-defined name of the Cloud Function. The function name is case-sensitive and must be 1-63 characters long. Example value: "func1". */
+      /** A user-defined name of the Cloud Function. The function name is case-sensitive and must be 1-63 characters long. Example value: func1. */
       function?: string;
-      /** A template to parse function field from a request URL. URL mask allows for routing to multiple Cloud Functions without having to create multiple Network Endpoint Groups and backend services. For example, request URLs " mydomain.com/function1" and "mydomain.com/function2" can be backed by the same Serverless NEG with URL mask "/<function>". The URL mask will parse them to { function = "function1" } and { function = "function2" } respectively. */
+      /** An URL mask is one of the main components of the Cloud Function. A template to parse function field from a request URL. URL mask allows for routing to multiple Cloud Functions without having to create multiple Network Endpoint Groups and backend services. For example, request URLs mydomain.com/function1 and mydomain.com/function2 can be backed by the same Serverless NEG with URL mask /<function>. The URL mask will parse them to { function = "function1" } and { function = "function2" } respectively. */
       urlMask?: string;
     }
     interface NetworkEndpointGroupCloudRun {
@@ -6198,13 +6222,13 @@ declare namespace gapi.client {
       service?: string;
       /** Optional Cloud Run tag represents the "named-revision" to provide additional fine-grained traffic routing information. The tag must be 1-63 characters long, and comply with RFC1035. Example value: "revision-0010". */
       tag?: string;
-      /** A template to parse <service> and <tag> fields from a request URL. URL mask allows for routing to multiple Run services without having to create multiple network endpoint groups and backend services. For example, request URLs "foo1.domain.com/bar1" and "foo1.domain.com/bar2" can be backed by the same Serverless Network Endpoint Group (NEG) with URL mask "<tag>.domain.com/<service>". The URL mask will parse them to { service="bar1", tag="foo1" } and { service="bar2", tag="foo2" } respectively. */
+      /** An URL mask is one of the main components of the Cloud Function. A template to parse <service> and <tag> fields from a request URL. URL mask allows for routing to multiple Run services without having to create multiple network endpoint groups and backend services. For example, request URLs foo1.domain.com/bar1 and foo1.domain.com/bar2 can be backed by the same Serverless Network Endpoint Group (NEG) with URL mask <tag>.domain.com/<service>. The URL mask will parse them to { service="bar1", tag="foo1" } and { service="bar2", tag="foo2" } respectively. */
       urlMask?: string;
     }
     interface NetworkEndpointGroupLbNetworkEndpointGroup {
-      /** The default port used if the port number is not specified in the network endpoint. [Deprecated] This field is deprecated. */
+      /** The default port used if the port number is not specified in the network endpoint. If the network endpoint type is either GCE_VM_IP, SERVERLESS or PRIVATE_SERVICE_CONNECT, this field must not be specified. [Deprecated] This field is deprecated. */
       defaultPort?: number;
-      /** The URL of the network to which all network endpoints in the NEG belong. Uses "default" project network if unspecified. [Deprecated] This field is deprecated. */
+      /** The URL of the network to which all network endpoints in the NEG belong. Uses default project network if unspecified. [Deprecated] This field is deprecated. */
       network?: string;
       /** Optional URL of the subnetwork to which all network endpoints in the NEG belong. [Deprecated] This field is deprecated. */
       subnetwork?: string;
@@ -6258,7 +6282,7 @@ declare namespace gapi.client {
       platform?: string;
       /** The user-defined name of the workload/instance. This value must be provided explicitly or in the urlMask. The resource identified by this value is platform-specific and is as follows: 1. API Gateway: The gateway ID 2. App Engine: The service name 3. Cloud Functions: The function name 4. Cloud Run: The service name */
       resource?: string;
-      /** A template to parse platform-specific fields from a request URL. URL mask allows for routing to multiple resources on the same serverless platform without having to create multiple Network Endpoint Groups and backend resources. The fields parsed by this template are platform-specific and are as follows: 1. API Gateway: The gateway ID 2. App Engine: The service and version 3. Cloud Functions: The function name 4. Cloud Run: The service and tag */
+      /** An URL mask is one of the main components of the Cloud Function. A template to parse platform-specific fields from a request URL. URL mask allows for routing to multiple resources on the same serverless platform without having to create multiple Network Endpoint Groups and backend resources. The fields parsed by this template are platform-specific and are as follows: 1. API Gateway: The gateway ID 2. App Engine: The service and version 3. Cloud Functions: The function name 4. Cloud Run: The service and tag */
       urlMask?: string;
       /** The optional resource version. The version identified by this value is platform-specific and is follows: 1. API Gateway: Unused 2. App Engine: The service version 3. Cloud Functions: Unused 4. Cloud Run: The service tag */
       version?: string;
@@ -6327,6 +6351,8 @@ declare namespace gapi.client {
       aliasIpRanges?: AliasIpRange[];
       /** Fingerprint hash of contents stored in this network interface. This field will be ignored when inserting an Instance or adding a NetworkInterface. An up-to-date fingerprint must be provided in order to update the NetworkInterface. The request will fail with error 400 Bad Request if the fingerprint is not provided, or 412 Precondition Failed if the fingerprint is out of date. */
       fingerprint?: string;
+      /** Indicate whether igmp query is enabled on the network interface or not. If enabled, also indicates the version of IGMP supported. */
+      igmpQuery?: string;
       /** The prefix length of the primary internal IPv6 range. */
       internalIpv6PrefixLength?: number;
       /** An array of IPv6 access configurations for this interface. Currently, only one IPv6 access config, DIRECT_IPV6, is supported. If there is no ipv6AccessConfig specified, then this instance will have no external IPv6 Internet access. */
@@ -7489,6 +7515,8 @@ declare namespace gapi.client {
       users?: string[];
     }
     interface Project {
+      /** [Output Only] The Cloud Armor tier for this project. It can be one of the following values: CA_STANDARD, CA_ENTERPRISE_PAYGO. If this field is not specified, it is assumed to be CA_STANDARD. */
+      cloudArmorTier?: string;
       /** Metadata key/value pairs available to all instances contained in this project. See Custom metadata for more information. */
       commonInstanceMetadata?: Metadata;
       /** [Output Only] Creation timestamp in RFC3339 text format. */
@@ -7542,6 +7570,10 @@ declare namespace gapi.client {
       /** Opt-in for partial page behavior which provides a partial filled page (number of items on which may be smaller than maxResults) within the API deadline. If opt-in, then the user should rely on if nextPageToken is empty in the response to determine if there is a next page. Empty page is also valid and possible. The default value is false. */
       returnPartialPage?: boolean;
     }
+    interface ProjectsSetCloudArmorTierRequest {
+      /** Managed protection tier to be set. */
+      cloudArmorTier?: string;
+    }
     interface ProjectsSetDefaultNetworkTierRequest {
       /** Default network tier to be set. */
       networkTier?: string;
@@ -9426,6 +9458,7 @@ declare namespace gapi.client {
       nodeAffinities?: SchedulingNodeAffinity[];
       /** Defines the maintenance behavior for this instance. For standard instances, the default behavior is MIGRATE. For preemptible instances, the default and only possible behavior is TERMINATE. For more information, see Set VM host maintenance policy. */
       onHostMaintenance?: string;
+      onInstanceStopAction?: SchedulingOnInstanceStopAction;
       /** Defines whether the instance is preemptible. This can only be set during instance creation or while the instance is stopped and therefore, in a `TERMINATED` state. See Instance Life Cycle for more information on the possible instance states. */
       preemptible?: boolean;
       /** Specifies the provisioning model of the instance. */
@@ -9447,6 +9480,10 @@ declare namespace gapi.client {
       /** Corresponds to the label values of Node resource. */
       values?: string[];
     }
+    interface SchedulingOnInstanceStopAction {
+      /** If true, the contents of any attached Local SSD disks will be discarded else, the Local SSD data will be preserved when the instance is stopped at the end of the run duration/termination time. */
+      discardLocalSsd?: boolean;
+    }
     interface Screenshot {
       /** [Output Only] The Base64-encoded screenshot data. */
       contents?: string;
@@ -10183,6 +10220,8 @@ declare namespace gapi.client {
       name?: string;
       /** [Output Only] URL of the region where the snapshot resides. Only applicable for regional snapshots. */
       region?: string;
+      /** [Output only] ResourceStatus of the Snapshot resource */
+      resourceStatus?: SnapshotResourceStatus;
       /** Output only. Reserved for future use. */
       satisfiesPzi?: boolean;
       /** [Output Only] Reserved for future use. */
@@ -10279,6 +10318,10 @@ declare namespace gapi.client {
         message?: string;
       };
     }
+    interface SnapshotResourceStatus {
+      /** [Output only] Scheduled deletion time of the snapshot. The snapshot will be deleted by the at any point within one hour after the deletion time. */
+      scheduledDeletionTime?: string;
+    }
     interface SnapshotSettings {
       /** (Regional snapshots use only)Policy of which location is allowed to access snapshot. */
       accessLocation?: SnapshotSettingsAccessLocation;
@@ -12689,7 +12732,7 @@ declare namespace gapi.client {
       policy?: Policy;
     }
     interface AcceleratorTypesResource {
-      /** Retrieves an aggregated list of accelerator types. */
+      /** Retrieves an aggregated list of accelerator types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -12721,7 +12764,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -12795,7 +12838,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -12808,7 +12851,7 @@ declare namespace gapi.client {
       }): Request<AcceleratorTypeList>;
     }
     interface AddressesResource {
-      /** Retrieves an aggregated list of addresses. */
+      /** Retrieves an aggregated list of addresses. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -12840,7 +12883,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -13021,7 +13064,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -13180,7 +13223,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface AutoscalersResource {
-      /** Retrieves an aggregated list of autoscalers. */
+      /** Retrieves an aggregated list of autoscalers. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -13212,7 +13255,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -13391,7 +13434,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -13886,7 +13929,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -14245,7 +14288,7 @@ declare namespace gapi.client {
         },
         body: SignedUrlKey
       ): Request<Operation>;
-      /** Retrieves the list of all BackendService resources, regional and global, available to the specified project. */
+      /** Retrieves the list of all BackendService resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -14277,7 +14320,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -14580,7 +14623,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -14619,7 +14662,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -15052,7 +15095,7 @@ declare namespace gapi.client {
         },
         body: DisksAddResourcePoliciesRequest
       ): Request<Operation>;
-      /** Retrieves an aggregated list of persistent disks. */
+      /** Retrieves an aggregated list of persistent disks. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -15084,7 +15127,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -15450,7 +15493,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -16087,7 +16130,7 @@ declare namespace gapi.client {
       ): Request<Operation>;
     }
     interface DiskTypesResource {
-      /** Retrieves an aggregated list of disk types. */
+      /** Retrieves an aggregated list of disk types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -16119,7 +16162,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -16193,7 +16236,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -16366,7 +16409,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -16863,7 +16906,7 @@ declare namespace gapi.client {
         prettyPrint?: boolean;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -17362,7 +17405,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -17547,7 +17590,7 @@ declare namespace gapi.client {
       ): Request<Operation>;
     }
     interface ForwardingRulesResource {
-      /** Retrieves an aggregated list of forwarding rules. */
+      /** Retrieves an aggregated list of forwarding rules. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -17579,7 +17622,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -17760,7 +17803,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -17993,7 +18036,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface FutureReservationsResource {
-      /** Retrieves an aggregated list of future reservations. */
+      /** Retrieves an aggregated list of future reservations. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -18025,7 +18068,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -18239,7 +18282,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -18523,7 +18566,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -18832,7 +18875,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -19351,7 +19394,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -19392,7 +19435,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -19403,7 +19446,7 @@ declare namespace gapi.client {
       }): Request<NetworkEndpointGroupsListNetworkEndpoints>;
     }
     interface GlobalOperationsResource {
-      /** Retrieves an aggregated list of all operations. */
+      /** Retrieves an aggregated list of all operations. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -19435,7 +19478,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -19538,7 +19581,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -19672,7 +19715,7 @@ declare namespace gapi.client {
         prettyPrint?: boolean;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -19843,7 +19886,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -19924,7 +19967,7 @@ declare namespace gapi.client {
       ): Request<Operation>;
     }
     interface HealthChecksResource {
-      /** Retrieves the list of all HealthCheck resources, regional and global, available to the specified project. */
+      /** Retrieves the list of all HealthCheck resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -19956,7 +19999,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -20127,7 +20170,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -20472,7 +20515,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -20817,7 +20860,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -21335,7 +21378,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -21735,7 +21778,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -21822,7 +21865,7 @@ declare namespace gapi.client {
         },
         body: InstanceGroupManagersAbandonInstancesRequest
       ): Request<Operation>;
-      /** Retrieves the list of managed instance groups and groups them by zone. */
+      /** Retrieves the list of managed instance groups and groups them by zone. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -21854,7 +21897,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -22321,7 +22364,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -22364,7 +22407,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -22407,7 +22450,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -22450,7 +22493,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -23572,7 +23615,7 @@ declare namespace gapi.client {
         },
         body: InstanceGroupsAddInstancesRequest
       ): Request<Operation>;
-      /** Retrieves the list of instance groups and sorts them by zone. */
+      /** Retrieves the list of instance groups and sorts them by zone. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -23604,7 +23647,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -23783,7 +23826,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -23826,7 +23869,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -23871,7 +23914,7 @@ declare namespace gapi.client {
           project: string;
           /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
           quotaUser?: string;
-          /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+          /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
           returnPartialSuccess?: boolean;
           /** Upload protocol for media (e.g. "raw", "multipart"). */
           upload_protocol?: string;
@@ -24296,7 +24339,7 @@ declare namespace gapi.client {
         },
         body: InstancesAddResourcePoliciesRequest
       ): Request<Operation>;
-      /** Retrieves an aggregated list of all of the instances in your project across all regions and zones. The performance of this method degrades when a filter is specified on a project that has a very large number of instances. */
+      /** Retrieves an aggregated list of all of the instances in your project across all regions and zones. The performance of this method degrades when a filter is specified on a project that has a very large number of instances. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -24328,7 +24371,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -25058,7 +25101,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -25103,7 +25146,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -27270,7 +27313,7 @@ declare namespace gapi.client {
       ): Request<Operation>;
     }
     interface InstanceTemplatesResource {
-      /** Retrieves the list of all InstanceTemplates resources, regional and global, available to the specified project. */
+      /** Retrieves the list of all InstanceTemplates resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -27302,7 +27345,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -27508,7 +27551,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -27589,7 +27632,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface InstantSnapshotsResource {
-      /** Retrieves an aggregated list of instantSnapshots. */
+      /** Retrieves an aggregated list of instantSnapshots. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -27621,7 +27664,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -27835,7 +27878,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -27958,7 +28001,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface InterconnectAttachmentsResource {
-      /** Retrieves an aggregated list of interconnect attachments. */
+      /** Retrieves an aggregated list of interconnect attachments. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -27990,7 +28033,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -28210,7 +28253,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -28466,7 +28509,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -28572,7 +28615,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -28872,7 +28915,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -29382,7 +29425,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -29658,7 +29701,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -29737,7 +29780,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface MachineTypesResource {
-      /** Retrieves an aggregated list of machine types. */
+      /** Retrieves an aggregated list of machine types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -29769,7 +29812,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -29843,7 +29886,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -29856,7 +29899,7 @@ declare namespace gapi.client {
       }): Request<MachineTypeList>;
     }
     interface NetworkAttachmentsResource {
-      /** Retrieves the list of all NetworkAttachment resources, regional and global, available to the specified project. */
+      /** Retrieves the list of all NetworkAttachment resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -29888,7 +29931,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -30104,7 +30147,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region of this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -30261,7 +30304,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface NetworkEdgeSecurityServicesResource {
-      /** Retrieves the list of all NetworkEdgeSecurityService resources available to the specified project. */
+      /** Retrieves the list of all NetworkEdgeSecurityService resources available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -30293,7 +30336,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -30528,7 +30571,7 @@ declare namespace gapi.client {
       ): Request<Operation>;
     }
     interface NetworkEndpointGroupsResource {
-      /** Retrieves the list of network endpoint groups and sorts them by zone. */
+      /** Retrieves the list of network endpoint groups and sorts them by zone. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -30560,7 +30603,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -30887,7 +30930,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -30930,7 +30973,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -30975,7 +31018,7 @@ declare namespace gapi.client {
           project: string;
           /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
           quotaUser?: string;
-          /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+          /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
           returnPartialSuccess?: boolean;
           /** Upload protocol for media (e.g. "raw", "multipart"). */
           upload_protocol?: string;
@@ -31476,7 +31519,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -32100,7 +32143,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -32141,7 +32184,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** (Optional) types filter separate by comma, valid values are: SUBNETWORK, RESERVED, PEER_USED, PEER_RESERVED, REMOTE_USED, REMOTE_RESERVED. */
         types?: string;
@@ -32190,7 +32233,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** (Optional) Subnetwork name filter. */
         subnetName?: string;
@@ -32241,7 +32284,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** The region of the request. The response will include all subnet routes, static routes and dynamic routes in the region. */
         region?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -32603,7 +32646,7 @@ declare namespace gapi.client {
         },
         body: NodeGroupsAddNodesRequest
       ): Request<Operation>;
-      /** Retrieves an aggregated list of node groups. Note: use nodeGroups.listNodes for more details about each group. */
+      /** Retrieves an aggregated list of node groups. Note: use nodeGroups.listNodes for more details about each group. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -32635,7 +32678,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -32927,7 +32970,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -32970,7 +33013,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -33351,7 +33394,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface NodeTemplatesResource {
-      /** Retrieves an aggregated list of node templates. */
+      /** Retrieves an aggregated list of node templates. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -33383,7 +33426,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -33599,7 +33642,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** The name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -33682,7 +33725,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface NodeTypesResource {
-      /** Retrieves an aggregated list of node types. */
+      /** Retrieves an aggregated list of node types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -33714,7 +33757,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -33788,7 +33831,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -34188,7 +34231,7 @@ declare namespace gapi.client {
         prettyPrint?: boolean;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -34463,7 +34506,7 @@ declare namespace gapi.client {
       }): Request<Operation>;
     }
     interface PacketMirroringsResource {
-      /** Retrieves an aggregated list of packetMirrorings. */
+      /** Retrieves an aggregated list of packetMirrorings. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -34495,7 +34538,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -34676,7 +34719,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -35079,7 +35122,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -35118,7 +35161,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -35159,7 +35202,7 @@ declare namespace gapi.client {
           project: string;
           /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
           quotaUser?: string;
-          /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+          /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
           returnPartialSuccess?: boolean;
           /** Upload protocol for media (e.g. "raw", "multipart"). */
           upload_protocol?: string;
@@ -35302,6 +35345,72 @@ declare namespace gapi.client {
         },
         body: InstanceMoveRequest
       ): Request<Operation>;
+      /** Sets the Cloud Armor tier of the project. To set ENTERPRISE or above the billing account of the project must be subscribed to Cloud Armor Enterprise. See Subscribing to Cloud Armor Enterprise for more information. */
+      setCloudArmorTier(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Project ID for this request. */
+        project: string;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). */
+        requestId?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Legacy name for parameter that has been superseded by `quotaUser`. */
+        userIp?: string;
+        /** Request body */
+        resource: ProjectsSetCloudArmorTierRequest;
+      }): Request<Operation>;
+      setCloudArmorTier(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Project ID for this request. */
+          project: string;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). */
+          requestId?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+          /** Legacy name for parameter that has been superseded by `quotaUser`. */
+          userIp?: string;
+        },
+        body: ProjectsSetCloudArmorTierRequest
+      ): Request<Operation>;
       /** Sets metadata common to all instances within the specified project using the data included in the request. */
       setCommonInstanceMetadata(request: {
         /** V1 error format. */
@@ -35827,7 +35936,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -35941,7 +36050,7 @@ declare namespace gapi.client {
       }): Request<Operation>;
     }
     interface PublicDelegatedPrefixesResource {
-      /** Lists all PublicDelegatedPrefix resources owned by the specific project across all scopes. */
+      /** Lists all PublicDelegatedPrefix resources owned by the specific project across all scopes. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -35973,7 +36082,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -36189,7 +36298,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region of this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -36479,7 +36588,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -36947,7 +37056,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -36988,7 +37097,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. It must be a string that meets the requirements in RFC1035. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -37293,7 +37402,7 @@ declare namespace gapi.client {
       ): Request<Operation>;
     }
     interface RegionCommitmentsResource {
-      /** Retrieves an aggregated list of commitments by region. */
+      /** Retrieves an aggregated list of commitments by region. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -37325,7 +37434,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -37541,7 +37650,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -38173,7 +38282,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -38873,7 +38982,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** The name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -39054,7 +39163,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -39249,7 +39358,7 @@ declare namespace gapi.client {
       ): Request<Operation>;
     }
     interface RegionHealthCheckServicesResource {
-      /** Retrieves the list of all HealthCheckService resources, regional and global, available to the specified project. */
+      /** Retrieves the list of all HealthCheckService resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -39281,7 +39390,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -39462,7 +39571,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -40115,7 +40224,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -40158,7 +40267,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. This should conform to RFC1035. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -40201,7 +40310,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -40244,7 +40353,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request, should conform to RFC1035. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -41355,7 +41464,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -41398,7 +41507,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -41443,7 +41552,7 @@ declare namespace gapi.client {
           quotaUser?: string;
           /** Name of the region scoping this request. */
           region: string;
-          /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+          /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
           returnPartialSuccess?: boolean;
           /** Upload protocol for media (e.g. "raw", "multipart"). */
           upload_protocol?: string;
@@ -41810,7 +41919,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** The name of the regions for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -42028,7 +42137,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** The name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -42467,7 +42576,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** The name of the region where the network endpoint group is located. It should comply with RFC1035. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -42510,7 +42619,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** The name of the region where the network endpoint group is located. It should comply with RFC1035. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -43030,7 +43139,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -43445,7 +43554,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -43626,7 +43735,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -43771,7 +43880,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -43876,7 +43985,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -44170,7 +44279,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -44583,7 +44692,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -44981,7 +45090,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -45198,7 +45307,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -45239,7 +45348,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -45530,7 +45639,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -45821,7 +45930,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -46260,7 +46369,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -46551,7 +46660,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -46848,7 +46957,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -46859,7 +46968,7 @@ declare namespace gapi.client {
       }): Request<ZoneList>;
     }
     interface ReservationsResource {
-      /** Retrieves an aggregated list of reservations. */
+      /** Retrieves an aggregated list of reservations. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -46891,7 +47000,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -47105,7 +47214,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -47344,7 +47453,7 @@ declare namespace gapi.client {
       ): Request<Operation>;
     }
     interface ResourcePoliciesResource {
-      /** Retrieves an aggregated list of resource policies. */
+      /** Retrieves an aggregated list of resource policies. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -47376,7 +47485,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -47592,7 +47701,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -47755,7 +47864,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface RoutersResource {
-      /** Retrieves an aggregated list of routers. */
+      /** Retrieves an aggregated list of routers. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -47787,7 +47896,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -48044,7 +48153,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Name of the Router resource to query for Nat Mapping information of VM endpoints. */
         router: string;
@@ -48225,7 +48334,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -48274,7 +48383,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Name or id of the resource for this request. Name should conform to RFC1035. */
         router: string;
@@ -48319,7 +48428,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Name or id of the resource for this request. Name should conform to RFC1035. */
         router: string;
@@ -48362,7 +48471,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Name or id of the resource for this request. Name should conform to RFC1035. */
         router: string;
@@ -48937,7 +49046,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -49052,7 +49161,7 @@ declare namespace gapi.client {
         },
         body: SecurityPolicyRule
       ): Request<Operation>;
-      /** Retrieves the list of all SecurityPolicy resources, regional and global, available to the specified project. */
+      /** Retrieves the list of all SecurityPolicy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -49084,7 +49193,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -49292,7 +49401,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -49331,7 +49440,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -49597,7 +49706,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface ServiceAttachmentsResource {
-      /** Retrieves the list of all ServiceAttachment resources, regional and global, available to the specified project. */
+      /** Retrieves the list of all ServiceAttachment resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -49629,7 +49738,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -49845,7 +49954,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region of this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -50002,7 +50111,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface SnapshotsResource {
-      /** Retrieves an aggregated list of all of the snapshots in your project across all regions and global scope. */
+      /** Retrieves an aggregated list of all of the snapshots in your project across all regions and global scope. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -50034,7 +50143,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -50238,7 +50347,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -50452,7 +50561,7 @@ declare namespace gapi.client {
       ): Request<Operation>;
     }
     interface SslCertificatesResource {
-      /** Retrieves the list of all SslCertificate resources, regional and global, available to the specified project. */
+      /** Retrieves the list of all SslCertificate resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -50484,7 +50593,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -50655,7 +50764,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -50700,7 +50809,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface SslPoliciesResource {
-      /** Retrieves the list of all SslPolicy resources, regional and global, available to the specified project. */
+      /** Retrieves the list of all SslPolicy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -50732,7 +50841,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -50903,7 +51012,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -50942,7 +51051,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -51057,7 +51166,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface StoragePoolsResource {
-      /** Retrieves an aggregated list of storage pools. */
+      /** Retrieves an aggregated list of storage pools. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -51089,7 +51198,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -51303,7 +51412,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -51344,7 +51453,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Name of the storage pool to list disks of. */
         storagePool: string;
@@ -51547,7 +51656,7 @@ declare namespace gapi.client {
       ): Request<Operation>;
     }
     interface StoragePoolTypesResource {
-      /** Retrieves an aggregated list of storage pool types. */
+      /** Retrieves an aggregated list of storage pool types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -51579,7 +51688,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -51653,7 +51762,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -51666,7 +51775,7 @@ declare namespace gapi.client {
       }): Request<StoragePoolTypeList>;
     }
     interface SubnetworksResource {
-      /** Retrieves an aggregated list of subnetworks. */
+      /** Retrieves an aggregated list of subnetworks. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -51698,7 +51807,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -51988,7 +52097,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -52027,7 +52136,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The project id or project number in which the subnetwork is intended to be used. Only applied for Shared VPC. See [Shared VPC documentation](https://cloud.google.com/vpc/docs/shared-vpc/) */
         serviceProject?: string;
@@ -52424,7 +52533,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -52539,7 +52648,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface TargetHttpProxiesResource {
-      /** Retrieves the list of all TargetHttpProxy resources, regional and global, available to the specified project. */
+      /** Retrieves the list of all TargetHttpProxy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -52571,7 +52680,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -52742,7 +52851,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -52927,7 +53036,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface TargetHttpsProxiesResource {
-      /** Retrieves the list of all TargetHttpsProxy resources, regional and global, available to the specified project. */
+      /** Retrieves the list of all TargetHttpsProxy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -52959,7 +53068,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -53130,7 +53239,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -53595,7 +53704,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface TargetInstancesResource {
-      /** Retrieves an aggregated list of target instances. */
+      /** Retrieves an aggregated list of target instances. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -53627,7 +53736,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -53806,7 +53915,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -54077,7 +54186,7 @@ declare namespace gapi.client {
         },
         body: TargetPoolsAddInstanceRequest
       ): Request<Operation>;
-      /** Retrieves an aggregated list of target pools. */
+      /** Retrieves an aggregated list of target pools. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -54109,7 +54218,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -54360,7 +54469,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region scoping this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -54867,7 +54976,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -55262,7 +55371,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface TargetTcpProxiesResource {
-      /** Retrieves the list of all TargetTcpProxy resources, regional and global, available to the specified project. */
+      /** Retrieves the list of all TargetTcpProxy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -55294,7 +55403,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -55465,7 +55574,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -55650,7 +55759,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface TargetVpnGatewaysResource {
-      /** Retrieves an aggregated list of target VPN gateways. */
+      /** Retrieves an aggregated list of target VPN gateways. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -55682,7 +55791,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -55863,7 +55972,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -55948,7 +56057,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface UrlMapsResource {
-      /** Retrieves the list of all UrlMap resources, regional and global, available to the specified project. */
+      /** Retrieves the list of all UrlMap resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -55980,7 +56089,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -56221,7 +56330,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -56472,7 +56581,7 @@ declare namespace gapi.client {
       ): Request<UrlMapsValidateResponse>;
     }
     interface VpnGatewaysResource {
-      /** Retrieves an aggregated list of VPN gateways. */
+      /** Retrieves an aggregated list of VPN gateways. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -56504,7 +56613,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -56718,7 +56827,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -56803,7 +56912,7 @@ declare namespace gapi.client {
       ): Request<TestPermissionsResponse>;
     }
     interface VpnTunnelsResource {
-      /** Retrieves an aggregated list of VPN tunnels. */
+      /** Retrieves an aggregated list of VPN tunnels. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -56835,7 +56944,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -57016,7 +57125,7 @@ declare namespace gapi.client {
         quotaUser?: string;
         /** Name of the region for this request. */
         region: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -57197,7 +57306,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -57243,7 +57352,7 @@ declare namespace gapi.client {
       }): Request<Operation>;
     }
     interface ZoneQueuedResourcesResource {
-      /** Retrieves an aggregated list of all of the queued resources in a project across all zones. */
+      /** Retrieves an aggregated list of all of the queued resources in a project across all zones. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
       aggregatedList(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -57275,7 +57384,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. */
         serviceProjectNumber?: string;
@@ -57489,7 +57598,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
@@ -57563,7 +57672,7 @@ declare namespace gapi.client {
         project: string;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. */
+        /** Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. */
         returnPartialSuccess?: boolean;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;