google-api-client 0.36.4 → 0.37.0

data/generated/google/apis/compute_alpha/representations.rb

@@ -1018,6 +1018,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleDuration
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GrpcServiceConfig
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -4882,6 +4888,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class UpcomingMaintenance
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class UrlMap
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -5851,6 +5863,8 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :max_scaled_down_replicas, as: 'maxScaledDownReplicas', class: Google::Apis::ComputeAlpha::FixedOrPercent, decorator: Google::Apis::ComputeAlpha::FixedOrPercent::Representation
       
+          property :time_window, as: 'timeWindow', class: Google::Apis::ComputeAlpha::GoogleDuration, decorator: Google::Apis::ComputeAlpha::GoogleDuration::Representation
+      
           property :time_window_sec, as: 'timeWindowSec'
         end
       end
@@ -6273,7 +6287,7 @@ module Google
           property :end_timestamp, as: 'endTimestamp'
           property :id, :numeric_string => true, as: 'id'
           property :kind, as: 'kind'
-          collection :license_resources, as: 'licenseResources', class: Google::Apis::ComputeAlpha::LicenseResourceCommitment, decorator: Google::Apis::ComputeAlpha::LicenseResourceCommitment::Representation
+          property :license_resource, as: 'licenseResource', class: Google::Apis::ComputeAlpha::LicenseResourceCommitment, decorator: Google::Apis::ComputeAlpha::LicenseResourceCommitment::Representation
       
           property :name, as: 'name'
           property :plan, as: 'plan'
@@ -7176,6 +7190,14 @@ module Google
         end
       end
       
+      class GoogleDuration
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :nanos, as: 'nanos'
+          property :seconds, :numeric_string => true, as: 'seconds'
+        end
+      end
+      
       class GrpcServiceConfig
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -7347,6 +7369,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :creation_timestamp, as: 'creationTimestamp'
           property :description, as: 'description'
+          property :fingerprint, :base64 => true, as: 'fingerprint'
           collection :health_checks, as: 'healthChecks'
           property :health_status_aggregation_policy, as: 'healthStatusAggregationPolicy'
           property :health_status_aggregation_strategy, as: 'healthStatusAggregationStrategy'
@@ -7881,6 +7904,7 @@ module Google
       
           property :post_key_revocation_action_type, as: 'postKeyRevocationActionType'
           property :preserved_state_size_gb, :numeric_string => true, as: 'preservedStateSizeGb'
+          property :private_ipv6_google_access, as: 'privateIpv6GoogleAccess'
           property :reservation_affinity, as: 'reservationAffinity', class: Google::Apis::ComputeAlpha::ReservationAffinity, decorator: Google::Apis::ComputeAlpha::ReservationAffinity::Representation
       
           collection :resource_policies, as: 'resourcePolicies'
@@ -7906,6 +7930,8 @@ module Google
           property :status_message, as: 'statusMessage'
           property :tags, as: 'tags', class: Google::Apis::ComputeAlpha::Tags, decorator: Google::Apis::ComputeAlpha::Tags::Representation
       
+          property :upcoming_maintenance, as: 'upcomingMaintenance', class: Google::Apis::ComputeAlpha::UpcomingMaintenance, decorator: Google::Apis::ComputeAlpha::UpcomingMaintenance::Representation
+      
           property :zone, as: 'zone'
         end
       end
@@ -8601,6 +8627,7 @@ module Google
           collection :network_interfaces, as: 'networkInterfaces', class: Google::Apis::ComputeAlpha::NetworkInterface, decorator: Google::Apis::ComputeAlpha::NetworkInterface::Representation
       
           property :post_key_revocation_action_type, as: 'postKeyRevocationActionType'
+          property :private_ipv6_google_access, as: 'privateIpv6GoogleAccess'
           property :reservation_affinity, as: 'reservationAffinity', class: Google::Apis::ComputeAlpha::ReservationAffinity, decorator: Google::Apis::ComputeAlpha::ReservationAffinity::Representation
       
           collection :resource_policies, as: 'resourcePolicies'
@@ -9721,12 +9748,10 @@ module Google
           property :i_pv4_range, as: 'IPv4Range'
           property :auto_create_subnetworks, as: 'autoCreateSubnetworks'
           property :creation_timestamp, as: 'creationTimestamp'
-          property :cross_vm_encryption, as: 'crossVmEncryption'
           property :description, as: 'description'
           property :gateway_i_pv4, as: 'gatewayIPv4'
           property :id, :numeric_string => true, as: 'id'
           property :kind, as: 'kind'
-          property :load_balancer_vm_encryption, as: 'loadBalancerVmEncryption'
           property :mtu, as: 'mtu'
           property :multicast_mode, as: 'multicastMode'
           property :name, as: 'name'
@@ -10201,6 +10226,8 @@ module Google
       class NodeGroupNode
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          collection :accelerators, as: 'accelerators', class: Google::Apis::ComputeAlpha::AcceleratorConfig, decorator: Google::Apis::ComputeAlpha::AcceleratorConfig::Representation
+      
           collection :disks, as: 'disks', class: Google::Apis::ComputeAlpha::LocalDisk, decorator: Google::Apis::ComputeAlpha::LocalDisk::Representation
       
           collection :instances, as: 'instances'
@@ -10305,6 +10332,8 @@ module Google
       class NodeTemplate
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          collection :accelerators, as: 'accelerators', class: Google::Apis::ComputeAlpha::AcceleratorConfig, decorator: Google::Apis::ComputeAlpha::AcceleratorConfig::Representation
+      
           property :creation_timestamp, as: 'creationTimestamp'
           property :description, as: 'description'
           collection :disks, as: 'disks', class: Google::Apis::ComputeAlpha::LocalDisk, decorator: Google::Apis::ComputeAlpha::LocalDisk::Representation
@@ -13683,6 +13712,7 @@ module Google
           property :kind, as: 'kind'
           property :name, as: 'name'
           property :nat_policy, as: 'natPolicy'
+          property :network, as: 'network'
           property :self_link, as: 'selfLink'
           property :self_link_with_id, as: 'selfLinkWithId'
           property :zone, as: 'zone'
@@ -14253,6 +14283,15 @@ module Google
         end
       end
       
+      class UpcomingMaintenance
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :date, as: 'date'
+          property :time, as: 'time'
+          property :type, as: 'type'
+        end
+      end
+      
       class UrlMap
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/generated/google/apis/compute_alpha/service.rb

@@ -5570,14 +5570,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Waits for the specified Operations resource until it is done or timeout, and
-        # retrieves the specified Operations resource. 1. Immediately returns when the
-        # operation is already done. 2. Waits for no more than the default deadline (2
-        # minutes, subject to change) and then returns the current state of the
-        # operation, which may be DONE or still in progress. 3. Is best-effort: a. The
-        # server can wait less than the default deadline or zero seconds, in overload
-        # situations. b. There is no guarantee that the operation is actually done when
-        # returns. 4. User should be prepared to retry if the operation is not DONE.
+        # Waits for the specified Operation resource to return as DONE or for the
+        # request to approach the 2 minute deadline, and retrieves the specified
+        # Operation resource. This method differs from the GET method in that it waits
+        # for no more than the default deadline (2 minutes) and then returns the current
+        # state of the operation, which might be DONE or still in progress.
+        # This method is called on a best-effort basis. Specifically:
+        # - In uncommon cases, when the server is overloaded, the request might return
+        # before the default deadline is reached, or might return after zero seconds.
+        # - If the default deadline is reached, there is no guarantee that the operation
+        # is actually done when the method returns. Be prepared to retry if the
+        # operation is not DONE.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] operation
@@ -5756,14 +5759,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Waits for the specified Operations resource until it is done or timeout, and
-        # retrieves the specified Operations resource. 1. Immediately returns when the
-        # operation is already done. 2. Waits for no more than the default deadline (2
-        # minutes, subject to change) and then returns the current state of the
-        # operation, which may be DONE or still in progress. 3. Is best-effort: a. The
-        # server can wait less than the default deadline or zero seconds, in overload
-        # situations. b. There is no guarantee that the operation is actually done when
-        # returns. 4. User should be prepared to retry if the operation is not DONE.
+        # Waits for the specified Operation resource to return as DONE or for the
+        # request to approach the 2 minute deadline, and retrieves the specified
+        # Operation resource. This method differs from the GET method in that it waits
+        # for no more than the default deadline (2 minutes) and then returns the current
+        # state of the operation, which might be DONE or still in progress.
+        # This method is called on a best-effort basis. Specifically:
+        # - In uncommon cases, when the server is overloaded, the request might return
+        # before the default deadline is reached, or might return after zero seconds.
+        # - If the default deadline is reached, there is no guarantee that the operation
+        # is actually done when the method returns. Be prepared to retry if the
+        # operation is not DONE.
         # @param [String] operation
         #   Name of the Operations resource to return.
         # @param [String] parent_id
@@ -21885,6 +21891,63 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Updates the specified regional HealthCheckService resource with the data
+        # included in the request. This method supports PATCH semantics and uses the
+        # JSON merge patch format and processing rules.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] region
+        #   Name of the region scoping this request.
+        # @param [String] health_check_service
+        #   Name of the HealthCheckService to update. The name must be 1-63 characters
+        #   long, and comply with RFC1035.
+        # @param [Google::Apis::ComputeAlpha::HealthCheckService] health_check_service_object
+        # @param [String] request_id
+        #   An optional request ID to identify requests. Specify a unique request ID so
+        #   that if you must retry your request, the server will know to ignore the
+        #   request if it has already been completed.
+        #   For example, consider a situation where you make an initial request and the
+        #   request times out. If you make the request again with the same request ID, the
+        #   server can check if original operation with the same request ID was received,
+        #   and if so, will ignore the second request. This prevents clients from
+        #   accidentally creating duplicate commitments.
+        #   The request ID must be a valid UUID with the exception that zero UUID is not
+        #   supported (00000000-0000-0000-0000-000000000000).
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeAlpha::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeAlpha::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def patch_region_health_check_service(project, region, health_check_service, health_check_service_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:patch, '{project}/regions/{region}/healthCheckServices/{healthCheckService}', options)
+          command.request_representation = Google::Apis::ComputeAlpha::HealthCheckService::Representation
+          command.request_object = health_check_service_object
+          command.response_representation = Google::Apis::ComputeAlpha::Operation::Representation
+          command.response_class = Google::Apis::ComputeAlpha::Operation
+          command.params['project'] = project unless project.nil?
+          command.params['region'] = region unless region.nil?
+          command.params['healthCheckService'] = health_check_service unless health_check_service.nil?
+          command.query['requestId'] = request_id unless request_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Returns permissions that a caller has on the specified resource.
         # @param [String] project
         #   Project ID for this request.
@@ -24513,14 +24576,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Waits for the specified region-specific Operations resource until it is done
-        # or timeout, and retrieves the specified Operations resource. 1. Immediately
-        # returns when the operation is already done. 2. Waits for no more than the
-        # default deadline (2 minutes, subject to change) and then returns the current
-        # state of the operation, which may be DONE or still in progress. 3. Is best-
-        # effort: a. The server can wait less than the default deadline or zero seconds,
-        # in overload situations. b. There is no guarantee that the operation is
-        # actually done when returns. 4. User should be prepared to retry if the
+        # Waits for the specified Operation resource to return as DONE or for the
+        # request to approach the 2 minute deadline, and retrieves the specified
+        # Operation resource. This method differs from the GET method in that it waits
+        # for no more than the default deadline (2 minutes) and then returns the current
+        # state of the operation, which might be DONE or still in progress.
+        # This method is called on a best-effort basis. Specifically:
+        # - In uncommon cases, when the server is overloaded, the request might return
+        # before the default deadline is reached, or might return after zero seconds.
+        # - If the default deadline is reached, there is no guarantee that the operation
+        # is actually done when the method returns. Be prepared to retry if the
         # operation is not DONE.
         # @param [String] project
         #   Project ID for this request.
@@ -34649,14 +34714,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Waits for the specified zone-specific Operations resource until it is done or
-        # timeout, and retrieves the specified Operations resource. 1. Immediately
-        # returns when the operation is already done. 2. Waits for no more than the
-        # default deadline (2 minutes, subject to change) and then returns the current
-        # state of the operation, which may be DONE or still in progress. 3. Is best-
-        # effort: a. The server can wait less than the default deadline or zero seconds,
-        # in overload situations. b. There is no guarantee that the operation is
-        # actually done when returns. 4. User should be prepared to retry if the
+        # Waits for the specified Operation resource to return as DONE or for the
+        # request to approach the 2 minute deadline, and retrieves the specified
+        # Operation resource. This method differs from the GET method in that it waits
+        # for no more than the default deadline (2 minutes) and then returns the current
+        # state of the operation, which might be DONE or still in progress.
+        # This method is called on a best-effort basis. Specifically:
+        # - In uncommon cases, when the server is overloaded, the request might return
+        # before the default deadline is reached, or might return after zero seconds.
+        # - If the default deadline is reached, there is no guarantee that the operation
+        # is actually done when the method returns. Be prepared to retry if the
         # operation is not DONE.
         # @param [String] project
         #   Project ID for this request.

data/generated/google/apis/compute_beta.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/compute/docs/reference/latest/
     module ComputeBeta
       VERSION = 'Beta'
-      REVISION = '20191125'
+      REVISION = '20200114'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/compute_beta/classes.rb

@@ -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
       
@@ -527,21 +526,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
       
@@ -1196,6 +1196,11 @@ module Google
         # @return [Google::Apis::ComputeBeta::CustomerEncryptionKey]
         attr_accessor :disk_encryption_key
       
+        # The size of the disk in GB.
+        # Corresponds to the JSON property `diskSizeGb`
+        # @return [Fixnum]
+        attr_accessor :disk_size_gb
+      
         # 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.
@@ -1274,6 +1279,7 @@ module Google
           @boot = args[:boot] if args.key?(:boot)
           @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)
           @guest_os_features = args[:guest_os_features] if args.key?(:guest_os_features)
           @index = args[:index] if args.key?(:index)
           @initialize_params = args[:initialize_params] if args.key?(:initialize_params)
@@ -1520,14 +1526,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
       
@@ -2080,6 +2088,13 @@ module Google
         # @return [String]
         attr_accessor :mode
       
+        # Configuration that allows for slower scale down so that even if Autoscaler
+        # recommends an abrupt scale down of a MIG, it will be throttled as specified by
+        # the parameters below.
+        # Corresponds to the JSON property `scaleDownControl`
+        # @return [Google::Apis::ComputeBeta::AutoscalingPolicyScaleDownControl]
+        attr_accessor :scale_down_control
+      
         def initialize(**args)
            update!(**args)
         end
@@ -2093,6 +2108,7 @@ module Google
           @max_num_replicas = args[:max_num_replicas] if args.key?(:max_num_replicas)
           @min_num_replicas = args[:min_num_replicas] if args.key?(:min_num_replicas)
           @mode = args[:mode] if args.key?(:mode)
+          @scale_down_control = args[:scale_down_control] if args.key?(:scale_down_control)
         end
       end
       
@@ -2230,6 +2246,62 @@ module Google
         end
       end
       
+      # Configuration that allows for slower scale down so that even if Autoscaler
+      # recommends an abrupt scale down of a MIG, it will be throttled as specified by
+      # the parameters below.
+      class AutoscalingPolicyScaleDownControl
+        include Google::Apis::Core::Hashable
+      
+        # Encapsulates numeric value that can be either absolute or relative.
+        # Corresponds to the JSON property `maxScaledDownReplicas`
+        # @return [Google::Apis::ComputeBeta::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::ComputeBeta::GoogleDuration]
+        attr_accessor :time_window
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # 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)
+        end
+      end
+      
       # Message containing information of one individual backend.
       class Backend
         include Google::Apis::Core::Hashable
@@ -2635,8 +2707,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
       
@@ -2714,9 +2790,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`
@@ -3116,6 +3194,11 @@ module Google
       class BackendServiceGroupHealth
         include Google::Apis::Core::Hashable
       
+        # Metadata defined as annotations on the network endpoint group.
+        # Corresponds to the JSON property `annotations`
+        # @return [Hash<String,String>]
+        attr_accessor :annotations
+      
         # Health state of the backend instances or endpoints in requested instance or
         # network endpoint group, determined based on configured health checks.
         # Corresponds to the JSON property `healthStatus`
@@ -3134,6 +3217,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @annotations = args[:annotations] if args.key?(:annotations)
           @health_status = args[:health_status] if args.key?(:health_status)
           @kind = args[:kind] if args.key?(:kind)
         end
@@ -3710,7 +3794,7 @@ module Google
         # * `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,`
+        # 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.
@@ -3894,8 +3978,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
       
@@ -4525,8 +4609,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
@@ -4684,15 +4768,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
       
@@ -5284,14 +5370,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
       
@@ -6152,7 +6240,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
@@ -6261,7 +6349,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]
@@ -6796,6 +6884,13 @@ module Google
         attr_accessor :enable
         alias_method :enable?, :enable
       
+        # This field can only be specified for a particular firewall rule if logging is
+        # enabled for that rule. This field denotes whether to include or exclude
+        # metadata for firewall logs.
+        # Corresponds to the JSON property `metadata`
+        # @return [String]
+        attr_accessor :metadata
+      
         def initialize(**args)
            update!(**args)
         end
@@ -6803,6 +6898,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @enable = args[:enable] if args.key?(:enable)
+          @metadata = args[:metadata] if args.key?(:metadata)
         end
       end
       
@@ -6847,16 +6943,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
       
@@ -6991,13 +7089,20 @@ 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]
@@ -7131,8 +7236,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
@@ -7518,6 +7623,44 @@ module Google
         end
       end
       
+      # 
+      class GlobalNetworkEndpointGroupsAttachEndpointsRequest
+        include Google::Apis::Core::Hashable
+      
+        # The list of network endpoints to be attached.
+        # Corresponds to the JSON property `networkEndpoints`
+        # @return [Array<Google::Apis::ComputeBeta::NetworkEndpoint>]
+        attr_accessor :network_endpoints
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @network_endpoints = args[:network_endpoints] if args.key?(:network_endpoints)
+        end
+      end
+      
+      # 
+      class GlobalNetworkEndpointGroupsDetachEndpointsRequest
+        include Google::Apis::Core::Hashable
+      
+        # The list of network endpoints to be detached.
+        # Corresponds to the JSON property `networkEndpoints`
+        # @return [Array<Google::Apis::ComputeBeta::NetworkEndpoint>]
+        attr_accessor :network_endpoints
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @network_endpoints = args[:network_endpoints] if args.key?(:network_endpoints)
+        end
+      end
+      
       # 
       class GlobalSetLabelsRequest
         include Google::Apis::Core::Hashable
@@ -7616,6 +7759,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
+      
       # A guest attributes entry.
       class GuestAttributes
         include Google::Apis::Core::Hashable
@@ -7762,20 +7965,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
@@ -7839,20 +8035,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
@@ -7916,20 +8105,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
@@ -7969,8 +8151,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
@@ -8024,6 +8210,12 @@ module Google
         # @return [String]
         attr_accessor :kind
       
+        # Configuration of logging on a health check. If logging is enabled, logs will
+        # be exported to Stackdriver.
+        # Corresponds to the JSON property `logConfig`
+        # @return [Google::Apis::ComputeBeta::HealthCheckLogConfig]
+        attr_accessor :log_config
+      
         # 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-
@@ -8090,6 +8282,7 @@ module Google
           @https_health_check = args[:https_health_check] if args.key?(:https_health_check)
           @id = args[:id] if args.key?(:id)
           @kind = args[:kind] if args.key?(:kind)
+          @log_config = args[:log_config] if args.key?(:log_config)
           @name = args[:name] if args.key?(:name)
           @region = args[:region] if args.key?(:region)
           @self_link = args[:self_link] if args.key?(:self_link)
@@ -8218,30 +8411,304 @@ module Google
         end
       end
       
-      # A full or valid partial URL to a health check. For example, the following are
-      # valid URLs:
-      # - https://www.googleapis.com/compute/beta/projects/project-id/global/
-      # httpHealthChecks/health-check
-      # - projects/project-id/global/httpHealthChecks/health-check
-      # - global/httpHealthChecks/health-check
-      class HealthCheckReference
-        include Google::Apis::Core::Hashable
-      
-        # 
-        # Corresponds to the JSON property `healthCheck`
-        # @return [String]
-        attr_accessor :health_check
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @health_check = args[:health_check] if args.key?(:health_check)
-        end
-      end
-      
+      # Configuration of logging on a health check. If logging is enabled, logs will
+      # be exported to Stackdriver.
+      class HealthCheckLogConfig
+        include Google::Apis::Core::Hashable
+      
+        # Indicates whether or not to export logs. This is false by default, which means
+        # no health check logging will be done.
+        # Corresponds to the JSON property `enable`
+        # @return [Boolean]
+        attr_accessor :enable
+        alias_method :enable?, :enable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @enable = args[:enable] if args.key?(:enable)
+        end
+      end
+      
+      # A full or valid partial URL to a health check. For example, the following are
+      # valid URLs:
+      # - https://www.googleapis.com/compute/beta/projects/project-id/global/
+      # httpHealthChecks/health-check
+      # - projects/project-id/global/httpHealthChecks/health-check
+      # - global/httpHealthChecks/health-check
+      class HealthCheckReference
+        include Google::Apis::Core::Hashable
+      
+        # 
+        # Corresponds to the JSON property `healthCheck`
+        # @return [String]
+        attr_accessor :health_check
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @health_check = args[:health_check] if args.key?(:health_check)
+        end
+      end
+      
+      # A HealthCheckService defines a set of backends on which to perform periodic
+      # health checks and an endpoint to which to send notification of changes in the
+      # health status of the backends.
+      class HealthCheckService
+        include Google::Apis::Core::Hashable
+      
+        # [Output Only] Creation timestamp in RFC3339 text format.
+        # Corresponds to the JSON property `creationTimestamp`
+        # @return [String]
+        attr_accessor :creation_timestamp
+      
+        # An optional description of this resource. Provide this property when you
+        # create the resource.
+        # Corresponds to the JSON property `description`
+        # @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
+        # regional and in the same region. For global HealthCheckService, HealthCheck
+        # must be global. Mix of regional and global HealthChecks is not supported.
+        # Multiple regional HealthChecks must belong to the same region. Regional
+        # HealthChecks</code? must belong to the same region as zones of NEGs.
+        # Corresponds to the JSON property `healthChecks`
+        # @return [Array<String>]
+        attr_accessor :health_checks
+      
+        # Optional. Policy for how the results from multiple health checks for the same
+        # endpoint are aggregated. Defaults to NO_AGGREGATION if unspecified.
+        # - NO_AGGREGATION. An EndpointHealth message is returned for each backend in
+        # the health check service.
+        # - AND. If any backend's health check reports UNHEALTHY, then UNHEALTHY is the
+        # HealthState of the entire health check service. If all backend's are healthy,
+        # the HealthState of the health check service is HEALTHY. .
+        # Corresponds to the JSON property `healthStatusAggregationPolicy`
+        # @return [String]
+        attr_accessor :health_status_aggregation_policy
+      
+        # Policy for how the results from multiple health checks for the same endpoint
+        # are aggregated.
+        # - NO_AGGREGATION. An EndpointHealth message is returned for each backend in
+        # the health check service.
+        # - AND. If any backend's health check reports UNHEALTHY, then UNHEALTHY is the
+        # HealthState of the entire health check service. If all backend's are healthy,
+        # the HealthState of the health check service is HEALTHY. .
+        # Corresponds to the JSON property `healthStatusAggregationStrategy`
+        # @return [Object]
+        attr_accessor :health_status_aggregation_strategy
+      
+        # [Output Only] The unique identifier for the resource. This identifier is
+        # defined by the server.
+        # Corresponds to the JSON property `id`
+        # @return [Fixnum]
+        attr_accessor :id
+      
+        # [Output only] Type of the resource. Always compute#healthCheckServicefor
+        # health check services.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # Name of the resource. The name must be 1-63 characters long, and comply with
+        # RFC1035. Specifically, the name must be 1-63 characters long and match the
+        # regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
+        # character must be a lowercase letter, and all following characters must be a
+        # dash, lowercase letter, or digit, except the last character, which cannot be a
+        # dash.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # List of URLs to the NetworkEndpointGroup resources. Must not have more than
+        # 100. For regional HealthCheckService, NEGs must be in zones in the region of
+        # the HealthCheckService.
+        # Corresponds to the JSON property `networkEndpointGroups`
+        # @return [Array<String>]
+        attr_accessor :network_endpoint_groups
+      
+        # List of URLs to the NotificationEndpoint resources. Must not have more than 10.
+        # A list of endpoints for receiving notifications of change in health status.
+        # For regional HealthCheckService, NotificationEndpoint must be regional and in
+        # the same region. For global HealthCheckService, NotificationEndpoint must be
+        # global.
+        # Corresponds to the JSON property `notificationEndpoints`
+        # @return [Array<String>]
+        attr_accessor :notification_endpoints
+      
+        # [Output Only] URL of the region where the health check service resides. This
+        # field is not applicable to global health check services. You must specify this
+        # field as part of the HTTP request URL. It is not settable as a field in the
+        # request body.
+        # Corresponds to the JSON property `region`
+        # @return [String]
+        attr_accessor :region
+      
+        # [Output Only] Server-defined URL for the resource.
+        # Corresponds to the JSON property `selfLink`
+        # @return [String]
+        attr_accessor :self_link
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        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)
+          @id = args[:id] if args.key?(:id)
+          @kind = args[:kind] if args.key?(:kind)
+          @name = args[:name] if args.key?(:name)
+          @network_endpoint_groups = args[:network_endpoint_groups] if args.key?(:network_endpoint_groups)
+          @notification_endpoints = args[:notification_endpoints] if args.key?(:notification_endpoints)
+          @region = args[:region] if args.key?(:region)
+          @self_link = args[:self_link] if args.key?(:self_link)
+        end
+      end
+      
+      # 
+      class HealthCheckServicesList
+        include Google::Apis::Core::Hashable
+      
+        # [Output Only] Unique identifier for the resource; defined by the server.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # A list of HealthCheckService resources.
+        # Corresponds to the JSON property `items`
+        # @return [Array<Google::Apis::ComputeBeta::HealthCheckService>]
+        attr_accessor :items
+      
+        # [Output Only] Type of the resource. Always compute#healthCheckServicesList for
+        # lists of HealthCheckServices.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # [Output Only] This token allows you to get the next page of results for list
+        # requests. If the number of results is larger than maxResults, use the
+        # nextPageToken as a value for the query parameter pageToken in the next list
+        # request. Subsequent list requests will have their own nextPageToken to
+        # continue paging through the results.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # [Output Only] Server-defined URL for this resource.
+        # Corresponds to the JSON property `selfLink`
+        # @return [String]
+        attr_accessor :self_link
+      
+        # [Output Only] Informational warning message.
+        # Corresponds to the JSON property `warning`
+        # @return [Google::Apis::ComputeBeta::HealthCheckServicesList::Warning]
+        attr_accessor :warning
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @id = args[:id] if args.key?(:id)
+          @items = args[:items] if args.key?(:items)
+          @kind = args[:kind] if args.key?(:kind)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @self_link = args[:self_link] if args.key?(:self_link)
+          @warning = args[:warning] if args.key?(:warning)
+        end
+        
+        # [Output Only] Informational warning message.
+        class Warning
+          include Google::Apis::Core::Hashable
+        
+          # [Output Only] A warning code, if applicable. For example, Compute Engine
+          # returns NO_RESULTS_ON_PAGE if there are no results in the response.
+          # Corresponds to the JSON property `code`
+          # @return [String]
+          attr_accessor :code
+        
+          # [Output Only] Metadata about this warning in key: value format. For example:
+          # "data": [ ` "key": "scope", "value": "zones/us-east1-d" `
+          # Corresponds to the JSON property `data`
+          # @return [Array<Google::Apis::ComputeBeta::HealthCheckServicesList::Warning::Datum>]
+          attr_accessor :data
+        
+          # [Output Only] A human-readable description of the warning code.
+          # Corresponds to the JSON property `message`
+          # @return [String]
+          attr_accessor :message
+        
+          def initialize(**args)
+             update!(**args)
+          end
+        
+          # Update properties of this object
+          def update!(**args)
+            @code = args[:code] if args.key?(:code)
+            @data = args[:data] if args.key?(:data)
+            @message = args[:message] if args.key?(:message)
+          end
+          
+          # 
+          class Datum
+            include Google::Apis::Core::Hashable
+          
+            # [Output Only] A key that provides more detail on the warning being returned.
+            # For example, for warnings where there are no results in a list request for a
+            # particular zone, this key might be scope and the key value might be the zone
+            # name. Other examples might be a key indicating a deprecated resource and a
+            # suggested replacement, or a warning about invalid network settings (for
+            # example, if an instance attempts to perform IP forwarding but is not enabled
+            # for IP forwarding).
+            # Corresponds to the JSON property `key`
+            # @return [String]
+            attr_accessor :key
+          
+            # [Output Only] A warning data value corresponding to the key.
+            # Corresponds to the JSON property `value`
+            # @return [String]
+            attr_accessor :value
+          
+            def initialize(**args)
+               update!(**args)
+            end
+          
+            # Update properties of this object
+            def update!(**args)
+              @key = args[:key] if args.key?(:key)
+              @value = args[:value] if args.key?(:value)
+            end
+          end
+        end
+      end
+      
       # 
       class HealthChecksAggregatedList
         include Google::Apis::Core::Hashable
@@ -8454,6 +8921,11 @@ module Google
       class HealthStatus
         include Google::Apis::Core::Hashable
       
+        # Metadata defined as annotations for network endpoint.
+        # Corresponds to the JSON property `annotations`
+        # @return [Hash<String,String>]
+        attr_accessor :annotations
+      
         # Health state of the instance.
         # Corresponds to the JSON property `healthState`
         # @return [String]
@@ -8480,6 +8952,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @annotations = args[:annotations] if args.key?(:annotations)
           @health_state = args[:health_state] if args.key?(:health_state)
           @instance = args[:instance] if args.key?(:instance)
           @ip_address = args[:ip_address] if args.key?(:ip_address)
@@ -8749,7 +9222,7 @@ module Google
         # @return [Google::Apis::ComputeBeta::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
@@ -8757,6 +9230,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
@@ -9074,6 +9549,8 @@ module Google
         # regular expression specified by regexMatch. For the regular expression grammar,
         # please see en.cppreference.com/w/cpp/regex/ecmascript
         # 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
@@ -9115,7 +9592,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]
@@ -9123,6 +9602,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
@@ -9445,6 +9928,8 @@ module Google
         # 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
@@ -9691,8 +10176,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
       
@@ -10079,8 +10563,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
       
@@ -10225,6 +10709,11 @@ module Google
         # @return [Google::Apis::ComputeBeta::ReservationAffinity]
         attr_accessor :reservation_affinity
       
+        # Resource policies applied to this instance.
+        # 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::ComputeBeta::Scheduling]
@@ -10333,6 +10822,7 @@ module Google
           @name = args[:name] if args.key?(:name)
           @network_interfaces = args[:network_interfaces] if args.key?(:network_interfaces)
           @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)
           @self_link = args[:self_link] if args.key?(:self_link)
           @service_accounts = args[:service_accounts] if args.key?(:service_accounts)
@@ -10477,9 +10967,8 @@ module Google
       # 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 beta.instanceGroups ==) (== resource_for v1.instanceGroups ==)
-      # (== resource_for beta.regionInstanceGroups ==) (== resource_for v1.
-      # regionInstanceGroups ==)
+      # (== resource_for `$api_version`.instanceGroups ==) (== resource_for `$
+      # api_version`.regionInstanceGroups ==)
       class InstanceGroup
         include Google::Apis::Core::Hashable
       
@@ -10826,9 +11315,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
       
@@ -11440,6 +11928,12 @@ module Google
       class InstanceGroupManagerStatus
         include Google::Apis::Core::Hashable
       
+        # [Output Only] The URL of the Autoscaler that targets this instance group
+        # manager.
+        # Corresponds to the JSON property `autoscaler`
+        # @return [String]
+        attr_accessor :autoscaler
+      
         # [Output Only] A bit indicating whether the managed instance group is in a
         # stable state. A stable state means that: none of the instances in the managed
         # instance group is currently undergoing any type of change (for example,
@@ -11468,6 +11962,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @autoscaler = args[:autoscaler] if args.key?(:autoscaler)
           @is_stable = args[:is_stable] if args.key?(:is_stable)
           @stateful = args[:stateful] if args.key?(:stateful)
           @version_target = args[:version_target] if args.key?(:version_target)
@@ -12992,8 +13487,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
       
@@ -13510,8 +14005,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
       
@@ -13727,8 +14221,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
       
@@ -13765,7 +14259,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>]
@@ -14236,7 +14730,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]
@@ -14248,7 +14742,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`
@@ -14414,7 +14908,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
       
@@ -14477,12 +14971,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
@@ -15070,7 +15564,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::ComputeBeta::InterconnectDiagnostics]
         attr_accessor :result
@@ -15804,7 +16298,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
       
@@ -16616,8 +17110,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
       
@@ -16723,6 +17217,17 @@ module Google
       class NetworkEndpoint
         include Google::Apis::Core::Hashable
       
+        # Metadata defined as annotations on the network endpoint.
+        # Corresponds to the JSON property `annotations`
+        # @return [Hash<String,String>]
+        attr_accessor :annotations
+      
+        # Optional fully qualified domain name of network endpoint. This can only be
+        # specified when NetworkEndpointGroup.network_endpoint_type is NON_GCP_FQDN_PORT.
+        # Corresponds to the JSON property `fqdn`
+        # @return [String]
+        attr_accessor :fqdn
+      
         # The name for a specific VM instance that the IP address belongs to. This is
         # required for network endpoints of type GCE_VM_IP_PORT. The instance must be in
         # the same zone of network endpoint group.
@@ -16753,6 +17258,8 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @annotations = args[:annotations] if args.key?(:annotations)
+          @fqdn = args[:fqdn] if args.key?(:fqdn)
           @instance = args[:instance] if args.key?(:instance)
           @ip_address = args[:ip_address] if args.key?(:ip_address)
           @port = args[:port] if args.key?(:port)
@@ -16761,11 +17268,15 @@ 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 ==) Next ID: 21
+      # (== resource_for `$api_version`.networkEndpointGroups ==) Next ID: 21
       class NetworkEndpointGroup
         include Google::Apis::Core::Hashable
       
+        # Metadata defined as annotations on the network endpoint group.
+        # Corresponds to the JSON property `annotations`
+        # @return [Hash<String,String>]
+        attr_accessor :annotations
+      
         # [Output Only] Creation timestamp in RFC3339 text format.
         # Corresponds to the JSON property `creationTimestamp`
         # @return [String]
@@ -16849,6 +17360,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @annotations = args[:annotations] if args.key?(:annotations)
           @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp)
           @default_port = args[:default_port] if args.key?(:default_port)
           @description = args[:description] if args.key?(:description)
@@ -17844,8 +18356,7 @@ 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 ==)
+      # Sole-tenant nodes. (== resource_for `$api_version`.nodeGroups ==)
       class NodeGroup
         include Google::Apis::Core::Hashable
       
@@ -18533,8 +19044,8 @@ 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 ==)
+      # more information, read Creating node groups and instances. (== resource_for `$
+      # api_version`.nodeTemplates ==) (== NextID: 18 ==)
       class NodeTemplate
         include Google::Apis::Core::Hashable
       
@@ -19007,7 +19518,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
       
@@ -19422,7 +19933,256 @@ module Google
         end
       end
       
+      # A notification endpoint resource defines an endpoint to receive notifications
+      # when there are status changes detected by the associated health check service.
+      class NotificationEndpoint
+        include Google::Apis::Core::Hashable
+      
+        # [Output Only] Creation timestamp in RFC3339 text format.
+        # Corresponds to the JSON property `creationTimestamp`
+        # @return [String]
+        attr_accessor :creation_timestamp
+      
+        # An optional description of this resource. Provide this property when you
+        # create the resource.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # Represents a gRPC setting that describes one gRPC notification endpoint and
+        # the retry duration attempting to send notification to this endpoint.
+        # Corresponds to the JSON property `grpcSettings`
+        # @return [Google::Apis::ComputeBeta::NotificationEndpointGrpcSettings]
+        attr_accessor :grpc_settings
+      
+        # [Output Only] A unique identifier for this resource type. The server generates
+        # this identifier.
+        # Corresponds to the JSON property `id`
+        # @return [Fixnum]
+        attr_accessor :id
+      
+        # [Output Only] Type of the resource. Always compute#notificationEndpoint for
+        # notification endpoints.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # Name of the resource. Provided by the client when the resource is created. The
+        # name must be 1-63 characters long, and comply with RFC1035. Specifically, the
+        # name must be 1-63 characters long and match the regular expression `[a-z]([-a-
+        # z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter,
+        # and all following characters must be a dash, lowercase letter, or digit,
+        # except the last character, which cannot be a dash.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # [Output Only] URL of the region where the notification endpoint resides. This
+        # field applies only to the regional resource. You must specify this field as
+        # part of the HTTP request URL. It is not settable as a field in the request
+        # body.
+        # Corresponds to the JSON property `region`
+        # @return [String]
+        attr_accessor :region
+      
+        # [Output Only] Server-defined URL for the resource.
+        # Corresponds to the JSON property `selfLink`
+        # @return [String]
+        attr_accessor :self_link
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp)
+          @description = args[:description] if args.key?(:description)
+          @grpc_settings = args[:grpc_settings] if args.key?(:grpc_settings)
+          @id = args[:id] if args.key?(:id)
+          @kind = args[:kind] if args.key?(:kind)
+          @name = args[:name] if args.key?(:name)
+          @region = args[:region] if args.key?(:region)
+          @self_link = args[:self_link] if args.key?(:self_link)
+        end
+      end
+      
+      # Represents a gRPC setting that describes one gRPC notification endpoint and
+      # the retry duration attempting to send notification to this endpoint.
+      class NotificationEndpointGrpcSettings
+        include Google::Apis::Core::Hashable
+      
+        # Optional. If specified, this field is used to set the authority header by the
+        # sender of notifications. See https://tools.ietf.org/html/rfc7540#section-8.1.2.
+        # 3
+        # Corresponds to the JSON property `authority`
+        # @return [String]
+        attr_accessor :authority
+      
+        # Endpoint to which gRPC notifications are sent. This must be a valid gRPCLB DNS
+        # name.
+        # Corresponds to the JSON property `endpoint`
+        # @return [String]
+        attr_accessor :endpoint
+      
+        # Optional. If specified, this field is used to populate the "name" field in
+        # gRPC requests.
+        # Corresponds to the JSON property `payloadName`
+        # @return [String]
+        attr_accessor :payload_name
+      
+        # A Duration represents a 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". Range is approximately 10,
+        # 000 years.
+        # Corresponds to the JSON property `resendInterval`
+        # @return [Google::Apis::ComputeBeta::Duration]
+        attr_accessor :resend_interval
+      
+        # How much time (in seconds) is spent attempting notification retries until a
+        # successful response is received. Default is 30s. Limit is 20m (1200s). Must be
+        # a positive number.
+        # Corresponds to the JSON property `retryDurationSec`
+        # @return [Fixnum]
+        attr_accessor :retry_duration_sec
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @authority = args[:authority] if args.key?(:authority)
+          @endpoint = args[:endpoint] if args.key?(:endpoint)
+          @payload_name = args[:payload_name] if args.key?(:payload_name)
+          @resend_interval = args[:resend_interval] if args.key?(:resend_interval)
+          @retry_duration_sec = args[:retry_duration_sec] if args.key?(:retry_duration_sec)
+        end
+      end
+      
+      # 
+      class NotificationEndpointList
+        include Google::Apis::Core::Hashable
+      
+        # [Output Only] Unique identifier for the resource; defined by the server.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # A list of NotificationEndpoint resources.
+        # Corresponds to the JSON property `items`
+        # @return [Array<Google::Apis::ComputeBeta::NotificationEndpoint>]
+        attr_accessor :items
+      
+        # [Output Only] Type of the resource. Always compute#notificationEndpoint for
+        # notification endpoints.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # [Output Only] This token allows you to get the next page of results for list
+        # requests. If the number of results is larger than maxResults, use the
+        # nextPageToken as a value for the query parameter pageToken in the next list
+        # request. Subsequent list requests will have their own nextPageToken to
+        # continue paging through the results.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # [Output Only] Server-defined URL for this resource.
+        # Corresponds to the JSON property `selfLink`
+        # @return [String]
+        attr_accessor :self_link
+      
+        # [Output Only] Informational warning message.
+        # Corresponds to the JSON property `warning`
+        # @return [Google::Apis::ComputeBeta::NotificationEndpointList::Warning]
+        attr_accessor :warning
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @id = args[:id] if args.key?(:id)
+          @items = args[:items] if args.key?(:items)
+          @kind = args[:kind] if args.key?(:kind)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @self_link = args[:self_link] if args.key?(:self_link)
+          @warning = args[:warning] if args.key?(:warning)
+        end
+        
+        # [Output Only] Informational warning message.
+        class Warning
+          include Google::Apis::Core::Hashable
+        
+          # [Output Only] A warning code, if applicable. For example, Compute Engine
+          # returns NO_RESULTS_ON_PAGE if there are no results in the response.
+          # Corresponds to the JSON property `code`
+          # @return [String]
+          attr_accessor :code
+        
+          # [Output Only] Metadata about this warning in key: value format. For example:
+          # "data": [ ` "key": "scope", "value": "zones/us-east1-d" `
+          # Corresponds to the JSON property `data`
+          # @return [Array<Google::Apis::ComputeBeta::NotificationEndpointList::Warning::Datum>]
+          attr_accessor :data
+        
+          # [Output Only] A human-readable description of the warning code.
+          # Corresponds to the JSON property `message`
+          # @return [String]
+          attr_accessor :message
+        
+          def initialize(**args)
+             update!(**args)
+          end
+        
+          # Update properties of this object
+          def update!(**args)
+            @code = args[:code] if args.key?(:code)
+            @data = args[:data] if args.key?(:data)
+            @message = args[:message] if args.key?(:message)
+          end
+          
+          # 
+          class Datum
+            include Google::Apis::Core::Hashable
+          
+            # [Output Only] A key that provides more detail on the warning being returned.
+            # For example, for warnings where there are no results in a list request for a
+            # particular zone, this key might be scope and the key value might be the zone
+            # name. Other examples might be a key indicating a deprecated resource and a
+            # suggested replacement, or a warning about invalid network settings (for
+            # example, if an instance attempts to perform IP forwarding but is not enabled
+            # for IP forwarding).
+            # Corresponds to the JSON property `key`
+            # @return [String]
+            attr_accessor :key
+          
+            # [Output Only] A warning data value corresponding to the key.
+            # Corresponds to the JSON property `value`
+            # @return [String]
+            attr_accessor :value
+          
+            def initialize(**args)
+               update!(**args)
+            end
+          
+            # Update properties of this object
+            def update!(**args)
+              @key = args[:key] if args.key?(:key)
+              @value = args[:value] if args.key?(:value)
+            end
+          end
+        end
+      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.
@@ -19430,10 +20190,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
       
@@ -20892,8 +21651,7 @@ module Google
         # 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, only one of pathRules or routeRules must be set.
-        # routeRules are not supported in UrlMaps intended for External Load balancers.
+        # Within a given pathMatcher, you can set only one of pathRules or routeRules.
         # Corresponds to the JSON property `routeRules`
         # @return [Array<Google::Apis::ComputeBeta::HttpRouteRule>]
         attr_accessor :route_rules
@@ -21202,8 +21960,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
       
@@ -21495,8 +22253,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
       
@@ -22939,12 +23697,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::ComputeBeta::UrlMap]
         attr_accessor :resource
@@ -22983,8 +23748,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
       
@@ -23621,6 +24386,12 @@ module Google
         # @return [String]
         attr_accessor :description
       
+        # A GroupPlacementPolicy specifies resource placement configuration. It
+        # specifies the failure bucket separation as well as network locality
+        # Corresponds to the JSON property `groupPlacementPolicy`
+        # @return [Google::Apis::ComputeBeta::ResourcePolicyGroupPlacementPolicy]
+        attr_accessor :group_placement_policy
+      
         # [Output Only] The unique identifier for the resource. This identifier is
         # defined by the server.
         # Corresponds to the JSON property `id`
@@ -23674,6 +24445,7 @@ module Google
         def update!(**args)
           @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp)
           @description = args[:description] if args.key?(:description)
+          @group_placement_policy = args[:group_placement_policy] if args.key?(:group_placement_policy)
           @id = args[:id] if args.key?(:id)
           @kind = args[:kind] if args.key?(:kind)
           @name = args[:name] if args.key?(:name)
@@ -23841,6 +24613,40 @@ module Google
         end
       end
       
+      # A GroupPlacementPolicy specifies resource placement configuration. It
+      # specifies the failure bucket separation as well as network locality
+      class ResourcePolicyGroupPlacementPolicy
+        include Google::Apis::Core::Hashable
+      
+        # The number of availability domains instances will be spread across. If two
+        # instances are in different availability domain, they will not be put in the
+        # same low latency network
+        # Corresponds to the JSON property `availabilityDomainCount`
+        # @return [Fixnum]
+        attr_accessor :availability_domain_count
+      
+        # Specifies network collocation
+        # Corresponds to the JSON property `collocation`
+        # @return [String]
+        attr_accessor :collocation
+      
+        # Number of vms in this placement group
+        # Corresponds to the JSON property `vmCount`
+        # @return [Fixnum]
+        attr_accessor :vm_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @availability_domain_count = args[:availability_domain_count] if args.key?(:availability_domain_count)
+          @collocation = args[:collocation] if args.key?(:collocation)
+          @vm_count = args[:vm_count] if args.key?(:vm_count)
+        end
+      end
+      
       # Time window specified for hourly operations.
       class ResourcePolicyHourlyCycle
         include Google::Apis::Core::Hashable
@@ -24093,7 +24899,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
@@ -24178,8 +24984,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
       
@@ -24791,7 +25597,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`
@@ -25741,20 +26547,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
@@ -26049,8 +26848,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
       
@@ -26748,8 +27546,8 @@ 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
       
@@ -26776,6 +27574,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] The unique identifier for the resource. This identifier is
         # defined by the server.
         # Corresponds to the JSON property `id`
@@ -26892,6 +27695,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)
           @id = args[:id] if args.key?(:id)
           @kind = args[:kind] if args.key?(:kind)
           @label_fingerprint = args[:label_fingerprint] if args.key?(:label_fingerprint)
@@ -27190,12 +27994,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 ==) (== resource_for
-      # beta.regionSslCertificates ==) (== resource_for v1.regionSslCertificates ==)
-      # Next ID: 17
+      # 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
       
@@ -27834,8 +28643,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
       
@@ -28091,7 +28899,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
       
@@ -28212,6 +29020,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
@@ -28764,20 +29573,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
@@ -28942,12 +29744,16 @@ module Google
       end
       
       # Represents a Target HTTP Proxy resource.
-      # A target HTTP proxy is a component of GCP 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 beta.targetHttpProxies ==) (== resource_for v1.
-      # targetHttpProxies ==) (== resource_for beta.regionTargetHttpProxies ==) (==
-      # resource_for v1.regionTargetHttpProxies ==)
+      # 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
       
@@ -29385,12 +30191,16 @@ module Google
       end
       
       # Represents a Target HTTPS Proxy resource.
-      # A target HTTPS proxy is a component of GCP 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 beta.targetHttpsProxies ==) (== resource_for v1.
-      # targetHttpsProxies ==) (== resource_for beta.regionTargetHttpsProxies ==) (==
-      # resource_for v1.regionTargetHttpsProxies ==)
+      # 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
       
@@ -29735,8 +30545,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
       
@@ -30150,8 +30959,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
       
@@ -30794,8 +31602,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
       
@@ -31041,8 +31848,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
       
@@ -31231,8 +32037,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
       
@@ -31752,12 +32558,19 @@ module Google
       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
       
@@ -32319,12 +33132,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::ComputeBeta::UrlMap]
         attr_accessor :resource
@@ -33396,7 +34216,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
       
@@ -34183,8 +35003,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