RubyGems - google-api-client - Versions diffs - 0.36.0 → 0.37.0 - Mend

google-api-client 0.36.0 → 0.37.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (560) hide show

data/generated/google/apis/compute_alpha/classes.rb CHANGED Viewed

@@ -56,8 +56,7 @@ module Google
       # Google Cloud Platform provides graphics processing units (accelerators) that
       # you can add to VM instances to improve or accelerate performance when working
       # with intensive workloads. For more information, read GPUs on Compute Engine. (=
-      # = resource_for beta.acceleratorTypes ==) (== resource_for v1.acceleratorTypes =
-      # =)
+      # = resource_for `$api_version`.acceleratorTypes ==)
       class AcceleratorType
         include Google::Apis::Core::Hashable
@@ -510,7 +509,7 @@ module Google
         # @return [String]
         attr_accessor :public_ptr_domain_name
-        # Specifies whether a public DNS ?A? record should be created for the external
+        # Specifies whether a public DNS 'A' record should be created for the external
         # IP address of this access configuration.
         # Corresponds to the JSON property `setPublicDns`
         # @return [Boolean]
@@ -547,21 +546,22 @@ module Google
         end
       end
-      # Represents an IP Address resource.
-      # An address resource represents a regional internal IP address. Regional
-      # internal IP addresses are RFC 1918 addresses that come from either a primary
-      # or secondary IP range of a subnet in a VPC network. Regional external IP
-      # addresses can be assigned to GCP VM instances, Cloud VPN gateways, regional
-      # external forwarding rules for network load balancers (in either Standard or
-      # Premium Tier), and regional external forwarding rules for HTTP(S), SSL Proxy,
-      # and TCP Proxy load balancers in Standard Tier. For more information, read IP
-      # addresses.
-      # A globalAddresses resource represent a global external IP address. Global
-      # external IP addresses are IPv4 or IPv6 addresses. They can only be assigned to
-      # global forwarding rules for HTTP(S), SSL Proxy, or TCP Proxy load balancers in
-      # Premium Tier. For more information, read Global resources. (== resource_for
-      # beta.addresses ==) (== resource_for v1.addresses ==) (== resource_for beta.
-      # globalAddresses ==) (== resource_for v1.globalAddresses ==)
+      # Use global external addresses for GFE-based external HTTP(S) load balancers in
+      # Premium Tier.
+      # Use global internal addresses for reserved peering network range.
+      # Use regional external addresses for the following resources:
+      # - External IP addresses for VM instances - Regional external forwarding rules -
+      # Cloud NAT external IP addresses - GFE based LBs in Standard Tier - Network
+      # LBs in Premium or Standard Tier - Cloud VPN gateways (both Classic and HA)
+      # Use regional internal IP addresses for subnet IP ranges (primary and secondary)
+      # . This includes:
+      # - Internal IP addresses for VM instances - Alias IP ranges of VM instances (/
+      # 32 only) - Regional internal forwarding rules - Internal TCP/UDP load balancer
+      # addresses - Internal HTTP(S) load balancer addresses - Cloud DNS inbound
+      # forwarding IP addresses
+      # For more information, read reserved IP address.
+      # (== resource_for `$api_version`.addresses ==) (== resource_for `$api_version`.
+      # globalAddresses ==)
       class Address
         include Google::Apis::Core::Hashable
@@ -1222,8 +1222,7 @@ module Google
         # @return [Google::Apis::ComputeAlpha::CustomerEncryptionKey]
         attr_accessor :disk_encryption_key
-        # The size of the disk in base-2 GB. This supersedes disk_size_gb in
-        # InitializeParams.
+        # The size of the disk in GB.
         # Corresponds to the JSON property `diskSizeGb`
         # @return [Fixnum]
         attr_accessor :disk_size_gb
@@ -1355,9 +1354,10 @@ module Google
         # @return [String]
         attr_accessor :disk_name
-        # Specifies the size of the disk in base-2 GB. If not specified, the disk will
-        # be the same size as the image (usually 10GB). If specified, the size must be
-        # equal to or larger than 10GB.
+        # Specifies the size of the disk in base-2 GB. The size must be at least 10 GB.
+        # If you specify a sourceImage, which is required for boot disks, the default
+        # size is the size of the sourceImage. If you do not specify a sourceImage, the
+        # default disk size is 500 GB.
         # Corresponds to the JSON property `diskSizeGb`
         # @return [Fixnum]
         attr_accessor :disk_size_gb
@@ -1653,14 +1653,16 @@ module Google
       end
       # Represents an Autoscaler resource.
+      # Google Compute Engine has two Autoscaler resources:
+      # * [Global](/compute/docs/reference/rest/latest/autoscalers) * [Regional](/
+      # compute/docs/reference/rest/latest/regionAutoscalers)
       # Use autoscalers to automatically add or delete instances from a managed
       # instance group according to your defined autoscaling policy. For more
       # information, read Autoscaling Groups of Instances.
       # For zonal managed instance groups resource, use the autoscaler resource.
       # For regional managed instance groups, use the regionAutoscalers resource. (==
-      # resource_for beta.autoscalers ==) (== resource_for v1.autoscalers ==) (==
-      # resource_for beta.regionAutoscalers ==) (== resource_for v1.regionAutoscalers =
-      # =)
+      # resource_for `$api_version`.autoscalers ==) (== resource_for `$api_version`.
+      # regionAutoscalers ==)
       class Autoscaler
         include Google::Apis::Core::Hashable
@@ -1727,12 +1729,13 @@ module Google
         attr_accessor :self_link_with_id
         # [Output Only] The status of the autoscaler configuration. Current set of
-        # possible values: PENDING: Autoscaler backend hasn't read new/updated
-        # configuration DELETING: Configuration is being deleted ACTIVE: Configuration
-        # is acknowledged to be effective. Some warnings might or might not be present
-        # in the status_details field. ERROR: Configuration has errors. Actionable for
-        # users. Details are present in the status_details field. New values might be
-        # added in the future.
+        # possible values:
+        # - PENDING: Autoscaler backend hasn't read new/updated configuration.
+        # - DELETING: Configuration is being deleted.
+        # - ACTIVE: Configuration is acknowledged to be effective. Some warnings might
+        # be present in the statusDetails field.
+        # - ERROR: Configuration has errors. Actionable for users. Details are present
+        # in the statusDetails field.  New values might be added in the future.
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -2023,38 +2026,45 @@ module Google
         # @return [String]
         attr_accessor :message
-        # The type of error, warning or notice returned. Current set of possible values:
-        # ALL_INSTANCES_UNHEALTHY (WARNING): All instances in the instance group are
-        # unhealthy (not in RUNNING state). BACKEND_SERVICE_DOES_NOT_EXIST (ERROR):
-        # There is no backend service attached to the instance group.
-        # CAPPED_AT_MAX_NUM_REPLICAS (WARNING): Autoscaler recommends size bigger than
-        # maxNumReplicas. CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): The custom
-        # metric samples are not exported often enough to be a credible base for
-        # autoscaling. CUSTOM_METRIC_INVALID (ERROR): The custom metric that was
-        # specified does not exist or does not have the necessary labels. MIN_EQUALS_MAX
-        # (WARNING): The minNumReplicas is equal to maxNumReplicas. This means the
-        # autoscaler cannot add or remove instances from the instance group.
-        # MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): The autoscaler did not receive
+        # The type of error, warning, or notice returned. Current set of possible values:
+        #
+        # - ALL_INSTANCES_UNHEALTHY (WARNING): All instances in the instance group are
+        # unhealthy (not in RUNNING state).
+        # - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): There is no backend service attached
+        # to the instance group.
+        # - CAPPED_AT_MAX_NUM_REPLICAS (WARNING): Autoscaler recommends a size greater
+        # than maxNumReplicas.
+        # - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): The custom metric samples
+        # are not exported often enough to be a credible base for autoscaling.
+        # - CUSTOM_METRIC_INVALID (ERROR): The custom metric that was specified does not
+        # exist or does not have the necessary labels.
+        # - MIN_EQUALS_MAX (WARNING): The minNumReplicas is equal to maxNumReplicas.
+        # This means the autoscaler cannot add or remove instances from the instance
+        # group.
+        # - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): The autoscaler did not receive
         # any data from the custom metric configured for autoscaling.
-        # MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): The autoscaler is configured to
-        # scale based on a load balancing signal but the instance group has not received
-        # any requests from the load balancer. MODE_OFF (WARNING): Autoscaling is turned
-        # off. The number of instances in the group won't change automatically. The
-        # autoscaling configuration is preserved. MODE_ONLY_UP (WARNING): Autoscaling is
-        # in the "Autoscale only up" mode. Instances in the group will be only added.
-        # MORE_THAN_ONE_BACKEND_SERVICE (ERROR): The instance group cannot be autoscaled
-        # because it has more than one backend service attached to it.
-        # NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): Exceeded quota for necessary resources,
-        # such as CPU, number of instances and so on. REGION_RESOURCE_STOCKOUT (ERROR):
-        # Showed only for regional autoscalers: there is a resource stockout in the
-        # chosen region. SCALING_TARGET_DOES_NOT_EXIST (ERROR): The target to be scaled
-        # does not exist. UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION (ERROR):
-        # Autoscaling does not work with an HTTP/S load balancer that has been
-        # configured for maxRate. ZONE_RESOURCE_STOCKOUT (ERROR): For zonal autoscalers:
-        # there is a resource stockout in the chosen zone. For regional autoscalers: in
-        # at least one of the zones you're using there is a resource stockout. New
-        # values might be added in the future. Some of the values might not be available
-        # in all API versions.
+        # - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): The autoscaler is configured
+        # to scale based on a load balancing signal but the instance group has not
+        # received any requests from the load balancer.
+        # - MODE_OFF (WARNING): Autoscaling is turned off. The number of instances in
+        # the group won't change automatically. The autoscaling configuration is
+        # preserved.
+        # - MODE_ONLY_UP (WARNING): Autoscaling is in the "Autoscale only up" mode. The
+        # autoscaler can add instances but not remove any.
+        # - MORE_THAN_ONE_BACKEND_SERVICE (ERROR): The instance group cannot be
+        # autoscaled because it has more than one backend service attached to it.
+        # - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): There is insufficient quota for the
+        # necessary resources, such as CPU or number of instances.
+        # - REGION_RESOURCE_STOCKOUT (ERROR): Shown only for regional autoscalers: there
+        # is a resource stockout in the chosen region.
+        # - SCALING_TARGET_DOES_NOT_EXIST (ERROR): The target to be scaled does not
+        # exist.
+        # - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION (ERROR): Autoscaling does
+        # not work with an HTTP/S load balancer that has been configured for maxRate.
+        # - ZONE_RESOURCE_STOCKOUT (ERROR): For zonal autoscalers: there is a resource
+        # stockout in the chosen zone. For regional autoscalers: in at least one of the
+        # zones you're using there is a resource stockout.  New values might be added in
+        # the future. Some of the values might not be available in all API versions.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -2454,6 +2464,40 @@ module Google
         # @return [Google::Apis::ComputeAlpha::FixedOrPercent]
         attr_accessor :max_scaled_down_replicas
+        # A Duration represents a signed, fixed-length span of time represented as a
+        # count of seconds and fractions of seconds at nanosecond resolution. It is
+        # independent of any calendar and concepts like "day" or "month". It is related
+        # to Timestamp in that the difference between two Timestamp values is a Duration
+        # and it can be added or subtracted from a Timestamp. Range is approximately +-
+        # 10,000 years.
+        # # Examples
+        # Example 1: Compute Duration from two Timestamps in pseudo code.
+        # Timestamp start = ...; Timestamp end = ...; Duration duration = ...;
+        # duration.seconds = end.seconds - start.seconds; duration.nanos = end.nanos -
+        # start.nanos;
+        # if (duration.seconds  0) ` duration.seconds += 1; duration.nanos -= 1000000000;
+        # ` else if (duration.seconds > 0 && duration.nanos < 0) ` duration.seconds -=
+        # 1; duration.nanos += 1000000000; `
+        # Example 2: Compute Timestamp from Timestamp + Duration in pseudo code.
+        # Timestamp start = ...; Duration duration = ...; Timestamp end = ...;
+        # end.seconds = start.seconds + duration.seconds; end.nanos = start.nanos +
+        # duration.nanos;
+        # if (end.nanos = 1000000000) ` end.seconds += 1; end.nanos -= 1000000000; `
+        # Example 3: Compute Duration from datetime.timedelta in Python.
+        # td = datetime.timedelta(days=3, minutes=10) duration = Duration() duration.
+        # FromTimedelta(td)
+        # # JSON Mapping
+        # In JSON format, the Duration type is encoded as a string rather than an object,
+        # where the string ends in the suffix "s" (indicating seconds) and is preceded
+        # by the number of seconds, with nanoseconds expressed as fractional seconds.
+        # For example, 3 seconds with 0 nanoseconds should be encoded in JSON format as "
+        # 3s", while 3 seconds and 1 nanosecond should be expressed in JSON format as "3.
+        # 000000001s", and 3 seconds and 1 microsecond should be expressed in JSON
+        # format as "3.000001s".
+        # Corresponds to the JSON property `timeWindow`
+        # @return [Google::Apis::ComputeAlpha::GoogleDuration]
+        attr_accessor :time_window
         # How long back autoscaling should look when computing recommendations to
         # include directives regarding slower scale down, as described above.
         # Corresponds to the JSON property `timeWindowSec`
@@ -2467,6 +2511,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @max_scaled_down_replicas = args[:max_scaled_down_replicas] if args.key?(:max_scaled_down_replicas)
+          @time_window = args[:time_window] if args.key?(:time_window)
           @time_window_sec = args[:time_window_sec] if args.key?(:time_window_sec)
         end
       end
@@ -2882,8 +2927,12 @@ module Google
       # Represents a Backend Service resource.
       # A backend service contains configuration values for Google Cloud Platform load
       # balancing services.
+      # Backend services in Google Compute Engine can be either regionally or globally
+      # scoped.
+      # * [Global](/compute/docs/reference/rest/latest/backendServices) * [Regional](/
+      # compute/docs/reference/rest/latest/regionBackendServices)
       # For more information, read Backend Services.
-      # (== resource_for v1.backendService ==) (== resource_for beta.backendService ==)
+      # (== resource_for `$api_version`.backendService ==)
       class BackendService
         include Google::Apis::Core::Hashable
@@ -2961,9 +3010,11 @@ module Google
         # The list of URLs to the HttpHealthCheck or HttpsHealthCheck resource for
         # health checking this BackendService. Currently at most one health check can be
-        # specified, and a health check is required for Compute Engine backend services.
-        # A health check must not be specified for App Engine backend and Cloud Function
-        # backend.
+        # specified. Health check is optional for Compute Engine backend services if
+        # there is no backend. A health check must not be specified when adding Internet
+        # Network Endpoint Group or Serverless Network Endpoint Group as backends. In
+        # all other cases, a health check is required for Compute Engine backend
+        # services.
         # For internal load balancing, a URL to a HealthCheck resource must be specified
         # instead.
         # Corresponds to the JSON property `healthChecks`
@@ -3020,6 +3071,8 @@ module Google
         # HTTP2, and load_balancing_scheme set to INTERNAL_MANAGED.
         # - A global backend service with the load_balancing_scheme set to
         # INTERNAL_SELF_MANAGED.
+        # If sessionAffinity is not NONE, and this field is not set to >MAGLEV or
+        # RING_HASH, session affinity settings will not take effect.
         # Corresponds to the JSON property `localityLbPolicy`
         # @return [String]
         attr_accessor :locality_lb_policy
@@ -3116,8 +3169,9 @@ module Google
         # HTTPS.
         # When the loadBalancingScheme is INTERNAL, possible values are NONE, CLIENT_IP,
         # CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO.
-        # When the loadBalancingScheme is INTERNAL_SELF_MANAGED, possible values are
-        # NONE, CLIENT_IP, GENERATED_COOKIE, HEADER_FIELD, or HTTP_COOKIE.
+        # When the loadBalancingScheme is INTERNAL_SELF_MANAGED, or INTERNAL_MANAGED,
+        # possible values are NONE, CLIENT_IP, GENERATED_COOKIE, HEADER_FIELD, or
+        # HTTP_COOKIE.
         # Corresponds to the JSON property `sessionAffinity`
         # @return [String]
         attr_accessor :session_affinity
@@ -4035,6 +4089,22 @@ module Google
         # account. For example, `my-other-app@appspot.gserviceaccount.com`.
         # * `group:`emailid``: An email address that represents a Google group. For
         # example, `admins@example.com`.
+        # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # identifier) representing a user that has been recently deleted. For example, `
+        # alice@example.com?uid=123456789012345678901`. If the user is recovered, this
+        # value reverts to `user:`emailid`` and the recovered user retains the role in
+        # the binding.
+        # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus
+        # unique identifier) representing a service account that has been recently
+        # deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=
+        # 123456789012345678901`. If the service account is undeleted, this value
+        # reverts to `serviceAccount:`emailid`` and the undeleted service account
+        # retains the role in the binding.
+        # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # identifier) representing a Google group that has been recently deleted. For
+        # example, `admins@example.com?uid=123456789012345678901`. If the group is
+        # recovered, this value reverts to `group:`emailid`` and the recovered group
+        # retains the role in the binding.
         # * `domain:`domain``: The G Suite domain (primary) that represents all the
         # users of that domain. For example, `google.com` or `example.com`.
         # Corresponds to the JSON property `members`
@@ -4308,8 +4378,8 @@ module Google
       # Creating a commitment resource means that you are purchasing a committed use
       # contract with an explicit start and end time. You can create commitments based
       # on vCPUs and memory usage and receive discounted rates. For full details, read
-      # Signing Up for Committed Use Discounts. (== resource_for beta.
-      # regionCommitments ==) (== resource_for v1.regionCommitments ==)
+      # Signing Up for Committed Use Discounts. (== resource_for `$api_version`.
+      # regionCommitments ==)
       class Commitment
         include Google::Apis::Core::Hashable
@@ -4349,10 +4419,10 @@ module Google
         # @return [String]
         attr_accessor :kind
-        # A list of commitment amounts for particular licenses.
-        # Corresponds to the JSON property `licenseResources`
-        # @return [Array<Google::Apis::ComputeAlpha::LicenseResourceCommitment>]
-        attr_accessor :license_resources
+        # Commitment for a particular license resource.
+        # Corresponds to the JSON property `licenseResource`
+        # @return [Google::Apis::ComputeAlpha::LicenseResourceCommitment]
+        attr_accessor :license_resource
         # Name of the resource. Provided by the client when the resource is created. The
         # name must be 1-63 characters long, and comply with RFC1035. Specifically, the
@@ -4433,7 +4503,7 @@ module Google
           @end_timestamp = args[:end_timestamp] if args.key?(:end_timestamp)
           @id = args[:id] if args.key?(:id)
           @kind = args[:kind] if args.key?(:kind)
-          @license_resources = args[:license_resources] if args.key?(:license_resources)
+          @license_resource = args[:license_resource] if args.key?(:license_resource)
           @name = args[:name] if args.key?(:name)
           @plan = args[:plan] if args.key?(:plan)
           @region = args[:region] if args.key?(:region)
@@ -4981,8 +5051,8 @@ module Google
         # @return [Array<String>]
         attr_accessor :expose_headers
-        # Specifies how long the results of a preflight request can be cached. This
-        # translates to the content for the Access-Control-Max-Age header.
+        # Specifies how long results of a preflight request can be cached in seconds.
+        # This translates to the Access-Control-Max-Age header.
         # Corresponds to the JSON property `maxAge`
         # @return [Fixnum]
         attr_accessor :max_age
@@ -5014,7 +5084,7 @@ module Google
         attr_accessor :kms_key_name
         # The service account being used for the encryption request for the given KMS
-        # key. If absent, default GCE compute robot account will be used
+        # key. If absent, the Compute Engine default service account is used.
         # Corresponds to the JSON property `kmsKeyServiceAccount`
         # @return [String]
         attr_accessor :kms_key_service_account
@@ -5140,15 +5210,17 @@ module Google
       end
       # Represents a Persistent Disk resource.
+      # Google Compute Engine has two Disk resources:
+      # * [Global](/compute/docs/reference/rest/latest/disks) * [Regional](/compute/
+      # docs/reference/rest/latest/regionDisks)
       # Persistent disks are required for running your VM instances. Create both boot
       # and non-boot (data) persistent disks. For more information, read Persistent
       # Disks. For more storage options, read Storage options.
       # The disks resource represents a zonal persistent disk. For more information,
       # read Zonal persistent disks.
       # The regionDisks resource represents a regional persistent disk. For more
-      # information, read  Regional resources. (== resource_for beta.disks ==) (==
-      # resource_for v1.disks ==) (== resource_for v1.regionDisks ==) (== resource_for
-      # beta.regionDisks ==)
+      # information, read  Regional resources. (== resource_for `$api_version`.disks ==
+      # ) (== resource_for `$api_version`.regionDisks ==)
       class Disk
         include Google::Apis::Core::Hashable
@@ -5375,6 +5447,14 @@ module Google
         # @return [String]
         attr_accessor :source_snapshot_id
+        # The full Google Cloud Storage URI where the disk image is stored. This file
+        # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
+        # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or https:
+        # //storage.googleapis.com/.
+        # Corresponds to the JSON property `sourceStorageObject`
+        # @return [String]
+        attr_accessor :source_storage_object
         # [Output Only] The status of disk creation. CREATING: Disk is provisioning.
         # RESTORING: Source data is being copied into the disk. FAILED: Disk creation
         # failed. READY: Disk is ready for use. DELETING: Disk is deleting.
@@ -5444,6 +5524,7 @@ module Google
           @source_snapshot = args[:source_snapshot] if args.key?(:source_snapshot)
           @source_snapshot_encryption_key = args[:source_snapshot_encryption_key] if args.key?(:source_snapshot_encryption_key)
           @source_snapshot_id = args[:source_snapshot_id] if args.key?(:source_snapshot_id)
+          @source_storage_object = args[:source_storage_object] if args.key?(:source_storage_object)
           @status = args[:status] if args.key?(:status)
           @storage_type = args[:storage_type] if args.key?(:storage_type)
           @type = args[:type] if args.key?(:type)
@@ -5774,14 +5855,16 @@ module Google
       end
       # Represents a Disk Type resource.
+      # Google Compute Engine has two Disk Type resources:
+      # * [Global](/compute/docs/reference/rest/latest/diskTypes) * [Regional](/
+      # compute/docs/reference/rest/latest/regionDiskTypes)
       # You can choose from a variety of disk types based on your needs. For more
       # information, read Storage options.
       # The diskTypes resource represents disk types for a zonal persistent disk. For
       # more information, read Zonal persistent disks.
       # The regionDiskTypes resource represents disk types for a regional persistent
-      # disk. For more information, read Regional persistent disks. (== resource_for
-      # beta.diskTypes ==) (== resource_for v1.diskTypes ==) (== resource_for v1.
-      # regionDiskTypes ==) (== resource_for beta.regionDiskTypes ==)
+      # disk. For more information, read Regional persistent disks. (== resource_for `$
+      # api_version`.diskTypes ==) (== resource_for `$api_version`.regionDiskTypes ==)
       class DiskType
         include Google::Apis::Core::Hashable
@@ -6370,6 +6453,17 @@ module Google
       class DistributionPolicy
         include Google::Apis::Core::Hashable
+        # The shape to which the group converges either proactively or on resize events (
+        # depending on the value set in updatePolicy.instanceRedistributionType). The
+        # possible values are EVEN and ANY. For EVEN the group attempts to preserve a
+        # balanced number of instances across zones. For ANY the group creates new
+        # instances where resources are available to fulfill the request; as a result,
+        # instances may be distributed unevenly across zones in this mode. The default
+        # value is EVEN.
+        # Corresponds to the JSON property `targetShape`
+        # @return [String]
+        attr_accessor :target_shape
         # Zones where the regional managed instance group will create and manage
         # instances.
         # Corresponds to the JSON property `zones`
@@ -6382,6 +6476,7 @@ module Google
         # Update properties of this object
         def update!(**args)
+          @target_shape = args[:target_shape] if args.key?(:target_shape)
           @zones = args[:zones] if args.key?(:zones)
         end
       end
@@ -6648,7 +6743,7 @@ module Google
       end
       # External VPN gateway is the on-premises VPN gateway(s) or another cloud
-      # provider?s VPN gateway that connects to your Google Cloud VPN gateway. To
+      # provider's VPN gateway that connects to your Google Cloud VPN gateway. To
       # create a highly available VPN from Google Cloud to your on-premises side or
       # another Cloud provider's VPN gateway, you must create a external VPN gateway
       # resource in GCP, which provides the information to GCP about your external VPN
@@ -6757,7 +6852,7 @@ module Google
         # IP address of the interface in the external VPN gateway. Only IPv4 is
         # supported. This IP address can be either from your on-premise gateway or
-        # another Cloud provider?s VPN gateway, it cannot be an IP address from Google
+        # another Cloud provider's VPN gateway, it cannot be an IP address from Google
         # Compute Engine.
         # Corresponds to the JSON property `ipAddress`
         # @return [String]
@@ -7383,16 +7478,18 @@ module Google
       end
       # Represents a Forwarding Rule resource.
+      # Forwarding rule resources in GCP can be either regional or global in scope:
+      # * [Global](/compute/docs/reference/rest/latest/globalForwardingRules) * [
+      # Regional](/compute/docs/reference/rest/latest/forwardingRules)
       # A forwarding rule and its corresponding IP address represent the frontend
       # configuration of a Google Cloud Platform load balancer. Forwarding rules can
       # also reference target instances and Cloud VPN Classic gateways (
       # targetVpnGateway).
       # For more information, read Forwarding rule concepts and Using protocol
       # forwarding.
-      # (== resource_for beta.forwardingRules ==) (== resource_for v1.forwardingRules =
-      # =) (== resource_for beta.globalForwardingRules ==) (== resource_for v1.
-      # globalForwardingRules ==) (== resource_for beta.regionForwardingRules ==) (==
-      # resource_for v1.regionForwardingRules ==)
+      # (== resource_for `$api_version`.forwardingRules ==) (== resource_for `$
+      # api_version`.globalForwardingRules ==) (== resource_for `$api_version`.
+      # regionForwardingRules ==)
       class ForwardingRule
         include Google::Apis::Core::Hashable
@@ -7414,8 +7511,8 @@ module Google
         # @return [String]
         attr_accessor :ip_address
-        # The IP protocol to which this rule applies. Valid options are TCP, UDP, ESP,
-        # AH, SCTP or ICMP.
+        # The IP protocol to which this rule applies. For protocol forwarding, valid
+        # options are TCP, UDP, ESP, AH, SCTP or ICMP.
         # For Internal TCP/UDP Load Balancing, the load balancing scheme is INTERNAL,
         # and one of TCP or UDP are valid. For Traffic Director, the load balancing
         # scheme is INTERNAL_SELF_MANAGED, and only TCPis valid. For Internal HTTP(S)
@@ -7527,28 +7624,37 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
-        # Specifies the forwarding rule type. EXTERNAL is used for: - Classic Cloud VPN
-        # gateways - Protocol forwarding to VMs from an external IP address - The
-        # following load balancers: HTTP(S), SSL Proxy, TCP Proxy, and Network TCP/UDP.
-        # INTERNAL is used for: - Protocol forwarding to VMs from an internal IP address
+        # Specifies the forwarding rule type.
+        #
+        # - EXTERNAL is used for:
+        # - Classic Cloud VPN gateways
+        # - Protocol forwarding to VMs from an external IP address
+        # - The following load balancers: HTTP(S), SSL Proxy, TCP Proxy, and Network TCP/
+        # UDP
+        # - INTERNAL is used for:
+        # - Protocol forwarding to VMs from an internal IP address
         # - Internal TCP/UDP load balancers
-        # INTERNAL_MANAGED is used for: - Internal HTTP(S) load balancers
-        # INTERNAL_SELF_MANAGED is used for: - Traffic Director
+        # - INTERNAL_MANAGED is used for:
+        # - Internal HTTP(S) load balancers
+        # - >INTERNAL_SELF_MANAGED is used for:
+        # - Traffic Director
         # For more information about forwarding rules, refer to Forwarding rule concepts.
         # Corresponds to the JSON property `loadBalancingScheme`
         # @return [String]
         attr_accessor :load_balancing_scheme
         # Opaque filter criteria used by Loadbalancer to restrict routing configuration
-        # to a limited set xDS compliant clients. In their xDS requests to Loadbalancer,
-        # xDS clients present node metadata. If a match takes place, the relevant
-        # routing configuration is made available to those proxies.
+        # to a limited set of xDS compliant clients. In their xDS requests to
+        # Loadbalancer, xDS clients present node metadata. If a match takes place, the
+        # relevant configuration is made available to those proxies. Otherwise, all the
+        # resources (e.g. TargetHttpProxy, UrlMap) referenced by the ForwardingRule will
+        # not be visible to those proxies.
         # For each metadataFilter in this list, if its filterMatchCriteria is set to
         # MATCH_ANY, at least one of the filterLabels must match the corresponding label
         # provided in the metadata. If its filterMatchCriteria is set to MATCH_ALL, then
-        # all of its filterLabels must match with corresponding labels in the provided
+        # all of its filterLabels must match with corresponding labels provided in the
         # metadata.
-        # metadataFilters specified here can be overridden by those specified in the
+        # metadataFilters specified here will be applifed before those specified in the
         # UrlMap that this ForwardingRule references.
         # metadataFilters only applies to Loadbalancers that have their
         # loadBalancingScheme set to INTERNAL_SELF_MANAGED.
@@ -7584,23 +7690,16 @@ module Google
         # @return [String]
         attr_accessor :network_tier
-        # This field is deprecated. See the port
-        # field.
-        # Corresponds to the JSON property `portRange`
-        # @return [String]
-        attr_accessor :port_range
-        # List of comma-separated ports. The forwarding rule forwards packets with
-        # matching destination ports. If the forwarding rule's loadBalancingScheme is
-        # EXTERNAL, and the forwarding rule references a target pool, specifying ports
-        # is optional. You can specify an unlimited number of ports, but they must be
-        # contiguous. If you omit ports, GCP forwards traffic on any port of the
-        # forwarding rule's protocol.
-        # If the forwarding rule's loadBalancingScheme is EXTERNAL, and the forwarding
-        # rule references a target HTTP proxy, target HTTPS proxy, target TCP proxy,
-        # target SSL proxy, or target VPN gateway, you must specify ports using the
-        # following constraints:
-        #
+        # When the load balancing scheme is EXTERNAL, INTERNAL_SELF_MANAGED and
+        # INTERNAL_MANAGED, you can specify a port_range. Use with a forwarding rule
+        # that points to a target proxy or a target pool. Do not use with a forwarding
+        # rule that points to a backend service. This field is used along with the
+        # target field for TargetHttpProxy, TargetHttpsProxy, TargetSslProxy,
+        # TargetTcpProxy, TargetVpnGateway, TargetPool, TargetInstance.
+        # Applicable only when IPProtocol is TCP, UDP, or SCTP, only packets addressed
+        # to ports in the specified range will be forwarded to target. Forwarding rules
+        # with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.
+        # Some types of forwarding target have constraints on the acceptable ports:
         # - TargetHttpProxy: 80, 8080
         # - TargetHttpsProxy: 443
         # - TargetTcpProxy: 25, 43, 110, 143, 195, 443, 465, 587, 700, 993, 995, 1688,
@@ -7608,16 +7707,20 @@ module Google
         # - TargetSslProxy: 25, 43, 110, 143, 195, 443, 465, 587, 700, 993, 995, 1688,
         # 1883, 5222
         # - TargetVpnGateway: 500, 4500
-        # If the forwarding rule's loadBalancingScheme is INTERNAL, you must specify
+        # Corresponds to the JSON property `portRange`
+        # @return [String]
+        attr_accessor :port_range
+        # This field is used along with the backend_service field for internal load
+        # balancing.
+        # When the load balancing scheme is INTERNAL, a list of ports can be configured,
+        # for example, ['80'], ['8000','9000']. Only packets addressed to these ports
+        # are forwarded to the backends configured with the forwarding rule.
+        # If the forwarding rule's loadBalancingScheme is INTERNAL, you can specify
         # ports in one of the following ways:
         # * A list of up to five ports, which can be non-contiguous * Keyword ALL, which
         # causes the forwarding rule to forward traffic on any port of the forwarding
         # rule's protocol.
-        # The ports field is used along with the target field for TargetHttpProxy,
-        # TargetHttpsProxy, TargetSslProxy, TargetTcpProxy, TargetVpnGateway, TargetPool,
-        # TargetInstance.
-        # Applicable only when IPProtocol is TCP, UDP, or SCTP. Forwarding rules with
-        # the same [IPAddress, IPProtocol] pair must have disjoint port ranges.
         # Corresponds to the JSON property `ports`
         # @return [Array<String>]
         attr_accessor :ports
@@ -7673,8 +7776,8 @@ module Google
         # forwarding rules, this target must live in the same region as the forwarding
         # rule. For global forwarding rules, this target must be a global load balancing
         # resource. The forwarded traffic must be of a type appropriate to the target
-        # object. For INTERNAL_SELF_MANAGED load balancing, only HTTP and HTTPS targets
-        # are valid.
+        # object. For INTERNAL_SELF_MANAGED load balancing, only targetHttpProxy is
+        # valid, not targetHttpsProxy.
         # Corresponds to the JSON property `target`
         # @return [String]
         attr_accessor :target
@@ -8153,32 +8256,34 @@ module Google
         # @return [String]
         attr_accessor :etag
-        # Defines an Identity and Access Management (IAM) policy. It is used to specify
-        # access control policies for Cloud Platform resources.
+        # An Identity and Access Management (IAM) policy, which specifies access
+        # controls for Google Cloud resources.
         # A `Policy` is a collection of `bindings`. A `binding` binds one or more `
         # members` to a single `role`. Members can be user accounts, service accounts,
         # Google groups, and domains (such as G Suite). A `role` is a named list of
-        # permissions (defined by IAM or configured by users). A `binding` can
-        # optionally specify a `condition`, which is a logic expression that further
-        # constrains the role binding based on attributes about the request and/or
-        # target resource.
-        # **JSON Example**
+        # permissions; each `role` can be an IAM predefined role or a user-created
+        # custom role.
+        # Optionally, a `binding` can specify a `condition`, which is a logical
+        # expression that allows access to a resource only if the expression evaluates
+        # to `true`. A condition can add constraints based on attributes of the request,
+        # the resource, or both.
+        # **JSON example:**
         # ` "bindings": [ ` "role": "roles/resourcemanager.organizationAdmin", "members":
         # [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "
         # serviceAccount:my-project-id@appspot.gserviceaccount.com" ] `, ` "role": "
         # roles/resourcemanager.organizationViewer", "members": ["user:eve@example.com"],
         # "condition": ` "title": "expirable access", "description": "Does not grant
         # access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:
-        # 00:00.000Z')", ` ` ] `
-        # **YAML Example**
+        # 00:00.000Z')", ` ` ], "etag": "BwWWja0YfJA=", "version": 3 `
+        # **YAML example:**
         # bindings: - members: - user:mike@example.com - group:admins@example.com -
         # domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com
         # role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.
         # com role: roles/resourcemanager.organizationViewer condition: title: expirable
         # access description: Does not grant access after Sep 2020 expression: request.
-        # time < timestamp('2020-10-01T00:00:00.000Z')
-        # For a description of IAM and its features, see the [IAM developer's guide](
-        # https://cloud.google.com/iam/docs).
+        # time < timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3
+        # For a description of IAM and its features, see the [IAM documentation](https://
+        # cloud.google.com/iam/docs/).
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::ComputeAlpha::Policy]
         attr_accessor :policy
@@ -8195,6 +8300,66 @@ module Google
         end
       end
+      # A Duration represents a signed, fixed-length span of time represented as a
+      # count of seconds and fractions of seconds at nanosecond resolution. It is
+      # independent of any calendar and concepts like "day" or "month". It is related
+      # to Timestamp in that the difference between two Timestamp values is a Duration
+      # and it can be added or subtracted from a Timestamp. Range is approximately +-
+      # 10,000 years.
+      # # Examples
+      # Example 1: Compute Duration from two Timestamps in pseudo code.
+      # Timestamp start = ...; Timestamp end = ...; Duration duration = ...;
+      # duration.seconds = end.seconds - start.seconds; duration.nanos = end.nanos -
+      # start.nanos;
+      # if (duration.seconds  0) ` duration.seconds += 1; duration.nanos -= 1000000000;
+      # ` else if (duration.seconds > 0 && duration.nanos < 0) ` duration.seconds -=
+      # 1; duration.nanos += 1000000000; `
+      # Example 2: Compute Timestamp from Timestamp + Duration in pseudo code.
+      # Timestamp start = ...; Duration duration = ...; Timestamp end = ...;
+      # end.seconds = start.seconds + duration.seconds; end.nanos = start.nanos +
+      # duration.nanos;
+      # if (end.nanos = 1000000000) ` end.seconds += 1; end.nanos -= 1000000000; `
+      # Example 3: Compute Duration from datetime.timedelta in Python.
+      # td = datetime.timedelta(days=3, minutes=10) duration = Duration() duration.
+      # FromTimedelta(td)
+      # # JSON Mapping
+      # In JSON format, the Duration type is encoded as a string rather than an object,
+      # where the string ends in the suffix "s" (indicating seconds) and is preceded
+      # by the number of seconds, with nanoseconds expressed as fractional seconds.
+      # For example, 3 seconds with 0 nanoseconds should be encoded in JSON format as "
+      # 3s", while 3 seconds and 1 nanosecond should be expressed in JSON format as "3.
+      # 000000001s", and 3 seconds and 1 microsecond should be expressed in JSON
+      # format as "3.000001s".
+      class GoogleDuration
+        include Google::Apis::Core::Hashable
+        # Signed fractions of a second at nanosecond resolution of the span of time.
+        # Durations less than one second are represented with a 0 `seconds` field and a
+        # positive or negative `nanos` field. For durations of one second or more, a non-
+        # zero value for the `nanos` field must be of the same sign as the `seconds`
+        # field. Must be from -999,999,999 to +999,999,999 inclusive.
+        # Corresponds to the JSON property `nanos`
+        # @return [Fixnum]
+        attr_accessor :nanos
+        # Signed seconds of the span of time. Must be from -315,576,000,000 to +315,576,
+        # 000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/
+        # hr * 24 hr/day * 365.25 days/year * 10000 years
+        # Corresponds to the JSON property `seconds`
+        # @return [Fixnum]
+        attr_accessor :seconds
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @nanos = args[:nanos] if args.key?(:nanos)
+          @seconds = args[:seconds] if args.key?(:seconds)
+        end
+      end
       # gRPC config to access the SDS server.
       class GrpcServiceConfig
         include Google::Apis::Core::Hashable
@@ -8237,7 +8402,7 @@ module Google
         attr_accessor :kind
         # The path to be queried. This can be the default namespace ('/') or a nested
-        # namespace ('//') or a specified key ('//')
+        # namespace ('/\/') or a specified key ('/\/\')
         # Corresponds to the JSON property `queryPath`
         # @return [String]
         attr_accessor :query_path
@@ -8372,20 +8537,13 @@ module Google
         # Specifies how port is selected for health checking, can be one of following
         # values:
-        # USE_FIXED_PORT: The port number in
-        # port
-        # is used for health checking.
-        # USE_NAMED_PORT: The
-        # portName
-        # is used for health checking.
+        # USE_FIXED_PORT: The port number in port is used for health checking.
+        # USE_NAMED_PORT: The portName is used for health checking.
         # USE_SERVING_PORT: For NetworkEndpointGroup, the port specified for each
         # network endpoint is used for health checking. For other backends, the port or
         # named port specified in the Backend Service is used for health checking.
-        # If not specified, HTTP2 health check follows behavior specified in
-        # port
-        # and
-        # portName
-        # fields.
+        # If not specified, HTTP2 health check follows behavior specified in port and
+        # portName fields.
         # Corresponds to the JSON property `portSpecification`
         # @return [String]
         attr_accessor :port_specification
@@ -8449,20 +8607,13 @@ module Google
         # Specifies how port is selected for health checking, can be one of following
         # values:
-        # USE_FIXED_PORT: The port number in
-        # port
-        # is used for health checking.
-        # USE_NAMED_PORT: The
-        # portName
-        # is used for health checking.
+        # USE_FIXED_PORT: The port number in port is used for health checking.
+        # USE_NAMED_PORT: The portName is used for health checking.
         # USE_SERVING_PORT: For NetworkEndpointGroup, the port specified for each
         # network endpoint is used for health checking. For other backends, the port or
         # named port specified in the Backend Service is used for health checking.
-        # If not specified, HTTP health check follows behavior specified in
-        # port
-        # and
-        # portName
-        # fields.
+        # If not specified, HTTP health check follows behavior specified in port and
+        # portName fields.
         # Corresponds to the JSON property `portSpecification`
         # @return [String]
         attr_accessor :port_specification
@@ -8526,20 +8677,13 @@ module Google
         # Specifies how port is selected for health checking, can be one of following
         # values:
-        # USE_FIXED_PORT: The port number in
-        # port
-        # is used for health checking.
-        # USE_NAMED_PORT: The
-        # portName
-        # is used for health checking.
+        # USE_FIXED_PORT: The port number in port is used for health checking.
+        # USE_NAMED_PORT: The portName is used for health checking.
         # USE_SERVING_PORT: For NetworkEndpointGroup, the port specified for each
         # network endpoint is used for health checking. For other backends, the port or
         # named port specified in the Backend Service is used for health checking.
-        # If not specified, HTTPS health check follows behavior specified in
-        # port
-        # and
-        # portName
-        # fields.
+        # If not specified, HTTPS health check follows behavior specified in port and
+        # portName fields.
         # Corresponds to the JSON property `portSpecification`
         # @return [String]
         attr_accessor :port_specification
@@ -8579,8 +8723,12 @@ module Google
       end
       # Represents a Health Check resource.
-      # Health checks are used for most GCP load balancers and managed instance group
-      # auto-healing. For more information, read Health Check Concepts.
+      # Google Compute Engine has two Health Check resources:
+      # * [Global](/compute/docs/reference/rest/latest/healthChecks) * [Regional](/
+      # compute/docs/reference/rest/latest/regionHealthChecks)
+      # Internal HTTP(S) load balancers use regional health checks. All other types of
+      # GCP load balancers and managed instance group auto-healing use global health
+      # checks. For more information, read Health Check Concepts.
       # To perform health checks on network load balancers, you must use either
       # httpHealthChecks or httpsHealthChecks.
       class HealthCheck
@@ -8910,6 +9058,17 @@ module Google
         # @return [String]
         attr_accessor :description
+        # Fingerprint of this resource. A hash of the contents stored in this object.
+        # This field is used in optimistic locking. This field will be ignored when
+        # inserting a HealthCheckService. An up-to-date fingerprint must be provided in
+        # order to patch/update the HealthCheckService; Otherwise, the request will fail
+        # with error 412 conditionNotMet. To see the latest fingerprint, make a get()
+        # request to retrieve the HealthCheckService.
+        # Corresponds to the JSON property `fingerprint`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :fingerprint
         # List of URLs to the HealthCheck resources. Must have at least one HealthCheck,
         # and not more than 10. HealthCheck resources must have portSpecification=
         # USE_SERVING_PORT. For regional HealthCheckService, the HealthCheck must be
@@ -9007,6 +9166,7 @@ module Google
         def update!(**args)
           @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp)
           @description = args[:description] if args.key?(:description)
+          @fingerprint = args[:fingerprint] if args.key?(:fingerprint)
           @health_checks = args[:health_checks] if args.key?(:health_checks)
           @health_status_aggregation_policy = args[:health_status_aggregation_policy] if args.key?(:health_status_aggregation_policy)
           @health_status_aggregation_strategy = args[:health_status_aggregation_strategy] if args.key?(:health_status_aggregation_strategy)
@@ -9675,7 +9835,7 @@ module Google
         attr_accessor :prefix_match
         # A header with the contents of headerName must exist. The match takes place
-        # whether or not the request's header has a value or not.
+        # whether or not the request's header has a value.
         # Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or
         # rangeMatch must be set.
         # Corresponds to the JSON property `presentMatch`
@@ -9689,7 +9849,7 @@ module Google
         # @return [Google::Apis::ComputeAlpha::Int64RangeMatch]
         attr_accessor :range_match
-        # The value of the header must match the regualar expression specified in
+        # The value of the header must match the regular expression specified in
         # regexMatch. For regular expression grammar, please see:  en.cppreference.com/w/
         # cpp/regex/ecmascript
         # For matching against a port specified in the HTTP request, use a headerMatch
@@ -9697,6 +9857,8 @@ module Google
         # RFC2616 Host header's port specifier.
         # Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or
         # rangeMatch must be set.
+        # Note that regexMatch only applies to Loadbalancers that have their
+        # loadBalancingScheme set to INTERNAL_SELF_MANAGED.
         # Corresponds to the JSON property `regexMatch`
         # @return [String]
         attr_accessor :regex_match
@@ -9997,7 +10159,7 @@ module Google
         # The queryParameterMatch matches if the value of the parameter exactly matches
         # the contents of exactMatch.
-        # Only one of presentMatch, exactMatch and regexMatch must be set.
+        # Only one of presentMatch, exactMatch or regexMatch must be set.
         # Corresponds to the JSON property `exactMatch`
         # @return [String]
         attr_accessor :exact_match
@@ -10010,7 +10172,7 @@ module Google
         # Specifies that the queryParameterMatch matches if the request contains the
         # query parameter, irrespective of whether the parameter has a value or not.
-        # Only one of presentMatch, exactMatch and regexMatch must be set.
+        # Only one of presentMatch, exactMatch or regexMatch must be set.
         # Corresponds to the JSON property `presentMatch`
         # @return [Boolean]
         attr_accessor :present_match
@@ -10019,7 +10181,9 @@ module Google
         # The queryParameterMatch matches if the value of the parameter matches the
         # regular expression specified by regexMatch. For the regular expression grammar,
         # please see en.cppreference.com/w/cpp/regex/ecmascript
-        # Only one of presentMatch, exactMatch and regexMatch must be set.
+        # Only one of presentMatch, exactMatch or regexMatch must be set.
+        # Note that regexMatch only applies when the loadBalancingScheme is set to
+        # INTERNAL_SELF_MANAGED.
         # Corresponds to the JSON property `regexMatch`
         # @return [String]
         attr_accessor :regex_match
@@ -10061,7 +10225,9 @@ module Google
         # The path that will be used in the redirect response instead of the one that
         # was supplied in the request.
-        # Only one of pathRedirect or prefixRedirect must be specified.
+        # pathRedirect cannot be supplied together with prefixRedirect. Supply one alone
+        # or neither. If neither is supplied, the path of the original request will be
+        # used for the redirect.
         # The value must be between 1 and 1024 characters.
         # Corresponds to the JSON property `pathRedirect`
         # @return [String]
@@ -10069,6 +10235,10 @@ module Google
         # The prefix that replaces the prefixMatch specified in the HttpRouteRuleMatch,
         # retaining the remaining portion of the URL before redirecting the request.
+        # prefixRedirect cannot be supplied together with pathRedirect. Supply one alone
+        # or neither. If neither is supplied, the path of the original request will be
+        # used for the redirect.
+        # The value must be between 1 and 1024 characters.
         # Corresponds to the JSON property `prefixRedirect`
         # @return [String]
         attr_accessor :prefix_redirect
@@ -10288,7 +10458,8 @@ module Google
         # forwarding the request to the selected backend. If  routeAction specifies any
         # weightedBackendServices, service must not be set. Conversely if service is set,
         # routeAction cannot contain any  weightedBackendServices.
-        # Only one of routeAction or urlRedirect must be set.
+        # Only one of urlRedirect, service or routeAction.weightedBackendService must be
+        # set.
         # Corresponds to the JSON property `routeAction`
         # @return [Google::Apis::ComputeAlpha::HttpRouteAction]
         attr_accessor :route_action
@@ -10331,10 +10502,10 @@ module Google
       class HttpRouteRuleMatch
         include Google::Apis::Core::Hashable
-        # For satifying the matchRule condition, the path of the request must exactly
+        # For satisfying the matchRule condition, the path of the request must exactly
         # match the value specified in fullPathMatch after removing any query parameters
         # and anchor that may be part of the original URL.
-        # FullPathMatch must be between 1 and 1024 characters.
+        # fullPathMatch must be between 1 and 1024 characters.
         # Only one of prefixMatch, fullPathMatch or regexMatch must be specified.
         # Corresponds to the JSON property `fullPathMatch`
         # @return [String]
@@ -10348,30 +10519,30 @@ module Google
         # Specifies that prefixMatch and fullPathMatch matches are case sensitive.
         # The default value is false.
-        # caseSensitive must not be used with regexMatch.
+        # ignoreCase must not be used with regexMatch.
         # Corresponds to the JSON property `ignoreCase`
         # @return [Boolean]
         attr_accessor :ignore_case
         alias_method :ignore_case?, :ignore_case
         # Opaque filter criteria used by Loadbalancer to restrict routing configuration
-        # to a limited set xDS compliant clients. In their xDS requests to Loadbalancer,
-        # xDS clients present node metadata. If a match takes place, the relevant
-        # routing configuration is made available to those proxies.
+        # to a limited set of xDS compliant clients. In their xDS requests to
+        # Loadbalancer, xDS clients present node metadata. If a match takes place, the
+        # relevant routing configuration is made available to those proxies.
         # For each metadataFilter in this list, if its filterMatchCriteria is set to
         # MATCH_ANY, at least one of the filterLabels must match the corresponding label
         # provided in the metadata. If its filterMatchCriteria is set to MATCH_ALL, then
-        # all of its filterLabels must match with corresponding labels in the provided
+        # all of its filterLabels must match with corresponding labels provided in the
         # metadata.
-        # metadataFilters specified here can be overrides those specified in
-        # ForwardingRule that refers to this UrlMap.
+        # metadataFilters specified here will be applied after those specified in
+        # ForwardingRule that refers to the UrlMap this HttpRouteRuleMatch belongs to.
         # metadataFilters only applies to Loadbalancers that have their
         # loadBalancingScheme set to INTERNAL_SELF_MANAGED.
         # Corresponds to the JSON property `metadataFilters`
         # @return [Array<Google::Apis::ComputeAlpha::MetadataFilter>]
         attr_accessor :metadata_filters
-        # For satifying the matchRule condition, the request's path must begin with the
+        # For satisfying the matchRule condition, the request's path must begin with the
         # specified prefixMatch. prefixMatch must begin with a /.
         # The value must be between 1 and 1024 characters.
         # Only one of prefixMatch, fullPathMatch or regexMatch must be specified.
@@ -10385,11 +10556,13 @@ module Google
         # @return [Array<Google::Apis::ComputeAlpha::HttpQueryParameterMatch>]
         attr_accessor :query_parameter_matches
-        # For satifying the matchRule condition, the path of the request must satisfy
+        # For satisfying the matchRule condition, the path of the request must satisfy
         # the regular expression specified in regexMatch after removing any query
         # parameters and anchor supplied with the original URL. For regular expression
         # grammar please see en.cppreference.com/w/cpp/regex/ecmascript
         # Only one of prefixMatch, fullPathMatch or regexMatch must be specified.
+        # Note that regexMatch only applies to Loadbalancers that have their
+        # loadBalancingScheme set to INTERNAL_SELF_MANAGED.
         # Corresponds to the JSON property `regexMatch`
         # @return [String]
         attr_accessor :regex_match
@@ -10642,8 +10815,7 @@ module Google
       # Represents an Image resource.
       # You can use images to create boot disks for your VM instances. For more
-      # information, read Images. (== resource_for beta.images ==) (== resource_for v1.
-      # images ==)
+      # information, read Images. (== resource_for `$api_version`.images ==)
       class Image
         include Google::Apis::Core::Hashable
@@ -11081,8 +11253,8 @@ module Google
       # Represents an Instance resource.
       # An instance is a virtual machine that is hosted on Google Cloud Platform. For
-      # more information, read Virtual Machine Instances. (== resource_for beta.
-      # instances ==) (== resource_for v1.instances ==)
+      # more information, read Virtual Machine Instances. (== resource_for `$
+      # api_version`.instances ==)
       class Instance
         include Google::Apis::Core::Hashable
@@ -11253,6 +11425,12 @@ module Google
         # @return [Fixnum]
         attr_accessor :preserved_state_size_gb
+        # The private IPv6 google access type for the VM. If not specified, use
+        # INHERIT_FROM_SUBNETWORK as default.
+        # Corresponds to the JSON property `privateIpv6GoogleAccess`
+        # @return [String]
+        attr_accessor :private_ipv6_google_access
         # Specifies the reservations that this instance can consume from.
         # Corresponds to the JSON property `reservationAffinity`
         # @return [Google::Apis::ComputeAlpha::ReservationAffinity]
@@ -11343,6 +11521,11 @@ module Google
         # @return [Google::Apis::ComputeAlpha::Tags]
         attr_accessor :tags
+        # Upcoming Maintenance notification information.
+        # Corresponds to the JSON property `upcomingMaintenance`
+        # @return [Google::Apis::ComputeAlpha::UpcomingMaintenance]
+        attr_accessor :upcoming_maintenance
         # [Output Only] URL of the zone where the instance resides. You must specify
         # this field as part of the HTTP request URL. It is not settable as a field in
         # the request body.
@@ -11380,6 +11563,7 @@ module Google
           @network_interfaces = args[:network_interfaces] if args.key?(:network_interfaces)
           @post_key_revocation_action_type = args[:post_key_revocation_action_type] if args.key?(:post_key_revocation_action_type)
           @preserved_state_size_gb = args[:preserved_state_size_gb] if args.key?(:preserved_state_size_gb)
+          @private_ipv6_google_access = args[:private_ipv6_google_access] if args.key?(:private_ipv6_google_access)
           @reservation_affinity = args[:reservation_affinity] if args.key?(:reservation_affinity)
           @resource_policies = args[:resource_policies] if args.key?(:resource_policies)
           @scheduling = args[:scheduling] if args.key?(:scheduling)
@@ -11396,6 +11580,7 @@ module Google
           @status = args[:status] if args.key?(:status)
           @status_message = args[:status_message] if args.key?(:status_message)
           @tags = args[:tags] if args.key?(:tags)
+          @upcoming_maintenance = args[:upcoming_maintenance] if args.key?(:upcoming_maintenance)
           @zone = args[:zone] if args.key?(:zone)
         end
       end
@@ -11518,15 +11703,17 @@ module Google
         end
       end
-      # Represents an unmanaged Instance Group resource.
-      # Use unmanaged instance groups if you need to apply load balancing to groups of
-      # heterogeneous instances or if you need to manage the instances yourself. For
-      # more information, read  Instance groups.
-      # For zonal unmanaged Instance Group, use instanceGroups resource.
-      # For regional unmanaged Instance Group, use regionInstanceGroups resource. (==
-      # resource_for beta.instanceGroups ==) (== resource_for v1.instanceGroups ==) (==
-      # resource_for beta.regionInstanceGroups ==) (== resource_for v1.
-      # regionInstanceGroups ==)
+      # Represents an Instance Group resource.
+      # Instance Groups can be used to configure a target for load balancing.
+      # Instance groups can either be managed or unmanaged.
+      # To create  managed instance groups, use the instanceGroupManager or
+      # regionInstanceGroupManager resource instead.
+      # Use zonal unmanaged instance groups if you need to apply load balancing to
+      # groups of heterogeneous instances or if you need to manage the instances
+      # yourself. You cannot create regional unmanaged instance groups.
+      # For more information, read Instance groups.
+      # (== resource_for `$api_version`.instanceGroups ==) (== resource_for `$
+      # api_version`.regionInstanceGroups ==)
       class InstanceGroup
         include Google::Apis::Core::Hashable
@@ -11879,9 +12066,8 @@ module Google
       # single entity. For more information, read Instance groups.
       # For zonal Managed Instance Group, use the instanceGroupManagers resource.
       # For regional Managed Instance Group, use the regionInstanceGroupManagers
-      # resource. (== resource_for beta.instanceGroupManagers ==) (== resource_for v1.
-      # instanceGroupManagers ==) (== resource_for beta.regionInstanceGroupManagers ==)
-      # (== resource_for v1.regionInstanceGroupManagers ==)
+      # resource. (== resource_for `$api_version`.instanceGroupManagers ==) (==
+      # resource_for `$api_version`.regionInstanceGroupManagers ==)
       class InstanceGroupManager
         include Google::Apis::Core::Hashable
@@ -14003,11 +14189,23 @@ module Google
         # @return [String]
         attr_accessor :post_key_revocation_action_type
+        # The private IPv6 google access type for the VM. If not specified, use
+        # INHERIT_FROM_SUBNETWORK as default.
+        # Corresponds to the JSON property `privateIpv6GoogleAccess`
+        # @return [String]
+        attr_accessor :private_ipv6_google_access
         # Specifies the reservations that this instance can consume from.
         # Corresponds to the JSON property `reservationAffinity`
         # @return [Google::Apis::ComputeAlpha::ReservationAffinity]
         attr_accessor :reservation_affinity
+        # Resource policies (names, not ULRs) applied to instances created from this
+        # templae.
+        # Corresponds to the JSON property `resourcePolicies`
+        # @return [Array<String>]
+        attr_accessor :resource_policies
         # Sets the scheduling options for an Instance. NextID: 9
         # Corresponds to the JSON property `scheduling`
         # @return [Google::Apis::ComputeAlpha::Scheduling]
@@ -14053,7 +14251,9 @@ module Google
           @min_cpu_platform = args[:min_cpu_platform] if args.key?(:min_cpu_platform)
           @network_interfaces = args[:network_interfaces] if args.key?(:network_interfaces)
           @post_key_revocation_action_type = args[:post_key_revocation_action_type] if args.key?(:post_key_revocation_action_type)
+          @private_ipv6_google_access = args[:private_ipv6_google_access] if args.key?(:private_ipv6_google_access)
           @reservation_affinity = args[:reservation_affinity] if args.key?(:reservation_affinity)
+          @resource_policies = args[:resource_policies] if args.key?(:resource_policies)
           @scheduling = args[:scheduling] if args.key?(:scheduling)
           @service_accounts = args[:service_accounts] if args.key?(:service_accounts)
           @shielded_instance_config = args[:shielded_instance_config] if args.key?(:shielded_instance_config)
@@ -14083,8 +14283,8 @@ module Google
       # Represents an Instance Template resource.
       # You can use instance templates to create VM instances and managed instance
-      # groups. For more information, read Instance Templates. (== resource_for beta.
-      # instanceTemplates ==) (== resource_for v1.instanceTemplates ==)
+      # groups. For more information, read Instance Templates. (== resource_for `$
+      # api_version`.instanceTemplates ==)
       class InstanceTemplate
         include Google::Apis::Core::Hashable
@@ -14728,8 +14928,7 @@ module Google
       # Represents an Interconnect resource.
       # An Interconnect resource is a dedicated connection between the GCP network and
       # your on-premises network. For more information, read the  Dedicated
-      # Interconnect Overview. (== resource_for v1.interconnects ==) (== resource_for
-      # beta.interconnects ==)
+      # Interconnect Overview. (== resource_for `$api_version`.interconnects ==)
       class Interconnect
         include Google::Apis::Core::Hashable
@@ -14951,8 +15150,8 @@ module Google
       # Represents an Interconnect Attachment (VLAN) resource.
       # You can use Interconnect attachments (VLANS) to connect your Virtual Private
       # Cloud networks to your on-premises networks through an Interconnect. For more
-      # information, read  Creating VLAN Attachments. (== resource_for beta.
-      # interconnectAttachments ==) (== resource_for v1.interconnectAttachments ==)
+      # information, read  Creating VLAN Attachments. (== resource_for `$api_version`.
+      # interconnectAttachments ==)
       class InterconnectAttachment
         include Google::Apis::Core::Hashable
@@ -14989,7 +15188,7 @@ module Google
         # prefixes must be within link-local address space (169.254.0.0/16) and must be /
         # 29 or shorter (/28, /27, etc). Google will attempt to select an unused /29
         # from the supplied candidate prefix(es). The request will fail if all possible /
-        # 29s are in use on Google?s edge. If not supplied, Google will randomly select
+        # 29s are in use on Google's edge. If not supplied, Google will randomly select
         # an unused /29 from all of link-local space.
         # Corresponds to the JSON property `candidateSubnets`
         # @return [Array<String>]
@@ -15474,7 +15673,7 @@ module Google
         include Google::Apis::Core::Hashable
         # Plain text name of the Interconnect this attachment is connected to, as
-        # displayed in the Partner?s portal. For instance "Chicago 1". This value may be
+        # displayed in the Partner's portal. For instance "Chicago 1". This value may be
         # validated to match approved Partner values.
         # Corresponds to the JSON property `interconnectName`
         # @return [String]
@@ -15486,7 +15685,7 @@ module Google
         # @return [String]
         attr_accessor :partner_name
-        # URL of the Partner?s portal for this Attachment. Partners may customise this
+        # URL of the Partner's portal for this Attachment. Partners may customise this
         # to be a deep link to the specific resource on the Partner portal. This value
         # may be validated to match approved Partner values.
         # Corresponds to the JSON property `portalUrl`
@@ -15652,7 +15851,7 @@ module Google
       end
       # Diagnostics information about interconnect, contains detailed and current
-      # technical information about Google?s side of the connection.
+      # technical information about Google's side of the connection.
       class InterconnectDiagnostics
         include Google::Apis::Core::Hashable
@@ -15715,12 +15914,12 @@ module Google
       class InterconnectDiagnosticsLinkLacpStatus
         include Google::Apis::Core::Hashable
-        # System ID of the port on Google?s side of the LACP exchange.
+        # System ID of the port on Google's side of the LACP exchange.
         # Corresponds to the JSON property `googleSystemId`
         # @return [String]
         attr_accessor :google_system_id
-        # System ID of the port on the neighbor?s side of the LACP exchange.
+        # System ID of the port on the neighbor's side of the LACP exchange.
         # Corresponds to the JSON property `neighborSystemId`
         # @return [String]
         attr_accessor :neighbor_system_id
@@ -16314,7 +16513,7 @@ module Google
         include Google::Apis::Core::Hashable
         # Diagnostics information about interconnect, contains detailed and current
-        # technical information about Google?s side of the connection.
+        # technical information about Google's side of the connection.
         # Corresponds to the JSON property `result`
         # @return [Google::Apis::ComputeAlpha::InterconnectDiagnostics]
         attr_accessor :result
@@ -16658,7 +16857,7 @@ module Google
         # @return [String]
         attr_accessor :issuer
-        # The provider?s public key set to validate the signature of the JWT.
+        # The provider's public key set to validate the signature of the JWT.
         # Corresponds to the JSON property `jwksPublicKeys`
         # @return [String]
         attr_accessor :jwks_public_keys
@@ -16909,8 +17108,7 @@ module Google
         end
       end
-      # Commitment for a particular license resource (a License Commitment is composed
-      # of one or more of these).
+      # Commitment for a particular license resource.
       class LicenseResourceCommitment
         include Google::Apis::Core::Hashable
@@ -17085,12 +17283,12 @@ module Google
         # Specifies the number of such disks.
         # Corresponds to the JSON property `diskCount`
-        # @return [String]
+        # @return [Fixnum]
         attr_accessor :disk_count
         # Specifies the size of the disk in base-2 GB.
         # Corresponds to the JSON property `diskSizeGb`
-        # @return [String]
+        # @return [Fixnum]
         attr_accessor :disk_size_gb
         # Specifies the desired disk type on the node. This disk type must be a local
@@ -17404,11 +17602,6 @@ module Google
       class MachineImageList
         include Google::Apis::Core::Hashable
-        #
-        # Corresponds to the JSON property `etag`
-        # @return [String]
-        attr_accessor :etag
         # [Output Only] Unique identifier for the resource; defined by the server.
         # Corresponds to the JSON property `id`
         # @return [String]
@@ -17450,7 +17643,6 @@ module Google
         # Update properties of this object
         def update!(**args)
-          @etag = args[:etag] if args.key?(:etag)
           @id = args[:id] if args.key?(:id)
           @items = args[:items] if args.key?(:items)
           @kind = args[:kind] if args.key?(:kind)
@@ -17527,7 +17719,7 @@ module Google
       # Represents a Machine Type resource.
       # You can use specific machine types for your VM instances based on performance
       # and pricing requirements. For more information, read Machine Types. (==
-      # resource_for v1.machineTypes ==) (== resource_for beta.machineTypes ==)
+      # resource_for `$api_version`.machineTypes ==)
       class MachineType
         include Google::Apis::Core::Hashable
@@ -18291,12 +18483,12 @@ module Google
       # Opaque filter criteria used by loadbalancers to restrict routing configuration
       # to a limited set of loadbalancing proxies. Proxies and sidecars involved in
       # loadbalancing would typically present metadata to the loadbalancers which need
-      # to match criteria specified here. If a match takes place, the relevant routing
+      # to match criteria specified here. If a match takes place, the relevant
       # configuration is made available to those proxies.
       # For each metadataFilter in this list, if its filterMatchCriteria is set to
       # MATCH_ANY, at least one of the filterLabels must match the corresponding label
       # provided in the metadata. If its filterMatchCriteria is set to MATCH_ALL, then
-      # all of its filterLabels must match with corresponding labels in the provided
+      # all of its filterLabels must match with corresponding labels provided in the
       # metadata.
       # An example for using metadataFilters would be: if loadbalancing involves
       # Envoys, they will only receive routing configuration when values in
@@ -18414,8 +18606,8 @@ module Google
       # Represents a VPC Network resource.
       # Networks connect resources to each other and to the internet. For more
-      # information, read Virtual Private Cloud (VPC) Network. (== resource_for v1.
-      # networks ==) (== resource_for beta.networks ==)
+      # information, read Virtual Private Cloud (VPC) Network. (== resource_for `$
+      # api_version`.networks ==)
       class Network
         include Google::Apis::Core::Hashable
@@ -18440,11 +18632,6 @@ module Google
         # @return [String]
         attr_accessor :creation_timestamp
-        # [Output Only] Type of VM-to-VM traffic encryption for this network.
-        # Corresponds to the JSON property `crossVmEncryption`
-        # @return [String]
-        attr_accessor :cross_vm_encryption
         # An optional description of this resource. Provide this field when you create
         # the resource.
         # Corresponds to the JSON property `description`
@@ -18468,13 +18655,8 @@ module Google
         # @return [String]
         attr_accessor :kind
-        # [Output Only] Type of LB-to-VM traffic encryption for this network.
-        # Corresponds to the JSON property `loadBalancerVmEncryption`
-        # @return [String]
-        attr_accessor :load_balancer_vm_encryption
         # Maximum Transmission Unit in bytes. The minimum value for this field is 1460
-        # and the maximum value is 1600 bytes.
+        # and the maximum value is 1500 bytes.
         # Corresponds to the JSON property `mtu`
         # @return [Fixnum]
         attr_accessor :mtu
@@ -18489,7 +18671,7 @@ module Google
         # Name of the resource. Provided by the client when the resource is created. The
         # name must be 1-63 characters long, and comply with RFC1035. Specifically, the
         # name must be 1-63 characters long and match the regular expression `[a-z]([-a-
-        # z0-9]*[a-z0-9])?. The first character must be a lowercase letter, and all
+        # z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all
         # following characters (except for the last character) must be a dash, lowercase
         # letter, or digit. The last character must be a lowercase letter or digit.
         # Corresponds to the JSON property `name`
@@ -18533,12 +18715,10 @@ module Google
           @i_pv4_range = args[:i_pv4_range] if args.key?(:i_pv4_range)
           @auto_create_subnetworks = args[:auto_create_subnetworks] if args.key?(:auto_create_subnetworks)
           @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp)
-          @cross_vm_encryption = args[:cross_vm_encryption] if args.key?(:cross_vm_encryption)
           @description = args[:description] if args.key?(:description)
           @gateway_i_pv4 = args[:gateway_i_pv4] if args.key?(:gateway_i_pv4)
           @id = args[:id] if args.key?(:id)
           @kind = args[:kind] if args.key?(:kind)
-          @load_balancer_vm_encryption = args[:load_balancer_vm_encryption] if args.key?(:load_balancer_vm_encryption)
           @mtu = args[:mtu] if args.key?(:mtu)
           @multicast_mode = args[:multicast_mode] if args.key?(:multicast_mode)
           @name = args[:name] if args.key?(:name)
@@ -18550,7 +18730,7 @@ module Google
         end
       end
-      # The network endpoint.
+      # The network endpoint. Next ID: 7
       class NetworkEndpoint
         include Google::Apis::Core::Hashable
@@ -18605,8 +18785,7 @@ module Google
       # Represents a collection of network endpoints.
       # For more information read Setting up network endpoint groups in load balancing.
-      # (== resource_for v1.networkEndpointGroups ==) (== resource_for beta.
-      # networkEndpointGroups ==)
+      # (== resource_for `$api_version`.networkEndpointGroups ==) Next ID: 21
       class NetworkEndpointGroup
         include Google::Apis::Core::Hashable
@@ -18938,7 +19117,7 @@ module Google
         include Google::Apis::Core::Hashable
         # A user-defined name of the Cloud Function.
-        # The service name must be 1-63 characters long, and comply with RFC1035.
+        # The function name is case-sensitive and must be 1-63 characters long.
         # Example value: "func1".
         # Corresponds to the JSON property `function`
         # @return [String]
@@ -18975,7 +19154,7 @@ module Google
         include Google::Apis::Core::Hashable
         # Cloud Run service is the main resource of Cloud Run.
-        # The tag must be 1-63 characters long, and comply with RFC1035.
+        # The service must be 1-63 characters long, and comply with RFC1035.
         # Example value: "run-service".
         # Corresponds to the JSON property `service`
         # @return [String]
@@ -19242,7 +19421,7 @@ module Google
       class NetworkEndpointGroupsListEndpointsRequestNetworkEndpointFilter
         include Google::Apis::Core::Hashable
-        # The network endpoint.
+        # The network endpoint. Next ID: 7
         # Corresponds to the JSON property `networkEndpoint`
         # @return [Google::Apis::ComputeAlpha::NetworkEndpoint]
         attr_accessor :network_endpoint
@@ -19471,7 +19650,7 @@ module Google
         # @return [Array<Google::Apis::ComputeAlpha::HealthStatusForNetworkEndpoint>]
         attr_accessor :healths
-        # The network endpoint.
+        # The network endpoint. Next ID: 7
         # Corresponds to the JSON property `networkEndpoint`
         # @return [Google::Apis::ComputeAlpha::NetworkEndpoint]
         attr_accessor :network_endpoint
@@ -20000,12 +20179,11 @@ module Google
       # instances only for your specific project. Use sole-tenant nodes to keep your
       # instances physically separated from instances in other projects, or to group
       # your instances together on the same host hardware. For more information, read
-      # Sole-tenant nodes. (== resource_for beta.nodeGroups ==) (== resource_for v1.
-      # nodeGroups ==) NextID: 16
+      # Sole-tenant nodes. (== resource_for `$api_version`.nodeGroups ==)
       class NodeGroup
         include Google::Apis::Core::Hashable
-        #
+        # Specifies how autoscaling should behave.
         # Corresponds to the JSON property `autoscalingPolicy`
         # @return [Google::Apis::ComputeAlpha::NodeGroupAutoscalingPolicy]
         attr_accessor :autoscaling_policy
@@ -20021,6 +20199,12 @@ module Google
         # @return [String]
         attr_accessor :description
+        #
+        # Corresponds to the JSON property `fingerprint`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :fingerprint
         # [Output Only] The unique identifier for the resource. This identifier is
         # defined by the server.
         # Corresponds to the JSON property `id`
@@ -20033,7 +20217,8 @@ module Google
         # @return [String]
         attr_accessor :kind
-        #
+        # Specifies how to handle instances when a node in the group undergoes
+        # maintenance.
         # Corresponds to the JSON property `maintenancePolicy`
         # @return [String]
         attr_accessor :maintenance_policy
@@ -20089,6 +20274,7 @@ module Google
           @autoscaling_policy = args[:autoscaling_policy] if args.key?(:autoscaling_policy)
           @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp)
           @description = args[:description] if args.key?(:description)
+          @fingerprint = args[:fingerprint] if args.key?(:fingerprint)
           @id = args[:id] if args.key?(:id)
           @kind = args[:kind] if args.key?(:kind)
           @maintenance_policy = args[:maintenance_policy] if args.key?(:maintenance_policy)
@@ -20224,17 +20410,17 @@ module Google
       class NodeGroupAutoscalingPolicy
         include Google::Apis::Core::Hashable
-        #
-        # Corresponds to the JSON property `maxSize`
+        # The maximum number of nodes that the group should have.
+        # Corresponds to the JSON property `maxNodes`
         # @return [Fixnum]
-        attr_accessor :max_size
+        attr_accessor :max_nodes
-        #
-        # Corresponds to the JSON property `minSize`
+        # The minimum number of nodes that the group should have.
+        # Corresponds to the JSON property `minNodes`
         # @return [Fixnum]
-        attr_accessor :min_size
+        attr_accessor :min_nodes
-        #
+        # The autoscaling mode.
         # Corresponds to the JSON property `mode`
         # @return [String]
         attr_accessor :mode
@@ -20245,8 +20431,8 @@ module Google
         # Update properties of this object
         def update!(**args)
-          @max_size = args[:max_size] if args.key?(:max_size)
-          @min_size = args[:min_size] if args.key?(:min_size)
+          @max_nodes = args[:max_nodes] if args.key?(:max_nodes)
+          @min_nodes = args[:min_nodes] if args.key?(:min_nodes)
           @mode = args[:mode] if args.key?(:mode)
         end
       end
@@ -20373,6 +20559,11 @@ module Google
       class NodeGroupNode
         include Google::Apis::Core::Hashable
+        # Accelerators for this node.
+        # Corresponds to the JSON property `accelerators`
+        # @return [Array<Google::Apis::ComputeAlpha::AcceleratorConfig>]
+        attr_accessor :accelerators
         # Local disk configurations.
         # Corresponds to the JSON property `disks`
         # @return [Array<Google::Apis::ComputeAlpha::LocalDisk>]
@@ -20414,6 +20605,7 @@ module Google
         # Update properties of this object
         def update!(**args)
+          @accelerators = args[:accelerators] if args.key?(:accelerators)
           @disks = args[:disks] if args.key?(:disks)
           @instances = args[:instances] if args.key?(:instances)
           @name = args[:name] if args.key?(:name)
@@ -20712,11 +20904,16 @@ module Google
       # Represent a sole-tenant Node Template resource.
       # You can use a template to define properties for nodes in a node group. For
-      # more information, read Creating node groups and instances. (== resource_for
-      # beta.nodeTemplates ==) (== resource_for v1.nodeTemplates ==) (== NextID: 16 ==)
+      # more information, read Creating node groups and instances. (== resource_for `$
+      # api_version`.nodeTemplates ==) (== NextID: 18 ==)
       class NodeTemplate
         include Google::Apis::Core::Hashable
+        #
+        # Corresponds to the JSON property `accelerators`
+        # @return [Array<Google::Apis::ComputeAlpha::AcceleratorConfig>]
+        attr_accessor :accelerators
         # [Output Only] Creation timestamp in RFC3339 text format.
         # Corresponds to the JSON property `creationTimestamp`
         # @return [String]
@@ -20817,6 +21014,7 @@ module Google
         # Update properties of this object
         def update!(**args)
+          @accelerators = args[:accelerators] if args.key?(:accelerators)
           @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp)
           @description = args[:description] if args.key?(:description)
           @disks = args[:disks] if args.key?(:disks)
@@ -21198,7 +21396,7 @@ module Google
       # total amount of cores and memory for that node. Currently, the only available
       # node type is n1-node-96-624 node type that has 96 vCPUs and 624 GB of memory,
       # available in multiple zones. For more information read Node types. (==
-      # resource_for beta.nodeTypes ==) (== resource_for v1.nodeTypes ==)
+      # resource_for `$api_version`.nodeTypes ==)
       class NodeType
         include Google::Apis::Core::Hashable
@@ -21865,6 +22063,10 @@ module Google
       end
       # Represents an Operation resource.
+      # Google Compute Engine has three Operation resources:
+      # * [Global](/compute/docs/reference/rest/latest/globalOperations) * [Regional](/
+      # compute/docs/reference/rest/latest/regionOperations) * [Zonal](/compute/docs/
+      # reference/rest/latest/zoneOperations)
       # You can use an operation resource to manage asynchronous API requests. For
       # more information, read Handling API responses.
       # Operations can be global, regional or zonal.
@@ -21872,10 +22074,9 @@ module Google
       # - For regional operations, use the regionOperations resource.
       # - For zonal operations, use the zonalOperations resource.
       # For more information, read  Global, Regional, and Zonal Resources. (==
-      # resource_for v1.globalOperations ==) (== resource_for beta.globalOperations ==)
-      # (== resource_for v1.regionOperations ==) (== resource_for beta.
-      # regionOperations ==) (== resource_for v1.zoneOperations ==) (== resource_for
-      # beta.zoneOperations ==)
+      # resource_for `$api_version`.globalOperations ==) (== resource_for `$
+      # api_version`.regionOperations ==) (== resource_for `$api_version`.
+      # zoneOperations ==)
       class Operation
         include Google::Apis::Core::Hashable
@@ -22715,11 +22916,6 @@ module Google
         # @return [Google::Apis::ComputeAlpha::PacketMirroringForwardingRuleInfo]
         attr_accessor :collector_ilb
-        #
-        # Corresponds to the JSON property `collectors`
-        # @return [Google::Apis::ComputeAlpha::PacketMirroringCollectorInfo]
-        attr_accessor :collectors
         # [Output Only] Creation timestamp in RFC3339 text format.
         # Corresponds to the JSON property `creationTimestamp`
         # @return [String]
@@ -22779,13 +22975,6 @@ module Google
         # @return [Google::Apis::ComputeAlpha::PacketMirroringNetworkInfo]
         attr_accessor :network
-        # PacketMirroring packetMatchers. Each packetMatcher specifies a CIRD filter
-        # that will apply to the source or destination IP in the IP header for the
-        # mirrored VM traffic.
-        # Corresponds to the JSON property `packetMatchers`
-        # @return [Array<Google::Apis::ComputeAlpha::PacketMirroringPacketMatcher>]
-        attr_accessor :packet_matchers
         # The priority of applying this configuration. Priority is used to break ties in
         # cases where there is more than one matching rule. In the case of two rules
         # that apply for a given Instance, the one with the lowest-numbered priority
@@ -22817,7 +23006,6 @@ module Google
         # Update properties of this object
         def update!(**args)
           @collector_ilb = args[:collector_ilb] if args.key?(:collector_ilb)
-          @collectors = args[:collectors] if args.key?(:collectors)
           @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp)
           @description = args[:description] if args.key?(:description)
           @enable = args[:enable] if args.key?(:enable)
@@ -22827,7 +23015,6 @@ module Google
           @mirrored_resources = args[:mirrored_resources] if args.key?(:mirrored_resources)
           @name = args[:name] if args.key?(:name)
           @network = args[:network] if args.key?(:network)
-          @packet_matchers = args[:packet_matchers] if args.key?(:packet_matchers)
           @priority = args[:priority] if args.key?(:priority)
           @region = args[:region] if args.key?(:region)
           @self_link = args[:self_link] if args.key?(:self_link)
@@ -22952,46 +23139,6 @@ module Google
         end
       end
-      #
-      class PacketMirroringCollectorInfo
-        include Google::Apis::Core::Hashable
-        # A set of virtual machines configured as destination of the mirrored traffic.
-        # They must live in zones contained in the same region as this packetMirroring.
-        # Corresponds to the JSON property `instances`
-        # @return [Array<Google::Apis::ComputeAlpha::PacketMirroringCollectorInfoInstanceInfo>]
-        attr_accessor :instances
-        def initialize(**args)
-           update!(**args)
-        end
-        # Update properties of this object
-        def update!(**args)
-          @instances = args[:instances] if args.key?(:instances)
-        end
-      end
-      #
-      class PacketMirroringCollectorInfoInstanceInfo
-        include Google::Apis::Core::Hashable
-        # Resource URL to the virtual machine instance configured as destination of the
-        # mirrored traffic.
-        # Corresponds to the JSON property `url`
-        # @return [String]
-        attr_accessor :url
-        def initialize(**args)
-           update!(**args)
-        end
-        # Update properties of this object
-        def update!(**args)
-          @url = args[:url] if args.key?(:url)
-        end
-      end
       #
       class PacketMirroringFilter
         include Google::Apis::Core::Hashable
@@ -23280,26 +23427,6 @@ module Google
         end
       end
-      #
-      class PacketMirroringPacketMatcher
-        include Google::Apis::Core::Hashable
-        # IP CIDR range that applies as filter on the source or destination IP in the IP
-        # header. Only IPv4 is supported.
-        # Corresponds to the JSON property `cidrRange`
-        # @return [String]
-        attr_accessor :cidr_range
-        def initialize(**args)
-           update!(**args)
-        end
-        # Update properties of this object
-        def update!(**args)
-          @cidr_range = args[:cidr_range] if args.key?(:cidr_range)
-        end
-      end
       #
       class PacketMirroringsScopedList
         include Google::Apis::Core::Hashable
@@ -23463,12 +23590,10 @@ module Google
         # @return [Array<Google::Apis::ComputeAlpha::PathRule>]
         attr_accessor :path_rules
-        # The list of ordered HTTP route rules. Use this list instead of pathRules when
-        # advanced route matching and routing actions are desired. The order of
-        # specifying routeRules matters: the first rule that matches will cause its
-        # specified routing action to take effect.
-        # Within a given pathMatcher, only one of pathRules or routeRules must be set.
-        # routeRules are not supported in UrlMaps intended for External Load balancers.
+        # The list of HTTP route rules. Use this list instead of pathRules when advanced
+        # route matching and routing actions are desired. routeRules are evaluated in
+        # order of priority, from the lowest to highest number.
+        # Within a given pathMatcher, you can set only one of pathRules or routeRules.
         # Corresponds to the JSON property `routeRules`
         # @return [Array<Google::Apis::ComputeAlpha::HttpRouteRule>]
         attr_accessor :route_rules
@@ -23697,32 +23822,34 @@ module Google
         end
       end
-      # Defines an Identity and Access Management (IAM) policy. It is used to specify
-      # access control policies for Cloud Platform resources.
+      # An Identity and Access Management (IAM) policy, which specifies access
+      # controls for Google Cloud resources.
       # A `Policy` is a collection of `bindings`. A `binding` binds one or more `
       # members` to a single `role`. Members can be user accounts, service accounts,
       # Google groups, and domains (such as G Suite). A `role` is a named list of
-      # permissions (defined by IAM or configured by users). A `binding` can
-      # optionally specify a `condition`, which is a logic expression that further
-      # constrains the role binding based on attributes about the request and/or
-      # target resource.
-      # **JSON Example**
+      # permissions; each `role` can be an IAM predefined role or a user-created
+      # custom role.
+      # Optionally, a `binding` can specify a `condition`, which is a logical
+      # expression that allows access to a resource only if the expression evaluates
+      # to `true`. A condition can add constraints based on attributes of the request,
+      # the resource, or both.
+      # **JSON example:**
       # ` "bindings": [ ` "role": "roles/resourcemanager.organizationAdmin", "members":
       # [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "
       # serviceAccount:my-project-id@appspot.gserviceaccount.com" ] `, ` "role": "
       # roles/resourcemanager.organizationViewer", "members": ["user:eve@example.com"],
       # "condition": ` "title": "expirable access", "description": "Does not grant
       # access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:
-      # 00:00.000Z')", ` ` ] `
-      # **YAML Example**
+      # 00:00.000Z')", ` ` ], "etag": "BwWWja0YfJA=", "version": 3 `
+      # **YAML example:**
       # bindings: - members: - user:mike@example.com - group:admins@example.com -
       # domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com
       # role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.
       # com role: roles/resourcemanager.organizationViewer condition: title: expirable
       # access description: Does not grant access after Sep 2020 expression: request.
-      # time < timestamp('2020-10-01T00:00:00.000Z')
-      # For a description of IAM and its features, see the [IAM developer's guide](
-      # https://cloud.google.com/iam/docs).
+      # time < timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3
+      # For a description of IAM and its features, see the [IAM documentation](https://
+      # cloud.google.com/iam/docs/).
       class Policy
         include Google::Apis::Core::Hashable
@@ -23731,9 +23858,9 @@ module Google
         # @return [Array<Google::Apis::ComputeAlpha::AuditConfig>]
         attr_accessor :audit_configs
-        # Associates a list of `members` to a `role`. Optionally may specify a `
-        # condition` that determines when binding is in effect. `bindings` with no
-        # members will result in an error.
+        # Associates a list of `members` to a `role`. Optionally, may specify a `
+        # condition` that determines how and when the `bindings` are applied. Each of
+        # the `bindings` must contain at least one member.
         # Corresponds to the JSON property `bindings`
         # @return [Array<Google::Apis::ComputeAlpha::Binding>]
         attr_accessor :bindings
@@ -23745,10 +23872,10 @@ module Google
         # returned in the response to `getIamPolicy`, and systems are expected to put
         # that etag in the request to `setIamPolicy` to ensure that their change will be
         # applied to the same version of the policy.
-        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
-        # policy is overwritten. Due to blind-set semantics of an etag-less policy, '
-        # setIamPolicy' will not fail even if either of incoming or stored policy does
-        # not meet the version requirements.
+        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you
+        # to overwrite a version `3` policy with a version `1` policy, and all of the
+        # conditions in the version `3` policy are lost.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -23772,15 +23899,20 @@ module Google
         attr_accessor :rules
         # Specifies the format of the policy.
-        # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are
         # rejected.
-        # Operations affecting conditional bindings must specify version 3. This can be
-        # either setting a conditional policy, modifying a conditional binding, or
-        # removing a conditional binding from the stored conditional policy. Operations
-        # on non-conditional policies may specify any valid value or leave the field
-        # unset.
-        # If no etag is provided in the call to `setIamPolicy`, any version compliance
-        # checks on the incoming and/or stored policy is skipped.
+        # Any operation that affects conditional role bindings must specify version `3`.
+        # This requirement applies to the following operations:
+        # * Getting a policy that includes a conditional role binding * Adding a
+        # conditional role binding to a policy * Changing a conditional role binding in
+        # a policy * Removing any role binding, with or without a condition, from a
+        # policy that includes conditions
+        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you
+        # to overwrite a version `3` policy with a version `1` policy, and all of the
+        # conditions in the version `3` policy are lost.
+        # If a policy does not include any conditions, operations on that policy may
+        # specify any valid version or leave the field unset.
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -23961,8 +24093,8 @@ module Google
       # Represents a Project resource.
       # A project is used to organize resources in a Google Cloud Platform environment.
-      # For more information, read about the  Resource Hierarchy. (== resource_for v1.
-      # projects ==) (== resource_for beta.projects ==)
+      # For more information, read about the  Resource Hierarchy. (== resource_for `$
+      # api_version`.projects ==)
       class Project
         include Google::Apis::Core::Hashable
@@ -25070,8 +25202,8 @@ module Google
       # Represents a Region resource.
       # A region is a geographical area where a resource is located. For more
-      # information, read Regions and Zones. (== resource_for beta.regions ==) (==
-      # resource_for v1.regions ==)
+      # information, read Regions and Zones. (== resource_for `$api_version`.regions ==
+      # )
       class Region
         include Google::Apis::Core::Hashable
@@ -26458,32 +26590,34 @@ module Google
         # @return [String]
         attr_accessor :etag
-        # Defines an Identity and Access Management (IAM) policy. It is used to specify
-        # access control policies for Cloud Platform resources.
+        # An Identity and Access Management (IAM) policy, which specifies access
+        # controls for Google Cloud resources.
         # A `Policy` is a collection of `bindings`. A `binding` binds one or more `
         # members` to a single `role`. Members can be user accounts, service accounts,
         # Google groups, and domains (such as G Suite). A `role` is a named list of
-        # permissions (defined by IAM or configured by users). A `binding` can
-        # optionally specify a `condition`, which is a logic expression that further
-        # constrains the role binding based on attributes about the request and/or
-        # target resource.
-        # **JSON Example**
+        # permissions; each `role` can be an IAM predefined role or a user-created
+        # custom role.
+        # Optionally, a `binding` can specify a `condition`, which is a logical
+        # expression that allows access to a resource only if the expression evaluates
+        # to `true`. A condition can add constraints based on attributes of the request,
+        # the resource, or both.
+        # **JSON example:**
         # ` "bindings": [ ` "role": "roles/resourcemanager.organizationAdmin", "members":
         # [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "
         # serviceAccount:my-project-id@appspot.gserviceaccount.com" ] `, ` "role": "
         # roles/resourcemanager.organizationViewer", "members": ["user:eve@example.com"],
         # "condition": ` "title": "expirable access", "description": "Does not grant
         # access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:
-        # 00:00.000Z')", ` ` ] `
-        # **YAML Example**
+        # 00:00.000Z')", ` ` ], "etag": "BwWWja0YfJA=", "version": 3 `
+        # **YAML example:**
         # bindings: - members: - user:mike@example.com - group:admins@example.com -
         # domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com
         # role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.
         # com role: roles/resourcemanager.organizationViewer condition: title: expirable
         # access description: Does not grant access after Sep 2020 expression: request.
-        # time < timestamp('2020-10-01T00:00:00.000Z')
-        # For a description of IAM and its features, see the [IAM developer's guide](
-        # https://cloud.google.com/iam/docs).
+        # time < timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3
+        # For a description of IAM and its features, see the [IAM documentation](https://
+        # cloud.google.com/iam/docs/).
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::ComputeAlpha::Policy]
         attr_accessor :policy
@@ -26525,12 +26659,19 @@ module Google
         include Google::Apis::Core::Hashable
         # Represents a URL Map resource.
-        # A URL map resource is a component of certain types of load balancers. This
-        # resource defines mappings from host names and URL paths to either a backend
-        # service or a backend bucket.
-        # To use this resource, the backend service must have a loadBalancingScheme of
-        # either EXTERNAL, INTERNAL_SELF_MANAGED, or INTERNAL_MANAGED For more
-        # information, read URL Map Concepts.
+        # Google Compute Engine has two URL Map resources:
+        # * [Global](/compute/docs/reference/rest/latest/urlMaps) * [Regional](/compute/
+        # docs/reference/rest/latest/regionUrlMaps)
+        # A URL map resource is a component of certain types of GCP load balancers and
+        # Traffic Director.
+        # * urlMaps are used by external HTTP(S) load balancers and Traffic Director. *
+        # regionUrlMaps are used by internal HTTP(S) load balancers.
+        # This resource defines mappings from host names and URL paths to either a
+        # backend service or a backend bucket.
+        # To use the global urlMaps resource, the backend service must have a
+        # loadBalancingScheme of either EXTERNAL or INTERNAL_SELF_MANAGED. To use the
+        # regionUrlMaps resource, the backend service must have a loadBalancingScheme of
+        # INTERNAL_MANAGED. For more information, read URL Map Concepts.
         # Corresponds to the JSON property `resource`
         # @return [Google::Apis::ComputeAlpha::UrlMap]
         attr_accessor :resource
@@ -26569,8 +26710,8 @@ module Google
       # Represents a reservation resource. A reservation ensures that capacity is held
       # in a specific zone even if the reserved VMs are not running. For more
-      # information, read  Reserving zonal resources. (== resource_for beta.
-      # reservations ==) (== resource_for v1.reservations ==)
+      # information, read  Reserving zonal resources. (== resource_for `$api_version`.
+      # reservations ==)
       class Reservation
         include Google::Apis::Core::Hashable
@@ -27464,11 +27605,10 @@ module Google
         # @return [Fixnum]
         attr_accessor :availability_domain_count
-        # Distribution specifies how the instances are placed at host level. If set to
-        # SPREAD, no two instances will be put on the same host
-        # Corresponds to the JSON property `distribution`
+        # Specifies network collocation
+        # Corresponds to the JSON property `collocation`
         # @return [String]
-        attr_accessor :distribution
+        attr_accessor :collocation
         # Specifies network locality
         # Corresponds to the JSON property `locality`
@@ -27492,7 +27632,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @availability_domain_count = args[:availability_domain_count] if args.key?(:availability_domain_count)
-          @distribution = args[:distribution] if args.key?(:distribution)
+          @collocation = args[:collocation] if args.key?(:collocation)
           @locality = args[:locality] if args.key?(:locality)
           @style = args[:style] if args.key?(:style)
           @vm_count = args[:vm_count] if args.key?(:vm_count)
@@ -27758,7 +27898,7 @@ module Google
       class ResourcePolicySnapshotSchedulePolicySnapshotProperties
         include Google::Apis::Core::Hashable
-        # Indication to perform a ?guest aware? snapshot.
+        # Indication to perform a 'guest aware' snapshot.
         # Corresponds to the JSON property `guestFlush`
         # @return [Boolean]
         attr_accessor :guest_flush
@@ -27916,8 +28056,8 @@ module Google
       # Represents a Route resource.
       # A route defines a path from VM instances in the VPC network to a specific
       # destination. This destination can be inside or outside the VPC network. For
-      # more information, read the Routes overview. (== resource_for beta.routes ==) (=
-      # = resource_for v1.routes ==)
+      # more information, read the Routes overview. (== resource_for `$api_version`.
+      # routes ==)
       class Route
         include Google::Apis::Core::Hashable
@@ -28541,7 +28681,7 @@ module Google
         # peer. Hold time is three times the interval at which keepalive messages are
         # sent, and the hold time is the maximum number of seconds allowed to elapse
         # between successive keepalive messages that BGP receives from a peer. BGP will
-        # use the smaller of either the local hold time value or the peer?s hold time
+        # use the smaller of either the local hold time value or the peer's hold time
         # value as the hold time for the BGP connection between the two peers. If set,
         # this value must be between 1 and 120. The default is 20.
         # Corresponds to the JSON property `keepaliveInterval`
@@ -29525,20 +29665,13 @@ module Google
         # Specifies how port is selected for health checking, can be one of following
         # values:
-        # USE_FIXED_PORT: The port number in
-        # port
-        # is used for health checking.
-        # USE_NAMED_PORT: The
-        # portName
-        # is used for health checking.
+        # USE_FIXED_PORT: The port number in port is used for health checking.
+        # USE_NAMED_PORT: The portName is used for health checking.
         # USE_SERVING_PORT: For NetworkEndpointGroup, the port specified for each
         # network endpoint is used for health checking. For other backends, the port or
         # named port specified in the Backend Service is used for health checking.
-        # If not specified, SSL health check follows behavior specified in
-        # port
-        # and
-        # portName
-        # fields.
+        # If not specified, SSL health check follows behavior specified in port and
+        # portName fields.
         # Corresponds to the JSON property `portSpecification`
         # @return [String]
         attr_accessor :port_specification
@@ -29612,6 +29745,12 @@ module Google
         # @return [Fixnum]
         attr_accessor :disk_size_gb
+        # [Output Only] URL of the disk type resource. For example: projects/project/
+        # zones/zone/diskTypes/pd-standard or pd-ssd
+        # Corresponds to the JSON property `diskType`
+        # @return [String]
+        attr_accessor :disk_type
         # A list of features to enable on the guest operating system. Applicable only
         # for bootable images. Read  Enabling guest operating system features to see a
         # list of available options.
@@ -29682,6 +29821,7 @@ module Google
           @device_name = args[:device_name] if args.key?(:device_name)
           @disk_encryption_key = args[:disk_encryption_key] if args.key?(:disk_encryption_key)
           @disk_size_gb = args[:disk_size_gb] if args.key?(:disk_size_gb)
+          @disk_type = args[:disk_type] if args.key?(:disk_type)
           @guest_os_features = args[:guest_os_features] if args.key?(:guest_os_features)
           @index = args[:index] if args.key?(:index)
           @interface = args[:interface] if args.key?(:interface)
@@ -29861,8 +30001,7 @@ module Google
       # Represents a Cloud Armor Security Policy resource.
       # Only external backend services that use load balancers can reference a
       # Security Policy. For more information, read  Cloud Armor Security Policy
-      # Concepts. (== resource_for v1.securityPolicies ==) (== resource_for beta.
-      # securityPolicies ==)
+      # Concepts. (== resource_for `$api_version`.securityPolicies ==)
       class SecurityPolicy
         include Google::Apis::Core::Hashable
@@ -30248,7 +30387,7 @@ module Google
         attr_accessor :rule_tuple_count
         # 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,
+        # 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.
         # This field may only be specified when versioned_expr is set to FIREWALL.
         # Corresponds to the JSON property `targetResources`
@@ -30851,13 +30990,13 @@ module Google
       # Represents a Persistent Disk Snapshot resource.
       # You can use snapshots to back up data on a regular interval. For more
-      # information, read  Creating persistent disk snapshots. (== resource_for beta.
-      # snapshots ==) (== resource_for v1.snapshots ==)
+      # information, read  Creating persistent disk snapshots. (== resource_for `$
+      # api_version`.snapshots ==)
       class Snapshot
         include Google::Apis::Core::Hashable
-        # [Output Only] Set to true if snapshots are automatically by applying resource
-        # policy on the target disk.
+        # [Output Only] Set to true if snapshots are automatically created by applying
+        # resource policy on the target disk.
         # Corresponds to the JSON property `autoCreated`
         # @return [Boolean]
         attr_accessor :auto_created
@@ -30879,6 +31018,11 @@ module Google
         # @return [Fixnum]
         attr_accessor :disk_size_gb
+        # [Output Only] Number of bytes downloaded to restore a snapshot to a disk.
+        # Corresponds to the JSON property `downloadBytes`
+        # @return [Fixnum]
+        attr_accessor :download_bytes
         # [Output Only] A list of features to enable on the guest operating system.
         # Applicable only for bootable images. Read  Enabling guest operating system
         # features to see a list of available options.
@@ -31007,6 +31151,7 @@ module Google
           @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp)
           @description = args[:description] if args.key?(:description)
           @disk_size_gb = args[:disk_size_gb] if args.key?(:disk_size_gb)
+          @download_bytes = args[:download_bytes] if args.key?(:download_bytes)
           @guest_os_features = args[:guest_os_features] if args.key?(:guest_os_features)
           @id = args[:id] if args.key?(:id)
           @kind = args[:kind] if args.key?(:kind)
@@ -31307,10 +31452,17 @@ module Google
       end
       # Represents an SSL Certificate resource.
+      # Google Compute Engine has two SSL Certificate resources:
+      # * [Global](/compute/docs/reference/rest/latest/sslCertificates) * [Regional](/
+      # compute/docs/reference/rest/latest/regionSslCertificates)
+      # - sslCertificates are used by: - external HTTPS load balancers - SSL proxy
+      # load balancers
+      # - regionSslCertificates are used by: - internal HTTPS load balancers
       # This SSL certificate resource also contains a private key. You can use SSL
       # keys and certificates to secure connections to a load balancer. For more
-      # information, read  Creating and Using SSL Certificates. (== resource_for beta.
-      # sslCertificates ==) (== resource_for v1.sslCertificates ==)
+      # information, read  Creating and Using SSL Certificates. (== resource_for `$
+      # api_version`.sslCertificates ==) (== resource_for `$api_version`.
+      # regionSslCertificates ==) Next ID: 17
       class SslCertificate
         include Google::Apis::Core::Hashable
@@ -31955,8 +32107,7 @@ module Google
       # Represents a Cloud Armor Security Policy resource.
       # Only external backend services used by HTTP or HTTPS load balancers can
       # reference a Security Policy. For more information, read read  Cloud Armor
-      # Security Policy Concepts. (== resource_for beta.sslPolicies ==) (==
-      # resource_for v1.sslPolicies ==)
+      # Security Policy Concepts. (== resource_for `$api_version`.sslPolicies ==)
       class SslPolicy
         include Google::Apis::Core::Hashable
@@ -32224,7 +32375,7 @@ module Google
       # A subnetwork (also known as a subnet) is a logical partition of a Virtual
       # Private Cloud network with one primary IP range and zero or more secondary IP
       # ranges. For more information, read  Virtual Private Cloud (VPC) Network. (==
-      # resource_for beta.subnetworks ==) (== resource_for v1.subnetworks ==)
+      # resource_for `$api_version`.subnetworks ==)
       class Subnetwork
         include Google::Apis::Core::Hashable
@@ -32379,6 +32530,7 @@ module Google
         # @return [String]
         attr_accessor :private_ipv6_google_access
+        # Deprecated in favor of enable PrivateIpv6GoogleAccess on instance directly.
         # The service accounts can be used to selectively turn on Private IPv6 Google
         # Access only on the VMs primary service account matching the value. This value
         # only takes effect when PrivateIpv6GoogleAccess is
@@ -32979,20 +33131,13 @@ module Google
         # Specifies how port is selected for health checking, can be one of following
         # values:
-        # USE_FIXED_PORT: The port number in
-        # port
-        # is used for health checking.
-        # USE_NAMED_PORT: The
-        # portName
-        # is used for health checking.
+        # USE_FIXED_PORT: The port number in port is used for health checking.
+        # USE_NAMED_PORT: The portName is used for health checking.
         # USE_SERVING_PORT: For NetworkEndpointGroup, the port specified for each
         # network endpoint is used for health checking. For other backends, the port or
         # named port specified in the Backend Service is used for health checking.
-        # If not specified, TCP health check follows behavior specified in
-        # port
-        # and
-        # portName
-        # fields.
+        # If not specified, TCP health check follows behavior specified in port and
+        # portName fields.
         # Corresponds to the JSON property `portSpecification`
         # @return [String]
         attr_accessor :port_specification
@@ -33157,11 +33302,16 @@ module Google
       end
       # Represents a Target HTTP Proxy resource.
-      # A target HTTP proxy is a component of certain types of load balancers. Global
-      # forwarding rules reference a target HTTP proxy, and the target proxy then
-      # references a URL map. For more information, read Using Target Proxies. (==
-      # resource_for beta.targetHttpProxies ==) (== resource_for v1.targetHttpProxies =
-      # =)
+      # Google Compute Engine has two Target HTTP Proxy resources:
+      # * [Global](/compute/docs/reference/rest/latest/targetHttpProxies) * [Regional](
+      # /compute/docs/reference/rest/latest/regionTargetHttpProxies)
+      # A target HTTP proxy is a component of GCP HTTP load balancers.
+      # * targetHttpProxies are used by external HTTP load balancers and Traffic
+      # Director. * regionTargetHttpProxies are used by internal HTTP load balancers.
+      # Forwarding rules reference a target HTTP proxy, and the target proxy then
+      # references a URL map. For more information, read Using Target Proxies and
+      # Forwarding rule concepts. (== resource_for `$api_version`.targetHttpProxies ==)
+      # (== resource_for `$api_version`.regionTargetHttpProxies ==)
       class TargetHttpProxy
         include Google::Apis::Core::Hashable
@@ -33614,11 +33764,16 @@ module Google
       end
       # Represents a Target HTTPS Proxy resource.
-      # A target HTTPS proxy is a component of certain types of load balancers. Global
-      # forwarding rules reference a target HTTPS proxy, and the target proxy then
-      # references a URL map. For more information, read Using Target Proxies. (==
-      # resource_for beta.targetHttpsProxies ==) (== resource_for v1.
-      # targetHttpsProxies ==)
+      # Google Compute Engine has two Target HTTPS Proxy resources:
+      # * [Global](/compute/docs/reference/rest/latest/targetHttpsProxies) * [Regional]
+      # (/compute/docs/reference/rest/latest/regionTargetHttpsProxies)
+      # A target HTTPS proxy is a component of GCP HTTPS load balancers.
+      # * targetHttpsProxies are used by external HTTPS load balancers. *
+      # regionTargetHttpsProxies are used by internal HTTPS load balancers.
+      # Forwarding rules reference a target HTTPS proxy, and the target proxy then
+      # references a URL map. For more information, read Using Target Proxies and
+      # Forwarding rule concepts. (== resource_for `$api_version`.targetHttpsProxies ==
+      # ) (== resource_for `$api_version`.regionTargetHttpsProxies ==)
       class TargetHttpsProxy
         include Google::Apis::Core::Hashable
@@ -33978,8 +34133,7 @@ module Google
       # You can use a target instance to handle traffic for one or more forwarding
       # rules, which is ideal for forwarding protocol traffic that is managed by a
       # single source. For example, ESP, AH, TCP, or UDP. For more information, read
-      # Target instances. (== resource_for beta.targetInstances ==) (== resource_for
-      # v1.targetInstances ==)
+      # Target instances. (== resource_for `$api_version`.targetInstances ==)
       class TargetInstance
         include Google::Apis::Core::Hashable
@@ -34034,6 +34188,13 @@ module Google
         # @return [String]
         attr_accessor :nat_policy
+        # The URL of the network this target instance uses to forward traffic. If not
+        # specified, the traffic will be forwarded to the network that the default
+        # network interface belongs to.
+        # Corresponds to the JSON property `network`
+        # @return [String]
+        attr_accessor :network
         # [Output Only] Server-defined URL for the resource.
         # Corresponds to the JSON property `selfLink`
         # @return [String]
@@ -34064,6 +34225,7 @@ module Google
           @kind = args[:kind] if args.key?(:kind)
           @name = args[:name] if args.key?(:name)
           @nat_policy = args[:nat_policy] if args.key?(:nat_policy)
+          @network = args[:network] if args.key?(:network)
           @self_link = args[:self_link] if args.key?(:self_link)
           @self_link_with_id = args[:self_link_with_id] if args.key?(:self_link_with_id)
           @zone = args[:zone] if args.key?(:zone)
@@ -34399,8 +34561,7 @@ module Google
       # Target pools are used for network TCP/UDP load balancing. A target pool
       # references member instances, an associated legacy HttpHealthCheck resource,
       # and, optionally, a backup target pool. For more information, read Using target
-      # pools. (== resource_for beta.targetPools ==) (== resource_for v1.targetPools ==
-      # )
+      # pools. (== resource_for `$api_version`.targetPools ==)
       class TargetPool
         include Google::Apis::Core::Hashable
@@ -35049,8 +35210,7 @@ module Google
       # A target SSL proxy is a component of a SSL Proxy load balancer. Global
       # forwarding rules reference a target SSL proxy, and the target proxy then
       # references an external backend service. For more information, read Using
-      # Target Proxies. (== resource_for beta.targetSslProxies ==) (== resource_for v1.
-      # targetSslProxies ==)
+      # Target Proxies. (== resource_for `$api_version`.targetSslProxies ==)
       class TargetSslProxy
         include Google::Apis::Core::Hashable
@@ -35296,8 +35456,7 @@ module Google
       # A target TCP proxy is a component of a TCP Proxy load balancer. Global
       # forwarding rules reference target TCP proxy, and the target proxy then
       # references an external backend service. For more information, read TCP Proxy
-      # Load Balancing Concepts. (== resource_for beta.targetTcpProxies ==) (==
-      # resource_for v1.targetTcpProxies ==)
+      # Load Balancing Concepts. (== resource_for `$api_version`.targetTcpProxies ==)
       class TargetTcpProxy
         include Google::Apis::Core::Hashable
@@ -35486,8 +35645,8 @@ module Google
       # Represents a Target VPN Gateway resource.
       # The target VPN gateway resource represents a Classic Cloud VPN gateway. For
-      # more information, read the the Cloud VPN Overview. (== resource_for beta.
-      # targetVpnGateways ==) (== resource_for v1.targetVpnGateways ==)
+      # more information, read the the Cloud VPN Overview. (== resource_for `$
+      # api_version`.targetVpnGateways ==)
       class TargetVpnGateway
         include Google::Apis::Core::Hashable
@@ -36162,13 +36321,53 @@ module Google
         end
       end
+      # Upcoming Maintenance notification information.
+      class UpcomingMaintenance
+        include Google::Apis::Core::Hashable
+        # [Output Only] The date when the maintenance will take place. This value is in
+        # RFC3339 text format.
+        # Corresponds to the JSON property `date`
+        # @return [String]
+        attr_accessor :date
+        # [Output Only] The time when the maintenance will take place. This value is in
+        # RFC3339 text format.
+        # Corresponds to the JSON property `time`
+        # @return [String]
+        attr_accessor :time
+        # Defines the type of maintenance.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @date = args[:date] if args.key?(:date)
+          @time = args[:time] if args.key?(:time)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
       # Represents a URL Map resource.
-      # A URL map resource is a component of certain types of load balancers. This
-      # resource defines mappings from host names and URL paths to either a backend
-      # service or a backend bucket.
-      # To use this resource, the backend service must have a loadBalancingScheme of
-      # either EXTERNAL, INTERNAL_SELF_MANAGED, or INTERNAL_MANAGED For more
-      # information, read URL Map Concepts.
+      # Google Compute Engine has two URL Map resources:
+      # * [Global](/compute/docs/reference/rest/latest/urlMaps) * [Regional](/compute/
+      # docs/reference/rest/latest/regionUrlMaps)
+      # A URL map resource is a component of certain types of GCP load balancers and
+      # Traffic Director.
+      # * urlMaps are used by external HTTP(S) load balancers and Traffic Director. *
+      # regionUrlMaps are used by internal HTTP(S) load balancers.
+      # This resource defines mappings from host names and URL paths to either a
+      # backend service or a backend bucket.
+      # To use the global urlMaps resource, the backend service must have a
+      # loadBalancingScheme of either EXTERNAL or INTERNAL_SELF_MANAGED. To use the
+      # regionUrlMaps resource, the backend service must have a loadBalancingScheme of
+      # INTERNAL_MANAGED. For more information, read URL Map Concepts.
       class UrlMap
         include Google::Apis::Core::Hashable
@@ -36744,12 +36943,19 @@ module Google
         include Google::Apis::Core::Hashable
         # Represents a URL Map resource.
-        # A URL map resource is a component of certain types of load balancers. This
-        # resource defines mappings from host names and URL paths to either a backend
-        # service or a backend bucket.
-        # To use this resource, the backend service must have a loadBalancingScheme of
-        # either EXTERNAL, INTERNAL_SELF_MANAGED, or INTERNAL_MANAGED For more
-        # information, read URL Map Concepts.
+        # Google Compute Engine has two URL Map resources:
+        # * [Global](/compute/docs/reference/rest/latest/urlMaps) * [Regional](/compute/
+        # docs/reference/rest/latest/regionUrlMaps)
+        # A URL map resource is a component of certain types of GCP load balancers and
+        # Traffic Director.
+        # * urlMaps are used by external HTTP(S) load balancers and Traffic Director. *
+        # regionUrlMaps are used by internal HTTP(S) load balancers.
+        # This resource defines mappings from host names and URL paths to either a
+        # backend service or a backend bucket.
+        # To use the global urlMaps resource, the backend service must have a
+        # loadBalancingScheme of either EXTERNAL or INTERNAL_SELF_MANAGED. To use the
+        # regionUrlMaps resource, the backend service must have a loadBalancingScheme of
+        # INTERNAL_MANAGED. For more information, read URL Map Concepts.
         # Corresponds to the JSON property `resource`
         # @return [Google::Apis::ComputeAlpha::UrlMap]
         attr_accessor :resource
@@ -37230,7 +37436,7 @@ module Google
         end
       end
-      # Represents a VPN gateway resource.
+      # Represents a VPN gateway resource. Next ID: 13
       class VpnGateway
         include Google::Apis::Core::Hashable
@@ -37821,7 +38027,7 @@ module Google
       # Represents a Cloud VPN Tunnel resource.
       # For more information about VPN, read the the Cloud VPN Overview. (==
-      # resource_for beta.vpnTunnels ==) (== resource_for v1.vpnTunnels ==)
+      # resource_for `$api_version`.vpnTunnels ==)
       class VpnTunnel
         include Google::Apis::Core::Hashable
@@ -38608,8 +38814,7 @@ module Google
       # Represents a Zone resource.
       # A zone is a deployment area. These deployment areas are subsets of a region.
       # For example the zone us-east1-a is located in the us-east1 region. For more
-      # information, read Regions and Zones. (== resource_for beta.zones ==) (==
-      # resource_for v1.zones ==)
+      # information, read Regions and Zones. (== resource_for `$api_version`.zones ==)
       class Zone
         include Google::Apis::Core::Hashable
@@ -38847,32 +39052,34 @@ module Google
         # @return [String]
         attr_accessor :etag
-        # Defines an Identity and Access Management (IAM) policy. It is used to specify
-        # access control policies for Cloud Platform resources.
+        # An Identity and Access Management (IAM) policy, which specifies access
+        # controls for Google Cloud resources.
         # A `Policy` is a collection of `bindings`. A `binding` binds one or more `
         # members` to a single `role`. Members can be user accounts, service accounts,
         # Google groups, and domains (such as G Suite). A `role` is a named list of
-        # permissions (defined by IAM or configured by users). A `binding` can
-        # optionally specify a `condition`, which is a logic expression that further
-        # constrains the role binding based on attributes about the request and/or
-        # target resource.
-        # **JSON Example**
+        # permissions; each `role` can be an IAM predefined role or a user-created
+        # custom role.
+        # Optionally, a `binding` can specify a `condition`, which is a logical
+        # expression that allows access to a resource only if the expression evaluates
+        # to `true`. A condition can add constraints based on attributes of the request,
+        # the resource, or both.
+        # **JSON example:**
         # ` "bindings": [ ` "role": "roles/resourcemanager.organizationAdmin", "members":
         # [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "
         # serviceAccount:my-project-id@appspot.gserviceaccount.com" ] `, ` "role": "
         # roles/resourcemanager.organizationViewer", "members": ["user:eve@example.com"],
         # "condition": ` "title": "expirable access", "description": "Does not grant
         # access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:
-        # 00:00.000Z')", ` ` ] `
-        # **YAML Example**
+        # 00:00.000Z')", ` ` ], "etag": "BwWWja0YfJA=", "version": 3 `
+        # **YAML example:**
         # bindings: - members: - user:mike@example.com - group:admins@example.com -
         # domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com
         # role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.
         # com role: roles/resourcemanager.organizationViewer condition: title: expirable
         # access description: Does not grant access after Sep 2020 expression: request.
-        # time < timestamp('2020-10-01T00:00:00.000Z')
-        # For a description of IAM and its features, see the [IAM developer's guide](
-        # https://cloud.google.com/iam/docs).
+        # time < timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3
+        # For a description of IAM and its features, see the [IAM documentation](https://
+        # cloud.google.com/iam/docs/).
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::ComputeAlpha::Policy]
         attr_accessor :policy