@maxim_mazurok/gapi.client.compute-alpha 0.0.20250320 → 0.0.20250415

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/index.d.ts +611 -84
  2. package/package.json +1 -1
  3. package/readme.md +30 -10
package/index.d.ts CHANGED
@@ -9,7 +9,7 @@
9
9
  // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
10
10
  // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
11
11
  // Generated from: https://www.googleapis.com/discovery/v1/apis/compute/alpha/rest
12
- // Revision: 20250320
12
+ // Revision: 20250415
13
13
 
14
14
  /// <reference types="gapi.client" />
15
15
 
@@ -749,7 +749,7 @@ declare namespace gapi.client {
749
749
  cacheMode?: string;
750
750
  /** Specifies a separate client (e.g. browser client) maximum TTL. This is used to clamp the max-age (or Expires) value sent to the client. With FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the response max-age directive, along with a "public" directive. For cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age from the origin (if specified), or else sets the response max-age directive to the lesser of the client_ttl and default_ttl, and also ensures a "public" cache-control directive is present. If a client TTL is not specified, a default value (1 hour) will be used. The maximum allowed value is 31,622,400s (1 year). */
751
751
  clientTtl?: number;
752
- /** Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-max-age). Setting a TTL of "0" means "always revalidate". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses. The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. */
752
+ /** Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means "always revalidate". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses. The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. */
753
753
  defaultTtl?: number;
754
754
  /** Specifies the maximum allowed TTL for cached content served by this origin. Cache directives that attempt to set a max-age or s-maxage higher than this, or an Expires header more than maxTTL seconds in the future will be capped at the value of maxTTL, as if it were the value of an s-maxage Cache-Control directive. Headers sent to the client will not be modified. Setting a TTL of "0" means "always revalidate". The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. */
755
755
  maxTtl?: number;
@@ -759,7 +759,7 @@ declare namespace gapi.client {
759
759
  negativeCachingPolicy?: BackendBucketCdnPolicyNegativeCachingPolicy[];
760
760
  /** If true then Cloud CDN will combine multiple concurrent cache fill requests into a small number of requests to the origin. */
761
761
  requestCoalescing?: boolean;
762
- /** Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default "max-stale" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-max-age) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale. */
762
+ /** Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default "max-stale" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-maxage) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale. */
763
763
  serveWhileStale?: number;
764
764
  /** Maximum number of seconds the response to a signed URL request will be considered fresh. After this time period, the response will be revalidated before being served. Defaults to 1hr (3600s). When serving responses to signed URL requests, Cloud CDN will internally behave as though all responses from this backend had a "Cache-Control: public, max-age=[TTL]" header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered. */
765
765
  signedUrlCacheMaxAgeSec?: string;
@@ -990,7 +990,7 @@ declare namespace gapi.client {
990
990
  cacheMode?: string;
991
991
  /** Specifies a separate client (e.g. browser client) maximum TTL. This is used to clamp the max-age (or Expires) value sent to the client. With FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the response max-age directive, along with a "public" directive. For cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age from the origin (if specified), or else sets the response max-age directive to the lesser of the client_ttl and default_ttl, and also ensures a "public" cache-control directive is present. If a client TTL is not specified, a default value (1 hour) will be used. The maximum allowed value is 31,622,400s (1 year). */
992
992
  clientTtl?: number;
993
- /** Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-max-age). Setting a TTL of "0" means "always revalidate". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses. The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. */
993
+ /** Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means "always revalidate". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses. The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. */
994
994
  defaultTtl?: number;
995
995
  /** Specifies the maximum allowed TTL for cached content served by this origin. Cache directives that attempt to set a max-age or s-maxage higher than this, or an Expires header more than maxTTL seconds in the future will be capped at the value of maxTTL, as if it were the value of an s-maxage Cache-Control directive. Headers sent to the client will not be modified. Setting a TTL of "0" means "always revalidate". The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. */
996
996
  maxTtl?: number;
@@ -1000,7 +1000,7 @@ declare namespace gapi.client {
1000
1000
  negativeCachingPolicy?: BackendServiceCdnPolicyNegativeCachingPolicy[];
1001
1001
  /** If true then Cloud CDN will combine multiple concurrent cache fill requests into a small number of requests to the origin. */
1002
1002
  requestCoalescing?: boolean;
1003
- /** Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default "max-stale" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-max-age) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale. */
1003
+ /** Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default "max-stale" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-maxage) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale. */
1004
1004
  serveWhileStale?: number;
1005
1005
  /** Maximum number of seconds the response to a signed URL request will be considered fresh. After this time period, the response will be revalidated before being served. Defaults to 1hr (3600s). When serving responses to signed URL requests, Cloud CDN will internally behave as though all responses from this backend had a "Cache-Control: public, max-age=[TTL]" header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered. */
1006
1006
  signedUrlCacheMaxAgeSec?: string;
@@ -1058,7 +1058,7 @@ declare namespace gapi.client {
1058
1058
  kind?: string;
1059
1059
  }
1060
1060
  interface BackendServiceHAPolicy {
1061
- /** Specifies whether fast IP move is enabled, and if so, the mechanism to achieve it. Supported values are: - DISABLED: Fast IP Move is disabled. You can only use the haPolicy.leader API to update the leader. - >GARP_RA: Provides a method to very quickly define a new network endpoint as the leader. This method is faster than updating the leader using the haPolicy.leader API. Fast IP move works as follows: The VM hosting the network endpoint that should become the new leader sends either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router Advertisement(RA) packet (IPv6). Google Cloud immediately but temporarily associates the forwarding rule IP address with that VM, and both new and in-flight packets are quickly delivered to that VM. Note the important properties of the Fast IP Move functionality: - The GARP/RA-initiated re-routing stays active for approximately 20 minutes. After triggering fast failover, you must also appropriately set the haPolicy.leader. - The new leader instance should continue to send GARP/RA packets periodically every 10 seconds until at least 10 minutes after updating the haPolicy.leader (but stop immediately if it is no longer the leader). - After triggering a fast failover, we recommend that you wait at least 3 seconds before sending another GARP/RA packet from a different VM instance to avoid race conditions. - Don't send GARP/RA packets from different VM instances at the same time. If multiple instances continue to send GARP/RA packets, traffic might be routed to different destinations in an alternating order. This condition ceases when a single instance issues a GARP/RA packet. - The GARP/RA request always takes priority over the leader API. Using the haPolicy.leader API to change the leader to a different instance will have no effect until the GARP/RA request becomes inactive. - The GARP/RA packets should follow the GARP/RA Packet Specifications.. - When multiple forwarding rules refer to a regional backend service, you need only send a GARP or RA packet for a single forwarding rule virtual IP. The virtual IPs for all forwarding rules targeting the same backend service will also be moved to the sender of the GARP or RA packet. The following are the Fast IP Move limitations (that is, when fastIPMove is not DISABLED): - Multiple forwarding rules cannot use the same IP address if one of them refers to a regional backend service with fastIPMove. - The regional backend service must set the network field, and all NEGs must belong to that network. However, individual NEGs can belong to different subnetworks of that network. - The maximum number of network endpoints across all backends of a backend service with fastIPMove is 64. - The maximum number of backend services with fastIPMove that can have the same network endpoint attached to one of its backends is 64. - The maximum number of backend services with fastIPMove in a VPC in a region is 64. - The network endpoints that are attached to a backend of a backend service with fastIPMove cannot resolve to C3 machines. - Traffic directed to the leader by a static route next hop will not be redirected to a new leader by fast failover. Such traffic will only be redirected once an haPolicy.leader update has taken effect. Only traffic to the forwarding rule's virtual IP will be redirected to a new leader by fast failover. haPolicy.fastIPMove can be set only at backend service creation time. Once set, it cannot be updated. By default, fastIpMove is set to DISABLED. */
1061
+ /** Specifies whether fast IP move is enabled, and if so, the mechanism to achieve it. Supported values are: - DISABLED: Fast IP Move is disabled. You can only use the haPolicy.leader API to update the leader. - >GARP_RA: Provides a method to very quickly define a new network endpoint as the leader. This method is faster than updating the leader using the haPolicy.leader API. Fast IP move works as follows: The VM hosting the network endpoint that should become the new leader sends either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router Advertisement(RA) packet (IPv6). Google Cloud immediately but temporarily associates the forwarding rule IP address with that VM, and both new and in-flight packets are quickly delivered to that VM. Note the important properties of the Fast IP Move functionality: - The GARP/RA-initiated re-routing stays active for approximately 20 minutes. After triggering fast failover, you must also appropriately set the haPolicy.leader. - The new leader instance should continue to send GARP/RA packets periodically every 10 seconds until at least 10 minutes after updating the haPolicy.leader (but stop immediately if it is no longer the leader). - After triggering a fast failover, we recommend that you wait at least 3 seconds before sending another GARP/RA packet from a different VM instance to avoid race conditions. - Don't send GARP/RA packets from different VM instances at the same time. If multiple instances continue to send GARP/RA packets, traffic might be routed to different destinations in an alternating order. This condition ceases when a single instance issues a GARP/RA packet. - The GARP/RA request always takes priority over the leader API. Using the haPolicy.leader API to change the leader to a different instance will have no effect until the GARP/RA request becomes inactive. - The GARP/RA packets should follow the GARP/RA Packet Specifications.. - When multiple forwarding rules refer to a regional backend service, you need only send a GARP or RA packet for a single forwarding rule virtual IP. The virtual IPs for all forwarding rules targeting the same backend service will also be moved to the sender of the GARP or RA packet. The following are the Fast IP Move limitations (that is, when fastIPMove is not DISABLED): - Multiple forwarding rules cannot use the same IP address if one of them refers to a regional backend service with fastIPMove. - The regional backend service must set the network field, and all NEGs must belong to that network. However, individual NEGs can belong to different subnetworks of that network. - The maximum number of network endpoints across all backends of a backend service with fastIPMove is 64. - The maximum number of backend services with fastIPMove that can have the same network endpoint attached to one of its backends is 64. - The maximum number of backend services with fastIPMove in a VPC in a region is 64. - The network endpoints that are attached to a backend of a backend service with fastIPMove cannot resolve to Gen3+ machines for IPv6. - Traffic directed to the leader by a static route next hop will not be redirected to a new leader by fast failover. Such traffic will only be redirected once an haPolicy.leader update has taken effect. Only traffic to the forwarding rule's virtual IP will be redirected to a new leader by fast failover. haPolicy.fastIPMove can be set only at backend service creation time. Once set, it cannot be updated. By default, fastIpMove is set to DISABLED. */
1062
1062
  fastIPMove?: string;
1063
1063
  /** Selects one of the network endpoints attached to the backend NEGs of this service as the active endpoint (the leader) that receives all traffic. When the leader changes, there is no connection draining to persist existing connections on the old leader. You are responsible for selecting a suitable endpoint as the leader. For example, preferring a healthy endpoint over unhealthy ones. Note that this service does not track backend endpoint health, and selects the configured leader unconditionally. */
1064
1064
  leader?: BackendServiceHAPolicyLeader;
@@ -1339,6 +1339,10 @@ declare namespace gapi.client {
1339
1339
  role?: string;
1340
1340
  }
1341
1341
  interface BulkInsertDiskResource {
1342
+ /** The parameters for the instant snapshot group. */
1343
+ instantSnapshotGroupParameters?: InstantSnapshotGroupParameters;
1344
+ /** The parameters for the snapshot group. */
1345
+ snapshotGroupParameters?: SnapshotGroupParameters;
1342
1346
  /** The URL of the DiskConsistencyGroupPolicy for the group of disks to clone. This may be a full or partial URL, such as: - https://www.googleapis.com/compute/v1/projects/project/regions/region /resourcePolicies/resourcePolicy - projects/project/regions/region/resourcePolicies/resourcePolicy - regions/region/resourcePolicies/resourcePolicy */
1343
1347
  sourceConsistencyGroupPolicy?: string;
1344
1348
  }
@@ -1394,7 +1398,7 @@ declare namespace gapi.client {
1394
1398
  partitionCount?: number;
1395
1399
  }
1396
1400
  interface CacheInvalidationRule {
1397
- /** [Preview] A list of cache tags used to identify cached objects. - Cache tags are specified when the response is first cached, by setting the `Cache-Tag` response header at the origin. - Multiple cache tags in the same invalidation request are treated as Boolean `OR` - for example, `tag1 OR tag2 OR tag3`. - If other fields are also specified, these are treated as Boolean `AND` with any tags. Up to 10 tags can be specified in a single invalidation request. */
1401
+ /** A list of cache tags used to identify cached objects. - Cache tags are specified when the response is first cached, by setting the `Cache-Tag` response header at the origin. - Multiple cache tags in the same invalidation request are treated as Boolean `OR` - for example, `tag1 OR tag2 OR tag3`. - If other fields are also specified, these are treated as Boolean `AND` with any tags. Up to 10 tags can be specified in a single invalidation request. */
1398
1402
  cacheTags?: string[];
1399
1403
  /** If set, this invalidation rule will only apply to requests with a Host header matching host. */
1400
1404
  host?: string;
@@ -1830,6 +1834,14 @@ declare namespace gapi.client {
1830
1834
  /** The full path to a file within backendBucket . For example: /errors/defaultError.html path must start with a leading slash. path cannot have trailing slashes. If the file is not available in backendBucket or the load balancer cannot reach the BackendBucket, a simple Not Found Error is returned to the client. The value must be from 1 to 1024 characters */
1831
1835
  path?: string;
1832
1836
  }
1837
+ interface Date {
1838
+ /** Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. */
1839
+ day?: number;
1840
+ /** Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. */
1841
+ month?: number;
1842
+ /** Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. */
1843
+ year?: number;
1844
+ }
1833
1845
  interface DeprecationStatus {
1834
1846
  /** An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it. */
1835
1847
  deleted?: string;
@@ -2402,6 +2414,8 @@ declare namespace gapi.client {
2402
2414
  name?: string;
2403
2415
  /** URL of the network resource for this firewall rule. If not specified when creating a firewall rule, the default network is used: global/networks/default If you choose to specify this field, you can specify the network as a full or partial URL. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network - projects/myproject/global/networks/my-network - global/networks/default */
2404
2416
  network?: string;
2417
+ /** Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. */
2418
+ params?: FirewallParams;
2405
2419
  /** Priority for this rule. This is an integer between `0` and `65535`, both inclusive. The default value is `1000`. Relative priorities determine which rule takes effect if multiple rules apply. Lower values indicate higher priority. For example, a rule with priority `0` has higher precedence than a rule with priority `1`. DENY rules take precedence over ALLOW rules if they have equal priority. Note that VPC networks have implied rules with a priority of `65535`. To avoid conflicts with the implied rules, use a priority number less than `65535`. */
2406
2420
  priority?: number;
2407
2421
  /** [Output Only] Server-defined URL for the resource. */
@@ -2451,6 +2465,10 @@ declare namespace gapi.client {
2451
2465
  /** This field can only be specified for a particular firewall rule if logging is enabled for that rule. This field denotes whether to include or exclude metadata for firewall logs. */
2452
2466
  metadata?: string;
2453
2467
  }
2468
+ interface FirewallParams {
2469
+ /** Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. */
2470
+ resourceManagerTags?: {[P in string]: string};
2471
+ }
2454
2472
  interface FirewallPoliciesListAssociationsResponse {
2455
2473
  /** A list of associations. */
2456
2474
  associations?: FirewallPolicyAssociation[];
@@ -2496,6 +2514,8 @@ declare namespace gapi.client {
2496
2514
  packetMirroringRules?: FirewallPolicyRule[];
2497
2515
  /** [Output Only] The parent of the firewall policy. This field is not applicable to network firewall policies. */
2498
2516
  parent?: string;
2517
+ /** The type of the firewall policy. This field can be either VPC_POLICY or RDMA_ROCE_POLICY. Note: if not specified then VPC_POLICY will be used. */
2518
+ policyType?: string;
2499
2519
  /** [Output Only] URL of the region where the regional firewall policy resides. This field is not applicable to global firewall policies. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. */
2500
2520
  region?: string;
2501
2521
  /** A list of rules that belong to this policy. There must always be a default rule (rule with priority 2147483647 and match "*"). If no rules are provided when creating a firewall policy, a default rule with action "allow" will be added. */
@@ -2572,12 +2592,16 @@ declare namespace gapi.client {
2572
2592
  ruleTupleCount?: number;
2573
2593
  /** A fully-qualified URL of a SecurityProfile resource instance. Example: https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group Must be specified if action is one of 'apply_security_profile_group' or 'mirror'. Cannot be specified for other actions. */
2574
2594
  securityProfileGroup?: string;
2595
+ /** A list of forwarding rules to which this rule applies. This field allows you to control which load balancers get this rule. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project /global/forwardingRules/forwardingRule - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - projects/project/global/ forwardingRules/forwardingRule - projects/project/regions/region/forwardingRules/ forwardingRule */
2596
+ targetForwardingRules?: string[];
2575
2597
  /** A list of network resource URLs to which this rule applies. This field allows you to control which network's VMs get this rule. If this field is left blank, all VMs within the organization will receive the rule. */
2576
2598
  targetResources?: string[];
2577
2599
  /** A list of secure tags that controls which instances the firewall rule applies to. If targetSecureTag are specified, then the firewall rule applies only to instances in the VPC network that have one of those EFFECTIVE secure tags, if all the target_secure_tag are in INEFFECTIVE state, then this rule will be ignored. targetSecureTag may not be set at the same time as targetServiceAccounts. If neither targetServiceAccounts nor targetSecureTag are specified, the firewall rule applies to all instances on the specified network. Maximum number of target label tags allowed is 256. */
2578
2600
  targetSecureTags?: FirewallPolicyRuleSecureTag[];
2579
2601
  /** A list of service accounts indicating the sets of instances that are applied with this rule. */
2580
2602
  targetServiceAccounts?: string[];
2603
+ /** Target types of the firewall policy rule. Default value is INSTANCES. */
2604
+ targetType?: string;
2581
2605
  /** Boolean flag indicating if the traffic should be TLS decrypted. Can be set only if action = 'apply_security_profile_group' and cannot be set for other actions. */
2582
2606
  tlsInspect?: boolean;
2583
2607
  }
@@ -2820,6 +2844,8 @@ declare namespace gapi.client {
2820
2844
  deploymentType?: string;
2821
2845
  /** An optional description of this resource. Provide this property when you create the future reservation. */
2822
2846
  description?: string;
2847
+ /** Indicates if this group of VMs have emergent maintenance enabled. */
2848
+ enableEmergentMaintenance?: boolean;
2823
2849
  /** [Output Only] A unique identifier for this future reservation. The server defines this identifier. */
2824
2850
  id?: string;
2825
2851
  /** [Output Only] Type of the resource. Always compute#futureReservation for future reservations. */
@@ -3170,7 +3196,7 @@ declare namespace gapi.client {
3170
3196
  items?: GuestAttributesEntry[];
3171
3197
  }
3172
3198
  interface GuestOsFeature {
3173
- /** The ID of a supported feature. To add multiple values, use commas to separate values. Set to one or more of the following values: - VIRTIO_SCSI_MULTIQUEUE - WINDOWS - MULTI_IP_SUBNET - UEFI_COMPATIBLE - GVNIC - SEV_CAPABLE - SUSPEND_RESUME_COMPATIBLE - SEV_LIVE_MIGRATABLE_V2 - SEV_SNP_CAPABLE - TDX_CAPABLE - IDPF For more information, see Enabling guest operating system features. */
3199
+ /** The ID of a supported feature. To add multiple values, use commas to separate values. Set to one or more of the following values: - VIRTIO_SCSI_MULTIQUEUE - WINDOWS - MULTI_IP_SUBNET - UEFI_COMPATIBLE - GVNIC - SEV_CAPABLE - SUSPEND_RESUME_COMPATIBLE - SEV_LIVE_MIGRATABLE_V2 - SEV_SNP_CAPABLE - TDX_CAPABLE - IDPF - SNP_SVSM_CAPABLE For more information, see Enabling guest operating system features. */
3174
3200
  type?: string;
3175
3201
  }
3176
3202
  interface HealthAggregationPolicy {
@@ -4523,7 +4549,7 @@ declare namespace gapi.client {
4523
4549
  description?: string;
4524
4550
  /** [Output Only] A unique identifier for this resource type. The server generates this identifier. */
4525
4551
  id?: string;
4526
- /** The list of specifications of per-instance configs to be created. This field cannot be used together with 'resize_by'. */
4552
+ /** The names of instances to be created by this resize request. The number of names specified determines the number of instances to create. The group's target size will be increased by this number. This field cannot be used together with 'resize_by'. */
4527
4553
  instances?: PerInstanceConfig[];
4528
4554
  /** [Output Only] The resource type, which is always compute#instanceGroupManagerResizeRequest for resize requests. */
4529
4555
  kind?: string;
@@ -5135,7 +5161,7 @@ declare namespace gapi.client {
5135
5161
  interface InstancesReportHostAsFaultyRequest {
5136
5162
  /** The action hint to report the host as faulty. */
5137
5163
  actionHint?: string;
5138
- /** The disruption schedule for the VM. Default to IMMEDIATE. */
5164
+ /** The disruption schedule for the VM. Required field, only allows IMMEDIATE. */
5139
5165
  disruptionSchedule?: string;
5140
5166
  faultReasons?: InstancesReportHostAsFaultyRequestFaultReason[];
5141
5167
  }
@@ -5408,6 +5434,10 @@ declare namespace gapi.client {
5408
5434
  /** [Output Only] URL of the zone where the instant snapshot group resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. */
5409
5435
  zone?: string;
5410
5436
  }
5437
+ interface InstantSnapshotGroupParameters {
5438
+ /** The source instant snapshot group used to create disks. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instantSnapshotGroups/instantSnapshotGroup - projects/project/zones/zone/instantSnapshotGroups/instantSnapshotGroup - zones/zone/instantSnapshotGroups/instantSnapshotGroup */
5439
+ sourceInstantSnapshotGroup?: string;
5440
+ }
5411
5441
  interface InstantSnapshotGroupResourceStatus {
5412
5442
  /** [Output Only] */
5413
5443
  consistencyMembershipResolutionTime?: string;
@@ -6234,7 +6264,7 @@ declare namespace gapi.client {
6234
6264
  availabilityZone?: string;
6235
6265
  /** [Output only] List of features available at this InterconnectLocation, which can take one of the following values: - IF_MACSEC */
6236
6266
  availableFeatures?: string[];
6237
- /** [Output only] List of link types available at this InterconnectLocation, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR - LINK_TYPE_ETHERNET_100G_LR */
6267
+ /** [Output only] List of link types available at this InterconnectLocation, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR - LINK_TYPE_ETHERNET_100G_LR - LINK_TYPE_ETHERNET_400G_LR4 */
6238
6268
  availableLinkTypes?: string[];
6239
6269
  /** [Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: "Chicago, IL", "Amsterdam, Netherlands". */
6240
6270
  city?: string;
@@ -6504,6 +6534,8 @@ declare namespace gapi.client {
6504
6534
  nextPageToken?: string;
6505
6535
  /** [Output Only] Server-defined URL for this resource. */
6506
6536
  selfLink?: string;
6537
+ /** [Output Only] Unreachable resources. */
6538
+ unreachables?: string[];
6507
6539
  /** [Output Only] Informational warning message. */
6508
6540
  warning?: {
6509
6541
  /** [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. */
@@ -6974,6 +7006,8 @@ declare namespace gapi.client {
6974
7006
  preservedStateFromPolicy?: PreservedState;
6975
7007
  /** [Output Only] Instance properties selected for this instance resulting from InstanceFlexibilityPolicy. */
6976
7008
  propertiesFromFlexibilityPolicy?: ManagedInstancePropertiesFromFlexibilityPolicy;
7009
+ /** [Output Only] Information about the termination timestamp of the instance, if applicable. */
7010
+ scheduling?: ManagedInstanceScheduling;
6977
7011
  /** [Output only] The size of the VM represented by this Managed Instance. This is how much this Managed Instance contributes to the size of the group. */
6978
7012
  sizeInUnit?: number;
6979
7013
  /** [Output Only] Tag describing the version. */
@@ -7033,6 +7067,10 @@ declare namespace gapi.client {
7033
7067
  /** The provisioning model to be used for this instance. */
7034
7068
  provisioningModel?: string;
7035
7069
  }
7070
+ interface ManagedInstanceScheduling {
7071
+ /** [Output Only] The timestamp when the MIG will automatically terminate the instance. The value is in RFC3339 text format. */
7072
+ terminationTimestamp?: string;
7073
+ }
7036
7074
  interface ManagedInstanceVersion {
7037
7075
  /** [Output Only] The intended template of the instance. This field is empty when current_action is one of { DELETING, ABANDONING }. */
7038
7076
  instanceTemplate?: string;
@@ -7184,6 +7222,8 @@ declare namespace gapi.client {
7184
7222
  }
7185
7223
  interface MultiMigStatus {
7186
7224
  memberInstanceGroupManagers?: string[];
7225
+ /** [Output Only] The number of instance group manager members in this multi-MIG. */
7226
+ membersCount?: number;
7187
7227
  }
7188
7228
  interface MutualTls {
7189
7229
  /** Specifies if the server TLS is configured to be strict or permissive. This field can be set to one of the following: STRICT: Client certificate must be presented, connection is in TLS. PERMISSIVE: Client certificate can be omitted, connection can be either plaintext or TLS. */
@@ -7252,6 +7292,8 @@ declare namespace gapi.client {
7252
7292
  networkFirewallPolicyEnforcementOrder?: string;
7253
7293
  /** A full or partial URL of the network profile to apply to this network. This field can be set only at resource creation time. For example, the following are valid URLs: - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name} - projects/{project_id}/global/networkProfiles/{network_profile_name} */
7254
7294
  networkProfile?: string;
7295
+ /** Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. */
7296
+ params?: NetworkParams;
7255
7297
  /** [Output Only] A list of network peerings for the resource. */
7256
7298
  peerings?: NetworkPeering[];
7257
7299
  /** [Output Only] URL of the region where the regional network resides. This field is not applicable to global network. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. */
@@ -7789,11 +7831,17 @@ declare namespace gapi.client {
7789
7831
  message?: string;
7790
7832
  };
7791
7833
  }
7834
+ interface NetworkParams {
7835
+ /** Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. */
7836
+ resourceManagerTags?: {[P in string]: string};
7837
+ }
7792
7838
  interface NetworkPeering {
7793
7839
  /** Whether Cloud Routers in this network can automatically advertise subnets from the peer network. */
7794
7840
  advertisePeerSubnetsViaRouters?: boolean;
7795
7841
  /** This field will be deprecated soon. Use the exchange_subnet_routes field instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. */
7796
7842
  autoCreateRoutes?: boolean;
7843
+ /** [Output Only] The effective state of the peering connection as a whole. */
7844
+ connectionStatus?: NetworkPeeringConnectionStatus;
7797
7845
  /** Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. */
7798
7846
  exchangeSubnetRoutes?: boolean;
7799
7847
  /** Whether to export the custom routes to peer network. The default value is false. */
@@ -7808,7 +7856,7 @@ declare namespace gapi.client {
7808
7856
  name?: string;
7809
7857
  /** The URL of the peer network. It can be either full URL or partial URL. The peer network may belong to a different project. If the partial URL does not contain project, it is assumed that the peer network is in the same project as the current network. */
7810
7858
  network?: string;
7811
- /** Maximum Transmission Unit in bytes. */
7859
+ /** [Output Only] Maximum Transmission Unit in bytes of the peer network. */
7812
7860
  peerMtu?: number;
7813
7861
  /** Which IP version(s) of traffic and routes are allowed to be imported or exported between peer networks. The default value is IPV4_ONLY. */
7814
7862
  stackType?: string;
@@ -7816,6 +7864,34 @@ declare namespace gapi.client {
7816
7864
  state?: string;
7817
7865
  /** [Output Only] Details about the current state of the peering. */
7818
7866
  stateDetails?: string;
7867
+ /** The update strategy determines the semantics for updates and deletes to the peering connection configuration. */
7868
+ updateStrategy?: string;
7869
+ }
7870
+ interface NetworkPeeringConnectionStatus {
7871
+ /** The consensus state contains the information about the status of update and delete for a consensus peering connection. */
7872
+ consensusState?: NetworkPeeringConnectionStatusConsensusState;
7873
+ /** The active connectivity settings for the peering connection based on the settings of the network peerings. */
7874
+ trafficConfiguration?: NetworkPeeringConnectionStatusTrafficConfiguration;
7875
+ /** The update strategy determines the update/delete semantics for this peering connection. */
7876
+ updateStrategy?: string;
7877
+ }
7878
+ interface NetworkPeeringConnectionStatusConsensusState {
7879
+ /** The status of the delete request. */
7880
+ deleteStatus?: string;
7881
+ /** The status of the update request. */
7882
+ updateStatus?: string;
7883
+ }
7884
+ interface NetworkPeeringConnectionStatusTrafficConfiguration {
7885
+ /** Whether custom routes are being exported to the peer network. */
7886
+ exportCustomRoutesToPeer?: boolean;
7887
+ /** Whether subnet routes with public IP range are being exported to the peer network. */
7888
+ exportSubnetRoutesWithPublicIpToPeer?: boolean;
7889
+ /** Whether custom routes is being imported from the peer network. */
7890
+ importCustomRoutesFromPeer?: boolean;
7891
+ /** Whether subnet routes with public IP range are being imported from the peer network. */
7892
+ importSubnetRoutesWithPublicIpFromPeer?: boolean;
7893
+ /** Which IP version(s) of traffic and routes are being imported or exported between peer networks. */
7894
+ stackType?: string;
7819
7895
  }
7820
7896
  interface NetworkPerformanceConfig {
7821
7897
  externalIpEgressBandwidthTier?: string;
@@ -7858,14 +7934,22 @@ declare namespace gapi.client {
7858
7934
  allowCloudNat?: string;
7859
7935
  /** Specifies whether cloud router creation is allowed. */
7860
7936
  allowCloudRouter?: string;
7937
+ /** Specifies whether default NIC attachment is allowed. */
7938
+ allowDefaultNicAttachment?: string;
7861
7939
  /** Specifies whether VMs are allowed to have external IP access on network interfaces connected to this VPC. */
7862
7940
  allowExternalIpAccess?: string;
7863
7941
  /** Specifies whether Cloud Interconnect creation is allowed. */
7864
7942
  allowInterconnect?: string;
7943
+ /** Specifies whether IP forwarding is allowed. */
7944
+ allowIpForwarding?: string;
7865
7945
  /** Specifies whether cloud load balancing is allowed. */
7866
7946
  allowLoadBalancing?: string;
7867
7947
  /** Specifies whether multi-nic in the same network is allowed. */
7868
7948
  allowMultiNicInSameNetwork?: string;
7949
+ /** Specifies whether NCC is allowed. */
7950
+ allowNcc?: string;
7951
+ /** Specifies whether VM network migration is allowed. */
7952
+ allowNetworkMigration?: string;
7869
7953
  /** Specifies whether Packet Mirroring 1.0 is supported. */
7870
7954
  allowPacketMirroring?: string;
7871
7955
  /** Specifies whether private Google access is allowed. */
@@ -7888,6 +7972,10 @@ declare namespace gapi.client {
7888
7972
  subnetPurposes?: string[];
7889
7973
  /** Specifies which subnetwork stack types are supported. */
7890
7974
  subnetStackTypes?: string[];
7975
+ /** Specifies which subnetwork purposes are supported. */
7976
+ subnetworkPurposes?: string[];
7977
+ /** Specifies which subnetwork stack types are supported. */
7978
+ subnetworkStackTypes?: string[];
7891
7979
  /** Specifies which type of unicast is supported. */
7892
7980
  unicast?: string;
7893
7981
  }
@@ -7982,6 +8070,10 @@ declare namespace gapi.client {
7982
8070
  /** Name of the peering, which should conform to RFC1035. */
7983
8071
  name?: string;
7984
8072
  }
8073
+ interface NetworksRequestRemovePeeringRequest {
8074
+ /** Name of the peering, which should conform to RFC1035. */
8075
+ name?: string;
8076
+ }
7985
8077
  interface NetworksUpdatePeeringRequest {
7986
8078
  networkPeering?: NetworkPeering;
7987
8079
  }
@@ -8967,6 +9059,92 @@ declare namespace gapi.client {
8967
9059
  /** An IPv4 internal network address to assign to the instance for this network interface. */
8968
9060
  literal?: string;
8969
9061
  }
9062
+ interface PreviewFeature {
9063
+ /** Specifies whether the feature is enabled or disabled. */
9064
+ activationStatus?: string;
9065
+ /** [Output Only] Creation timestamp in RFC3339 text format. */
9066
+ creationTimestamp?: string;
9067
+ /** [Output Only] Description of the feature. */
9068
+ description?: string;
9069
+ /** [Output Only] The unique identifier for the resource. This identifier is defined by the server. */
9070
+ id?: string;
9071
+ /** [Output only] The type of the feature. Always "compute#previewFeature" for preview features. */
9072
+ kind?: string;
9073
+ /** Name of the feature. */
9074
+ name?: string;
9075
+ /** Rollout operation of the feature. */
9076
+ rolloutOperation?: PreviewFeatureRolloutOperation;
9077
+ /** [Output Only] Server-defined URL for the resource. */
9078
+ selfLink?: string;
9079
+ /** [Output only] Status of the feature. */
9080
+ status?: PreviewFeatureStatus;
9081
+ }
9082
+ interface PreviewFeatureList {
9083
+ etag?: string;
9084
+ /** [Output Only] Unique identifier for the resource; defined by the server. */
9085
+ id?: string;
9086
+ /** A list of PreviewFeature resources. */
9087
+ items?: PreviewFeature[];
9088
+ /** [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. */
9089
+ nextPageToken?: string;
9090
+ /** [Output Only] Server-defined URL for this resource. */
9091
+ selfLink?: string;
9092
+ /** [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder */
9093
+ unreachables?: string[];
9094
+ /** [Output Only] Informational warning message. */
9095
+ warning?: {
9096
+ /** [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. */
9097
+ code?: string;
9098
+ /** [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } */
9099
+ data?: Array<{
9100
+ /** [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding). */
9101
+ key?: string;
9102
+ /** [Output Only] A warning data value corresponding to the key. */
9103
+ value?: string;
9104
+ }>;
9105
+ /** [Output Only] A human-readable description of the warning code. */
9106
+ message?: string;
9107
+ };
9108
+ }
9109
+ interface PreviewFeatureRolloutOperation {
9110
+ rolloutInput?: PreviewFeatureRolloutOperationRolloutInput;
9111
+ rolloutStatus?: PreviewFeatureRolloutOperationRolloutStatus;
9112
+ }
9113
+ interface PreviewFeatureRolloutOperationRolloutInput {
9114
+ /** The name of the rollout plan Ex. organizations//locations/global/rolloutPlans/ Ex. folders//locations/global/rolloutPlans/ Ex. projects//locations/global/rolloutPlans/. */
9115
+ name?: string;
9116
+ /** Predefined rollout plan. */
9117
+ predefinedRolloutPlan?: string;
9118
+ /** The UUID of the retry action. Only needed if this is a retry for an existing rollout. This can be used after the user canceled a rollout and want to retry it with no changes. */
9119
+ retryUuid?: string;
9120
+ }
9121
+ interface PreviewFeatureRolloutOperationRolloutStatus {
9122
+ /** Output only. The ongoing rollout resources. There can be multiple ongoing rollouts for a resource. */
9123
+ ongoingRollouts?: PreviewFeatureRolloutOperationRolloutStatusRolloutMetadata[];
9124
+ /** Output only. The last completed rollout resource. This field will not be populated until the first rollout is completed. */
9125
+ previousRollout?: PreviewFeatureRolloutOperationRolloutStatusRolloutMetadata;
9126
+ }
9127
+ interface PreviewFeatureRolloutOperationRolloutStatusRolloutMetadata {
9128
+ /** The name of the rollout Ex. organizations//locations/global/rollouts/ Ex. folders//locations/global/rollouts/ Ex. projects//locations/global/rollouts/. */
9129
+ rollout?: string;
9130
+ /** The name of the rollout plan Ex. organizations//locations/global/rolloutPlans/ Ex. folders//locations/global/rolloutPlans/ Ex. projects//locations/global/rolloutPlans/. */
9131
+ rolloutPlan?: string;
9132
+ /** The status of the rollout. */
9133
+ status?: PreviewFeatureStatus;
9134
+ }
9135
+ interface PreviewFeatureStatus {
9136
+ /** [Output Only] The description of the feature. */
9137
+ description?: string;
9138
+ /** [Output Only] Link to the public documentation for the feature. */
9139
+ helpLink?: string;
9140
+ releaseStatus?: PreviewFeatureStatusReleaseStatus;
9141
+ }
9142
+ interface PreviewFeatureStatusReleaseStatus {
9143
+ /** [Output Only] The stage of the feature. */
9144
+ stage?: string;
9145
+ /** Output only. The last date when a feature transitioned between ReleaseStatuses. */
9146
+ updateDate?: Date;
9147
+ }
8970
9148
  interface Principal {
8971
9149
  /** An expression to specify custom condition. */
8972
9150
  condition?: string;
@@ -9941,10 +10119,14 @@ declare namespace gapi.client {
9941
10119
  deploymentType?: string;
9942
10120
  /** An optional description of this resource. Provide this property when you create the resource. */
9943
10121
  description?: string;
10122
+ /** Indicates if this group of VMs have emergent maintenance enabled. */
10123
+ enableEmergentMaintenance?: boolean;
9944
10124
  /** [Output Only] The unique identifier for the resource. This identifier is defined by the server. */
9945
10125
  id?: string;
9946
10126
  /** [Output Only] Type of the resource. Always compute#reservations for reservations. */
9947
10127
  kind?: string;
10128
+ /** [Output Only] Full or partial URL to parent commitments. This field displays for reservations that are tied to multiple commitments. */
10129
+ linkedCommitments?: string[];
9948
10130
  /** The name of the resource, provided by the client when initially creating the resource. The resource 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. */
9949
10131
  name?: string;
9950
10132
  /** [Output only] Indicates the reservation mode of the reservation. */
@@ -10027,6 +10209,10 @@ declare namespace gapi.client {
10027
10209
  physicalTopology?: ReservationBlockPhysicalTopology;
10028
10210
  /** [Output Only] Maintenance information for this reservation block. */
10029
10211
  reservationMaintenance?: GroupMaintenanceInfo;
10212
+ /** [Output Only] The number of reservation subBlocks associated with this reservation block. */
10213
+ reservationSubBlockCount?: number;
10214
+ /** [Output Only] The number of in-use reservation subBlocks associated with this reservation block. If at least one VM is running on a subBlock, it is considered in-use. */
10215
+ reservationSubBlockInUseCount?: number;
10030
10216
  /** [Output Only] Server-defined fully-qualified URL for this resource. */
10031
10217
  selfLink?: string;
10032
10218
  /** [Output Only] Server-defined URL for this resource with the resource id. */
@@ -10127,6 +10313,67 @@ declare namespace gapi.client {
10127
10313
  message?: string;
10128
10314
  };
10129
10315
  }
10316
+ interface ReservationSubBlock {
10317
+ /** [Output Only] The number of hosts that are allocated in this reservation subBlock. */
10318
+ count?: number;
10319
+ /** [Output Only] Creation timestamp in RFC3339 text format. */
10320
+ creationTimestamp?: string;
10321
+ /** [Output Only] The unique identifier for the resource. This identifier is defined by the server. */
10322
+ id?: string;
10323
+ /** [Output Only] The number of instances that are currently in use on this reservation subBlock. */
10324
+ inUseCount?: number;
10325
+ /** [Output Only] Type of the resource. Always compute#reservationSubBlock for reservation subBlocks. */
10326
+ kind?: string;
10327
+ /** [Output Only] The name of this reservation subBlock generated by Google Compute Engine. The name must be 1-63 characters long, and comply with RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? */
10328
+ name?: string;
10329
+ /** [Output Only] The physical topology of the reservation subBlock. */
10330
+ physicalTopology?: ReservationSubBlockPhysicalTopology;
10331
+ /** [Output Only] Server-defined fully-qualified URL for this resource. */
10332
+ selfLink?: string;
10333
+ /** [Output Only] Server-defined URL for this resource with the resource id. */
10334
+ selfLinkWithId?: string;
10335
+ /** [Output Only] Status of the reservation subBlock. */
10336
+ status?: string;
10337
+ /** [Output Only] Zone in which the reservation subBlock resides. */
10338
+ zone?: string;
10339
+ }
10340
+ interface ReservationSubBlockPhysicalTopology {
10341
+ /** The hash of the capacity block within the cluster. */
10342
+ block?: string;
10343
+ /** The cluster name of the reservation subBlock. */
10344
+ cluster?: string;
10345
+ /** The hash of the capacity sub-block within the capacity block. */
10346
+ subBlock?: string;
10347
+ }
10348
+ interface ReservationSubBlocksGetResponse {
10349
+ resource?: ReservationSubBlock;
10350
+ }
10351
+ interface ReservationSubBlocksListResponse {
10352
+ /** Unique identifier for the resource; defined by the server. */
10353
+ id?: string;
10354
+ /** A list of reservation subBlock resources. */
10355
+ items?: ReservationSubBlock[];
10356
+ /** Type of the resource. Always compute#reservationSubBlock for a list of reservation subBlocks. */
10357
+ kind?: string;
10358
+ /** This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. */
10359
+ nextPageToken?: string;
10360
+ /** Server-defined URL for this resource. */
10361
+ selfLink?: string;
10362
+ /** Informational warning message. */
10363
+ warning?: {
10364
+ /** [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. */
10365
+ code?: string;
10366
+ /** [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } */
10367
+ data?: Array<{
10368
+ /** [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding). */
10369
+ key?: string;
10370
+ /** [Output Only] A warning data value corresponding to the key. */
10371
+ value?: string;
10372
+ }>;
10373
+ /** [Output Only] A human-readable description of the warning code. */
10374
+ message?: string;
10375
+ };
10376
+ }
10130
10377
  interface ResourceCommitment {
10131
10378
  /** Name of the accelerator type or GPU resource. Specify this field only when the type of hardware resource is ACCELERATOR. */
10132
10379
  acceleratorType?: string;
@@ -10515,7 +10762,7 @@ declare namespace gapi.client {
10515
10762
  nextHopIlb?: string;
10516
10763
  /** The URL to an instance that should handle matching packets. You can specify this as a full or partial URL. For example: https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/ */
10517
10764
  nextHopInstance?: string;
10518
- /** [Output Only] The URL to an InterconnectAttachment which is the next hop for the route. This field will only be populated for the dynamic routes generated by Cloud Router with a linked interconnectAttachment. */
10765
+ /** [Output Only] The URL to an InterconnectAttachment which is the next hop for the route. This field will only be populated for dynamic routes generated by Cloud Router with a linked interconnectAttachment or the static route generated by each L2 Interconnect Attachment. */
10519
10766
  nextHopInterconnectAttachment?: string;
10520
10767
  /** [Output only] Internal fixed region-to-region cost that Google Cloud calculates based on factors such as network performance, distance, and available bandwidth between regions. */
10521
10768
  nextHopInterRegionCost?: number;
@@ -10531,6 +10778,8 @@ declare namespace gapi.client {
10531
10778
  nextHopPeering?: string;
10532
10779
  /** The URL to a VpnTunnel that should handle matching packets. */
10533
10780
  nextHopVpnTunnel?: string;
10781
+ /** Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. */
10782
+ params?: RouteParams;
10534
10783
  /** The priority of this route. Priority is used to break ties in cases where there is more than one matching route of equal prefix length. In cases where multiple routes have equal prefix length, the one with the lowest-numbered priority value wins. The default value is `1000`. The priority value must be from `0` to `65535`, inclusive. */
10535
10784
  priority?: number;
10536
10785
  /** [Output only] The status of the route. */
@@ -10590,6 +10839,10 @@ declare namespace gapi.client {
10590
10839
  message?: string;
10591
10840
  };
10592
10841
  }
10842
+ interface RouteParams {
10843
+ /** Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. */
10844
+ resourceManagerTags?: {[P in string]: string};
10845
+ }
10593
10846
  interface RoutePolicy {
10594
10847
  /** An optional description of route policy. */
10595
10848
  description?: string;
@@ -11196,7 +11449,7 @@ declare namespace gapi.client {
11196
11449
  preemptible?: boolean;
11197
11450
  /** Specifies the provisioning model of the instance. */
11198
11451
  provisioningModel?: string;
11199
- /** Timeout between GCE ACPI G2 Soft Off and ACPI G3 Mechanical Off during shutdown operation of VM. For Standard VMs values between 0s and 120s are allowed. For Spot and Preemptible VMs supported values are between 0s and 30s. If no value is specified for shutdownDuration, default values are 90s for Standard VMs and 30s for Spot/Preemptible VMs. */
11452
+ /** DEPRECATED: please use skipGuestOsShutdown. Timeout between GCE ACPI G2 Soft Off and ACPI G3 Mechanical Off during shutdown operation of VM. For Standard VMs values between 0s and 120s are allowed. For Spot and Preemptible VMs supported values are between 0s and 30s. If no value is specified for shutdownDuration, default values are 90s for Standard VMs and 30s for Spot/Preemptible VMs. */
11200
11453
  shutdownTimeout?: Duration;
11201
11454
  /** Specifies the timestamp, when the instance will be terminated, in RFC3339 text format. If specified, the instance termination action will be performed at the termination time. */
11202
11455
  terminationTime?: string;
@@ -11760,6 +12013,8 @@ declare namespace gapi.client {
11760
12013
  consumerNetwork?: string;
11761
12014
  /** The url of a connected endpoint. */
11762
12015
  endpoint?: string;
12016
+ /** NAT IPs of the connected PSC endpoint and those of other endpoints propagated from it. */
12017
+ natIps?: string[];
11763
12018
  /** The number of consumer Network Connectivity Center spokes that the connected Private Service Connect endpoint has propagated to. */
11764
12019
  propagatedConnectionCount?: number;
11765
12020
  /** The PSC connection id of the connected endpoint. */
@@ -12069,6 +12324,14 @@ declare namespace gapi.client {
12069
12324
  /** [Output Only] */
12070
12325
  status?: string;
12071
12326
  }
12327
+ interface SnapshotGroupParameters {
12328
+ /** URLs of the zones where disks should be replicated to. Only applicable for regional resources. */
12329
+ replicaZones?: string[];
12330
+ /** The source snapshot group used to create disks. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project /global/snapshotGroups/snapshotGroup - projects/project/global/snapshotGroups/snapshotGroup - global/snapshotGroups/snapshotGroup */
12331
+ sourceSnapshotGroup?: string;
12332
+ /** URL of the disk type resource describing which disk type to use to create disks. Provide this when creating the disk. For example: projects/project /zones/zone/diskTypes/pd-ssd . See Persistent disk types. */
12333
+ type?: string;
12334
+ }
12072
12335
  interface SnapshotGroupSourceInfo {
12073
12336
  consistencyGroup?: string;
12074
12337
  consistencyGroupId?: string;
@@ -12848,11 +13111,12 @@ declare namespace gapi.client {
12848
13111
  name?: string;
12849
13112
  /** The URL of the network to which this subnetwork belongs, provided by the client when initially creating the subnetwork. This field can be set only at resource creation time. */
12850
13113
  network?: string;
13114
+ /** Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. */
13115
+ params?: SubnetworkParams;
12851
13116
  /** Whether the VMs in this subnet can access Google services without assigned external IP addresses. This field can be both set at resource creation time and updated using setPrivateIpGoogleAccess. */
12852
13117
  privateIpGoogleAccess?: boolean;
12853
13118
  /** This field is for internal use. This field can be both set at resource creation time and updated using patch. */
12854
13119
  privateIpv6GoogleAccess?: string;
12855
- /** The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PEER_MIGRATION, PRIVATE_SERVICE_CONNECT or PRIVATE_NAT. PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. A subnet with purpose set to PEER_MIGRATION is used for subnet migration from one peered VPC to another. A subnet with purpose set to PRIVATE_NAT is used for Private NAT IP address by Private NAT Gateway. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. */
12856
13120
  purpose?: string;
12857
13121
  /** URL of the region where the Subnetwork resides. This field can be set only at resource creation time. */
12858
13122
  region?: string;
@@ -12870,6 +13134,8 @@ declare namespace gapi.client {
12870
13134
  stackType?: string;
12871
13135
  /** [Output Only] The state of the subnetwork, which can be one of the following values: READY: Subnetwork is created and ready to use DRAINING: only applicable to subnetworks that have the purpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that connections to the load balancer are being drained. A subnetwork that is draining cannot be used or modified until it reaches a status of READY */
12872
13136
  state?: string;
13137
+ /** Output only. [Output Only] The current IP utilization of all subnetwork ranges. Contains the total number of allocated and free IPs in each range. */
13138
+ utilizationDetails?: SubnetworkUtilizationDetails;
12873
13139
  /** A repeated field indicating the VLAN IDs supported on this subnetwork. During Subnet creation, specifying vlan is valid only if enable_l2 is true. During Subnet Update, specifying vlan is allowed only for l2 enabled subnets. Restricted to only one VLAN. */
12874
13140
  vlans?: number[];
12875
13141
  }
@@ -12941,6 +13207,10 @@ declare namespace gapi.client {
12941
13207
  /** Can only be specified if VPC flow logs for this subnetwork is enabled and "metadata" was set to CUSTOM_METADATA. */
12942
13208
  metadataFields?: string[];
12943
13209
  }
13210
+ interface SubnetworkParams {
13211
+ /** Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. */
13212
+ resourceManagerTags?: {[P in string]: string};
13213
+ }
12944
13214
  interface SubnetworkSecondaryRange {
12945
13215
  /** The range of IP addresses belonging to this subnetwork secondary range. Provide this property when you create the subnetwork. Ranges must be unique and non-overlapping with all primary and secondary IP ranges within a network. Only IPv4 is supported. The range can be any range listed in the Valid ranges list. */
12946
13216
  ipCidrRange?: string;
@@ -12992,6 +13262,26 @@ declare namespace gapi.client {
12992
13262
  interface SubnetworksSetPrivateIpGoogleAccessRequest {
12993
13263
  privateIpGoogleAccess?: boolean;
12994
13264
  }
13265
+ interface SubnetworkUtilizationDetails {
13266
+ /** Utilizations of external IPV6 IP range. */
13267
+ externalIpv6InstanceUtilization?: SubnetworkUtilizationDetailsIPV6Utilization;
13268
+ /** Utilizations of external IPV6 IP range for NetLB. */
13269
+ externalIpv6LbUtilization?: SubnetworkUtilizationDetailsIPV6Utilization;
13270
+ /** Utilizations of internal IPV6 IP range. */
13271
+ internalIpv6Utilization?: SubnetworkUtilizationDetailsIPV6Utilization;
13272
+ /** Utilizations of all IPV4 IP ranges. For primary ranges, the range name will be empty. */
13273
+ ipv4Utilizations?: SubnetworkUtilizationDetailsIPV4Utilization[];
13274
+ }
13275
+ interface SubnetworkUtilizationDetailsIPV4Utilization {
13276
+ /** Will be set for secondary range. Empty for primary IPv4 range. */
13277
+ rangeName?: string;
13278
+ totalAllocatedIp?: string;
13279
+ totalFreeIp?: string;
13280
+ }
13281
+ interface SubnetworkUtilizationDetailsIPV6Utilization {
13282
+ totalAllocatedIp?: Uint128;
13283
+ totalFreeIp?: Uint128;
13284
+ }
12995
13285
  interface Subsetting {
12996
13286
  policy?: string;
12997
13287
  /** The number of backends per backend group assigned to each proxy instance or each service mesh client. An input parameter to the `CONSISTENT_HASH_SUBSETTING` algorithm. Can only be set if `policy` is set to `CONSISTENT_HASH_SUBSETTING`. Can only be set if load balancing scheme is `INTERNAL_MANAGED` or `INTERNAL_SELF_MANAGED`. `subset_size` is optional for Internal HTTP(S) load balancing and required for Traffic Director. If you do not provide this value, Cloud Load Balancing will calculate it dynamically to optimize the number of proxies/clients visible to each backend and vice versa. Must be greater than 0. If `subset_size` is larger than the number of backends/endpoints, then subsetting is disabled. */
@@ -13864,6 +14154,10 @@ declare namespace gapi.client {
13864
14154
  date?: string;
13865
14155
  /** The latest time for the planned maintenance window to start. This timestamp value is in RFC3339 text format. */
13866
14156
  latestWindowStartTime?: string;
14157
+ /** Indicates whether the UpcomingMaintenance will be triggered on VM shutdown. */
14158
+ maintenanceOnShutdown?: boolean;
14159
+ /** The reasons for the maintenance. Only valid for vms. */
14160
+ maintenanceReasons?: string[];
13867
14161
  maintenanceStatus?: string;
13868
14162
  /** [Output Only] The start time window of the maintenance disruption. DEPRECATED: Use window_start_time instead. TimeWindow is a container for two strings that represent timestamps in "yyyy-MM-dd'T'HH:mm:ssZ" text format. */
13869
14163
  startTimeWindow?: UpcomingMaintenanceTimeWindow;
@@ -14051,7 +14345,6 @@ declare namespace gapi.client {
14051
14345
  ipv6AccessType?: string;
14052
14346
  /** Network URL. */
14053
14347
  network?: string;
14054
- /** The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PEER_MIGRATION, PRIVATE_SERVICE_CONNECT or PRIVATE_NAT. PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. A subnet with purpose set to PEER_MIGRATION is used for subnet migration from one peered VPC to another. A subnet with purpose set to PRIVATE_NAT is used for Private NAT IP address by Private NAT Gateway. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. */
14055
14348
  purpose?: string;
14056
14349
  /** The role of subnetwork. Currently, this field is only used when purpose is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being used for Envoy-based load balancers in a region. A BACKUP subnetwork is one that is ready to be promoted to ACTIVE or is currently draining. This field can be updated with a patch request. */
14057
14350
  role?: string;
@@ -32459,40 +32752,6 @@ declare namespace gapi.client {
32459
32752
  /** Legacy name for parameter that has been superseded by `quotaUser`. */
32460
32753
  userIp?: string;
32461
32754
  }): Request<InterconnectLocationList>;
32462
- /** Returns permissions that a caller has on the specified resource. */
32463
- testIamPermissions(
32464
- request: {
32465
- /** V1 error format. */
32466
- '$.xgafv'?: string;
32467
- /** OAuth access token. */
32468
- access_token?: string;
32469
- /** Data format for response. */
32470
- alt?: string;
32471
- /** JSONP */
32472
- callback?: string;
32473
- /** Selector specifying which fields to include in a partial response. */
32474
- fields?: string;
32475
- /** 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. */
32476
- key?: string;
32477
- /** OAuth 2.0 token for the current user. */
32478
- oauth_token?: string;
32479
- /** Returns response with indentations and line breaks. */
32480
- prettyPrint?: boolean;
32481
- /** Project ID for this request. */
32482
- project: string;
32483
- /** 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. */
32484
- quotaUser?: string;
32485
- /** Name or id of the resource for this request. */
32486
- resource: string;
32487
- /** Upload protocol for media (e.g. "raw", "multipart"). */
32488
- upload_protocol?: string;
32489
- /** Legacy upload protocol for media (e.g. "media", "multipart"). */
32490
- uploadType?: string;
32491
- /** Legacy name for parameter that has been superseded by `quotaUser`. */
32492
- userIp?: string;
32493
- },
32494
- body: TestPermissionsRequest,
32495
- ): Request<TestPermissionsResponse>;
32496
32755
  }
32497
32756
  interface InterconnectRemoteLocationsResource {
32498
32757
  /** Returns the details for the specified interconnect remote location. Gets a list of available interconnect remote locations by making a list() request. */
@@ -32565,40 +32824,6 @@ declare namespace gapi.client {
32565
32824
  /** Legacy name for parameter that has been superseded by `quotaUser`. */
32566
32825
  userIp?: string;
32567
32826
  }): Request<InterconnectRemoteLocationList>;
32568
- /** Returns permissions that a caller has on the specified resource. */
32569
- testIamPermissions(
32570
- request: {
32571
- /** V1 error format. */
32572
- '$.xgafv'?: string;
32573
- /** OAuth access token. */
32574
- access_token?: string;
32575
- /** Data format for response. */
32576
- alt?: string;
32577
- /** JSONP */
32578
- callback?: string;
32579
- /** Selector specifying which fields to include in a partial response. */
32580
- fields?: string;
32581
- /** 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. */
32582
- key?: string;
32583
- /** OAuth 2.0 token for the current user. */
32584
- oauth_token?: string;
32585
- /** Returns response with indentations and line breaks. */
32586
- prettyPrint?: boolean;
32587
- /** Project ID for this request. */
32588
- project: string;
32589
- /** 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. */
32590
- quotaUser?: string;
32591
- /** Name or id of the resource for this request. */
32592
- resource: string;
32593
- /** Upload protocol for media (e.g. "raw", "multipart"). */
32594
- upload_protocol?: string;
32595
- /** Legacy upload protocol for media (e.g. "media", "multipart"). */
32596
- uploadType?: string;
32597
- /** Legacy name for parameter that has been superseded by `quotaUser`. */
32598
- userIp?: string;
32599
- },
32600
- body: TestPermissionsRequest,
32601
- ): Request<TestPermissionsResponse>;
32602
32827
  }
32603
32828
  interface InterconnectsResource {
32604
32829
  /** Deletes the specified Interconnect. */
@@ -36817,6 +37042,76 @@ declare namespace gapi.client {
36817
37042
  },
36818
37043
  body: NetworksRemovePeeringRequest,
36819
37044
  ): Request<Operation>;
37045
+ /** Requests to remove a peering from the specified network. Applicable only for PeeringConnection with update_strategy=CONSENSUS. */
37046
+ requestRemovePeering(request: {
37047
+ /** V1 error format. */
37048
+ '$.xgafv'?: string;
37049
+ /** OAuth access token. */
37050
+ access_token?: string;
37051
+ /** Data format for response. */
37052
+ alt?: string;
37053
+ /** JSONP */
37054
+ callback?: string;
37055
+ /** Selector specifying which fields to include in a partial response. */
37056
+ fields?: string;
37057
+ /** 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. */
37058
+ key?: string;
37059
+ /** Name of the network resource to remove peering from. */
37060
+ network: string;
37061
+ /** OAuth 2.0 token for the current user. */
37062
+ oauth_token?: string;
37063
+ /** Returns response with indentations and line breaks. */
37064
+ prettyPrint?: boolean;
37065
+ /** Project ID for this request. */
37066
+ project: string;
37067
+ /** 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. */
37068
+ quotaUser?: string;
37069
+ /** 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). */
37070
+ requestId?: string;
37071
+ /** Upload protocol for media (e.g. "raw", "multipart"). */
37072
+ upload_protocol?: string;
37073
+ /** Legacy upload protocol for media (e.g. "media", "multipart"). */
37074
+ uploadType?: string;
37075
+ /** Legacy name for parameter that has been superseded by `quotaUser`. */
37076
+ userIp?: string;
37077
+ /** Request body */
37078
+ resource: NetworksRequestRemovePeeringRequest;
37079
+ }): Request<Operation>;
37080
+ requestRemovePeering(
37081
+ request: {
37082
+ /** V1 error format. */
37083
+ '$.xgafv'?: string;
37084
+ /** OAuth access token. */
37085
+ access_token?: string;
37086
+ /** Data format for response. */
37087
+ alt?: string;
37088
+ /** JSONP */
37089
+ callback?: string;
37090
+ /** Selector specifying which fields to include in a partial response. */
37091
+ fields?: string;
37092
+ /** 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. */
37093
+ key?: string;
37094
+ /** Name of the network resource to remove peering from. */
37095
+ network: string;
37096
+ /** OAuth 2.0 token for the current user. */
37097
+ oauth_token?: string;
37098
+ /** Returns response with indentations and line breaks. */
37099
+ prettyPrint?: boolean;
37100
+ /** Project ID for this request. */
37101
+ project: string;
37102
+ /** 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. */
37103
+ quotaUser?: string;
37104
+ /** 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). */
37105
+ requestId?: string;
37106
+ /** Upload protocol for media (e.g. "raw", "multipart"). */
37107
+ upload_protocol?: string;
37108
+ /** Legacy upload protocol for media (e.g. "media", "multipart"). */
37109
+ uploadType?: string;
37110
+ /** Legacy name for parameter that has been superseded by `quotaUser`. */
37111
+ userIp?: string;
37112
+ },
37113
+ body: NetworksRequestRemovePeeringRequest,
37114
+ ): Request<Operation>;
36820
37115
  /** Switches the network mode from auto subnet mode to custom subnet mode. */
36821
37116
  switchToCustomMode(request?: {
36822
37117
  /** V1 error format. */
@@ -39262,6 +39557,148 @@ declare namespace gapi.client {
39262
39557
  body: TestPermissionsRequest,
39263
39558
  ): Request<TestPermissionsResponse>;
39264
39559
  }
39560
+ interface PreviewFeaturesResource {
39561
+ /** Returns the details of the given PreviewFeature. */
39562
+ get(request?: {
39563
+ /** V1 error format. */
39564
+ '$.xgafv'?: string;
39565
+ /** OAuth access token. */
39566
+ access_token?: string;
39567
+ /** Data format for response. */
39568
+ alt?: string;
39569
+ /** JSONP */
39570
+ callback?: string;
39571
+ /** Selector specifying which fields to include in a partial response. */
39572
+ fields?: string;
39573
+ /** 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. */
39574
+ key?: string;
39575
+ /** OAuth 2.0 token for the current user. */
39576
+ oauth_token?: string;
39577
+ /** Returns response with indentations and line breaks. */
39578
+ prettyPrint?: boolean;
39579
+ /** Project ID for this request. */
39580
+ project: string;
39581
+ /** 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. */
39582
+ quotaUser?: string;
39583
+ /** Name of the PreviewFeature for this request. */
39584
+ resourceId: string;
39585
+ /** Upload protocol for media (e.g. "raw", "multipart"). */
39586
+ upload_protocol?: string;
39587
+ /** Legacy upload protocol for media (e.g. "media", "multipart"). */
39588
+ uploadType?: string;
39589
+ /** Legacy name for parameter that has been superseded by `quotaUser`. */
39590
+ userIp?: string;
39591
+ }): Request<PreviewFeature>;
39592
+ /** Returns the details of the given PreviewFeature. */
39593
+ list(request?: {
39594
+ /** V1 error format. */
39595
+ '$.xgafv'?: string;
39596
+ /** OAuth access token. */
39597
+ access_token?: string;
39598
+ /** Data format for response. */
39599
+ alt?: string;
39600
+ /** JSONP */
39601
+ callback?: string;
39602
+ /** Selector specifying which fields to include in a partial response. */
39603
+ fields?: string;
39604
+ /** A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. */
39605
+ filter?: string;
39606
+ /** 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. */
39607
+ key?: string;
39608
+ /** The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) */
39609
+ maxResults?: number;
39610
+ /** OAuth 2.0 token for the current user. */
39611
+ oauth_token?: string;
39612
+ /** Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. */
39613
+ orderBy?: string;
39614
+ /** Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. */
39615
+ pageToken?: string;
39616
+ /** Returns response with indentations and line breaks. */
39617
+ prettyPrint?: boolean;
39618
+ /** Project ID for this request. */
39619
+ project: string;
39620
+ /** 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. */
39621
+ quotaUser?: string;
39622
+ /** 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. */
39623
+ returnPartialSuccess?: boolean;
39624
+ /** Upload protocol for media (e.g. "raw", "multipart"). */
39625
+ upload_protocol?: string;
39626
+ /** Legacy upload protocol for media (e.g. "media", "multipart"). */
39627
+ uploadType?: string;
39628
+ /** Legacy name for parameter that has been superseded by `quotaUser`. */
39629
+ userIp?: string;
39630
+ }): Request<PreviewFeatureList>;
39631
+ /** Patches the given PreviewFeature. This method is used to enable or disable a PreviewFeature. */
39632
+ update(request: {
39633
+ /** V1 error format. */
39634
+ '$.xgafv'?: string;
39635
+ /** OAuth access token. */
39636
+ access_token?: string;
39637
+ /** Data format for response. */
39638
+ alt?: string;
39639
+ /** JSONP */
39640
+ callback?: string;
39641
+ /** Selector specifying which fields to include in a partial response. */
39642
+ fields?: string;
39643
+ /** 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. */
39644
+ key?: string;
39645
+ /** OAuth 2.0 token for the current user. */
39646
+ oauth_token?: string;
39647
+ /** Returns response with indentations and line breaks. */
39648
+ prettyPrint?: boolean;
39649
+ /** Project ID for this request. */
39650
+ project: string;
39651
+ /** 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. */
39652
+ quotaUser?: string;
39653
+ /** 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). */
39654
+ requestId?: string;
39655
+ /** Name of the PreviewFeature for this request. */
39656
+ resourceId: string;
39657
+ /** Upload protocol for media (e.g. "raw", "multipart"). */
39658
+ upload_protocol?: string;
39659
+ /** Legacy upload protocol for media (e.g. "media", "multipart"). */
39660
+ uploadType?: string;
39661
+ /** Legacy name for parameter that has been superseded by `quotaUser`. */
39662
+ userIp?: string;
39663
+ /** Request body */
39664
+ resource: PreviewFeature;
39665
+ }): Request<Operation>;
39666
+ update(
39667
+ request: {
39668
+ /** V1 error format. */
39669
+ '$.xgafv'?: string;
39670
+ /** OAuth access token. */
39671
+ access_token?: string;
39672
+ /** Data format for response. */
39673
+ alt?: string;
39674
+ /** JSONP */
39675
+ callback?: string;
39676
+ /** Selector specifying which fields to include in a partial response. */
39677
+ fields?: string;
39678
+ /** 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. */
39679
+ key?: string;
39680
+ /** OAuth 2.0 token for the current user. */
39681
+ oauth_token?: string;
39682
+ /** Returns response with indentations and line breaks. */
39683
+ prettyPrint?: boolean;
39684
+ /** Project ID for this request. */
39685
+ project: string;
39686
+ /** 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. */
39687
+ quotaUser?: string;
39688
+ /** 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). */
39689
+ requestId?: string;
39690
+ /** Name of the PreviewFeature for this request. */
39691
+ resourceId: string;
39692
+ /** Upload protocol for media (e.g. "raw", "multipart"). */
39693
+ upload_protocol?: string;
39694
+ /** Legacy upload protocol for media (e.g. "media", "multipart"). */
39695
+ uploadType?: string;
39696
+ /** Legacy name for parameter that has been superseded by `quotaUser`. */
39697
+ userIp?: string;
39698
+ },
39699
+ body: PreviewFeature,
39700
+ ): Request<Operation>;
39701
+ }
39265
39702
  interface ProjectsResource {
39266
39703
  /** Disable this project as a shared VPC host project. */
39267
39704
  disableXpnHost(request?: {
@@ -54064,6 +54501,86 @@ declare namespace gapi.client {
54064
54501
  body: Reservation,
54065
54502
  ): Request<Operation>;
54066
54503
  }
54504
+ interface ReservationSubBlocksResource {
54505
+ /** Retrieves information about the specified reservation subBlock. */
54506
+ get(request?: {
54507
+ /** V1 error format. */
54508
+ '$.xgafv'?: string;
54509
+ /** OAuth access token. */
54510
+ access_token?: string;
54511
+ /** Data format for response. */
54512
+ alt?: string;
54513
+ /** JSONP */
54514
+ callback?: string;
54515
+ /** Selector specifying which fields to include in a partial response. */
54516
+ fields?: string;
54517
+ /** 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. */
54518
+ key?: string;
54519
+ /** OAuth 2.0 token for the current user. */
54520
+ oauth_token?: string;
54521
+ /** The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} */
54522
+ parentName: string;
54523
+ /** Returns response with indentations and line breaks. */
54524
+ prettyPrint?: boolean;
54525
+ /** Project ID for this request. */
54526
+ project: string;
54527
+ /** 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. */
54528
+ quotaUser?: string;
54529
+ /** The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. */
54530
+ reservationSubBlock: string;
54531
+ /** Upload protocol for media (e.g. "raw", "multipart"). */
54532
+ upload_protocol?: string;
54533
+ /** Legacy upload protocol for media (e.g. "media", "multipart"). */
54534
+ uploadType?: string;
54535
+ /** Legacy name for parameter that has been superseded by `quotaUser`. */
54536
+ userIp?: string;
54537
+ /** Name of the zone for this request. Zone name should conform to RFC1035. */
54538
+ zone: string;
54539
+ }): Request<ReservationSubBlocksGetResponse>;
54540
+ /** Retrieves a list of reservation subBlocks under a single reservation. */
54541
+ list(request?: {
54542
+ /** V1 error format. */
54543
+ '$.xgafv'?: string;
54544
+ /** OAuth access token. */
54545
+ access_token?: string;
54546
+ /** Data format for response. */
54547
+ alt?: string;
54548
+ /** JSONP */
54549
+ callback?: string;
54550
+ /** Selector specifying which fields to include in a partial response. */
54551
+ fields?: string;
54552
+ /** A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. */
54553
+ filter?: string;
54554
+ /** 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. */
54555
+ key?: string;
54556
+ /** The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) */
54557
+ maxResults?: number;
54558
+ /** OAuth 2.0 token for the current user. */
54559
+ oauth_token?: string;
54560
+ /** Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. */
54561
+ orderBy?: string;
54562
+ /** Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. */
54563
+ pageToken?: string;
54564
+ /** The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} */
54565
+ parentName: string;
54566
+ /** Returns response with indentations and line breaks. */
54567
+ prettyPrint?: boolean;
54568
+ /** Project ID for this request. */
54569
+ project: string;
54570
+ /** 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. */
54571
+ quotaUser?: string;
54572
+ /** 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. */
54573
+ returnPartialSuccess?: boolean;
54574
+ /** Upload protocol for media (e.g. "raw", "multipart"). */
54575
+ upload_protocol?: string;
54576
+ /** Legacy upload protocol for media (e.g. "media", "multipart"). */
54577
+ uploadType?: string;
54578
+ /** Legacy name for parameter that has been superseded by `quotaUser`. */
54579
+ userIp?: string;
54580
+ /** Name of the zone for this request. Zone name should conform to RFC1035. */
54581
+ zone: string;
54582
+ }): Request<ReservationSubBlocksListResponse>;
54583
+ }
54067
54584
  interface ResourcePoliciesResource {
54068
54585
  /** Retrieves an aggregated list of resource policies. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. */
54069
54586
  aggregatedList(request?: {
@@ -56570,6 +57087,8 @@ declare namespace gapi.client {
56570
57087
  region: string;
56571
57088
  /** Name of the ServiceAttachment resource to return. */
56572
57089
  serviceAttachment: string;
57090
+ /** Indicates whether NAT IPs should be included in the response. */
57091
+ showNatIps?: boolean;
56573
57092
  /** Upload protocol for media (e.g. "raw", "multipart"). */
56574
57093
  upload_protocol?: string;
56575
57094
  /** Legacy upload protocol for media (e.g. "media", "multipart"). */
@@ -58991,6 +59510,8 @@ declare namespace gapi.client {
58991
59510
  uploadType?: string;
58992
59511
  /** Legacy name for parameter that has been superseded by `quotaUser`. */
58993
59512
  userIp?: string;
59513
+ /** Defines the extra views returned back in the subnetwork resource. Supported values: - WITH_UTILIZATION: Utilization data is included in the response. */
59514
+ views?: string | string[];
58994
59515
  }): Request<Subnetwork>;
58995
59516
  /** Gets the access control policy for a resource. May be empty if no such policy or resource exists. */
58996
59517
  getIamPolicy(request?: {
@@ -59137,6 +59658,8 @@ declare namespace gapi.client {
59137
59658
  uploadType?: string;
59138
59659
  /** Legacy name for parameter that has been superseded by `quotaUser`. */
59139
59660
  userIp?: string;
59661
+ /** Defines the extra views returned back in the subnetwork resource. Supported values: - WITH_UTILIZATION: Utilization data is included in the response. */
59662
+ views?: string | string[];
59140
59663
  }): Request<SubnetworkList>;
59141
59664
  /** Retrieves an aggregated list of all usable subnetworks in the project. */
59142
59665
  listUsable(request?: {
@@ -65085,6 +65608,8 @@ declare namespace gapi.client {
65085
65608
 
65086
65609
  const packetMirrorings: PacketMirroringsResource;
65087
65610
 
65611
+ const previewFeatures: PreviewFeaturesResource;
65612
+
65088
65613
  const projects: ProjectsResource;
65089
65614
 
65090
65615
  const publicAdvertisedPrefixes: PublicAdvertisedPrefixesResource;
@@ -65165,6 +65690,8 @@ declare namespace gapi.client {
65165
65690
 
65166
65691
  const reservationBlocks: ReservationBlocksResource;
65167
65692
 
65693
+ const reservationSubBlocks: ReservationSubBlocksResource;
65694
+
65168
65695
  const reservations: ReservationsResource;
65169
65696
 
65170
65697
  const resourcePolicies: ResourcePoliciesResource;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@maxim_mazurok/gapi.client.compute-alpha",
3
- "version": "0.0.20250320",
3
+ "version": "0.0.20250415",
4
4
  "description": "TypeScript typings for Compute Engine API alpha",
5
5
  "repository": {
6
6
  "type": "git",
package/readme.md CHANGED
@@ -1880,11 +1880,6 @@ Retrieves the list of interconnect locations available to the specified project.
1880
1880
  */
1881
1881
  await gapi.client.compute.interconnectLocations.list({ project: "project", });
1882
1882
 
1883
- /*
1884
- Returns permissions that a caller has on the specified resource.
1885
- */
1886
- await gapi.client.compute.interconnectLocations.testIamPermissions({ project: "project", resource: "resource", });
1887
-
1888
1883
  /*
1889
1884
  Returns the details for the specified interconnect remote location. Gets a list of available interconnect remote locations by making a list() request.
1890
1885
  */
@@ -1895,11 +1890,6 @@ Retrieves the list of interconnect remote locations available to the specified p
1895
1890
  */
1896
1891
  await gapi.client.compute.interconnectRemoteLocations.list({ project: "project", });
1897
1892
 
1898
- /*
1899
- Returns permissions that a caller has on the specified resource.
1900
- */
1901
- await gapi.client.compute.interconnectRemoteLocations.testIamPermissions({ project: "project", resource: "resource", });
1902
-
1903
1893
  /*
1904
1894
  Deletes the specified Interconnect.
1905
1895
  */
@@ -2360,6 +2350,11 @@ Removes a peering from the specified network.
2360
2350
  */
2361
2351
  await gapi.client.compute.networks.removePeering({ network: "network", project: "project", });
2362
2352
 
2353
+ /*
2354
+ Requests to remove a peering from the specified network. Applicable only for PeeringConnection with update_strategy=CONSENSUS.
2355
+ */
2356
+ await gapi.client.compute.networks.requestRemovePeering({ network: "network", project: "project", });
2357
+
2363
2358
  /*
2364
2359
  Switches the network mode from auto subnet mode to custom subnet mode.
2365
2360
  */
@@ -2620,6 +2615,21 @@ Returns permissions that a caller has on the specified resource.
2620
2615
  */
2621
2616
  await gapi.client.compute.packetMirrorings.testIamPermissions({ project: "project", region: "region", resource: "resource", });
2622
2617
 
2618
+ /*
2619
+ Returns the details of the given PreviewFeature.
2620
+ */
2621
+ await gapi.client.compute.previewFeatures.get({ project: "project", resourceId: "resourceId", });
2622
+
2623
+ /*
2624
+ Returns the details of the given PreviewFeature.
2625
+ */
2626
+ await gapi.client.compute.previewFeatures.list({ project: "project", });
2627
+
2628
+ /*
2629
+ Patches the given PreviewFeature. This method is used to enable or disable a PreviewFeature.
2630
+ */
2631
+ await gapi.client.compute.previewFeatures.update({ project: "project", resourceId: "resourceId", });
2632
+
2623
2633
  /*
2624
2634
  Disable this project as a shared VPC host project.
2625
2635
  */
@@ -4085,6 +4095,16 @@ Update share settings of the reservation.
4085
4095
  */
4086
4096
  await gapi.client.compute.reservations.update({ project: "project", reservation: "reservation", zone: "zone", });
4087
4097
 
4098
+ /*
4099
+ Retrieves information about the specified reservation subBlock.
4100
+ */
4101
+ await gapi.client.compute.reservationSubBlocks.get({ parentName: "parentName", project: "project", reservationSubBlock: "reservationSubBlock", zone: "zone", });
4102
+
4103
+ /*
4104
+ Retrieves a list of reservation subBlocks under a single reservation.
4105
+ */
4106
+ await gapi.client.compute.reservationSubBlocks.list({ parentName: "parentName", project: "project", zone: "zone", });
4107
+
4088
4108
  /*
4089
4109
  Retrieves an aggregated list of resource policies. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`.
4090
4110
  */