google-api-client 0.41.0 → 0.42.0

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

@@ -87,7 +87,7 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # [Output Only] Maximum accelerator cards allowed per instance.
+        # [Output Only] Maximum number of accelerator cards allowed per instance.
         # Corresponds to the JSON property `maximumCardsPerInstance`
         # @return [Fixnum]
         attr_accessor :maximum_cards_per_instance
@@ -97,7 +97,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # [Output Only] Server-defined fully-qualified URL for this resource.
+        # [Output Only] Server-defined, fully qualified URL for this resource.
         # Corresponds to the JSON property `selfLink`
         # @return [String]
         attr_accessor :self_link
@@ -1419,10 +1419,10 @@ module Google
       # specified in each AuditConfig are enabled, and the exempted_members in each
       # AuditLogConfig are exempted.
       # Example Policy with multiple AuditConfigs:
-      # ` "audit_configs": [ ` "service": "allServices" "audit_log_configs": [ ` "
+      # ` "audit_configs": [ ` "service": "allServices", "audit_log_configs": [ ` "
       # log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] `, ` "
-      # log_type": "DATA_WRITE", `, ` "log_type": "ADMIN_READ", ` ] `, ` "service": "
-      # sampleservice.googleapis.com" "audit_log_configs": [ ` "log_type": "DATA_READ",
+      # log_type": "DATA_WRITE" `, ` "log_type": "ADMIN_READ" ` ] `, ` "service": "
+      # sampleservice.googleapis.com", "audit_log_configs": [ ` "log_type": "DATA_READ"
       # `, ` "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com"
       # ] ` ] ` ] `
       # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
@@ -1462,7 +1462,7 @@ module Google
       
       # Provides the configuration for logging a type of permissions. Example:
       # ` "audit_log_configs": [ ` "log_type": "DATA_READ", "exempted_members": [ "
-      # user:jose@example.com" ] `, ` "log_type": "DATA_WRITE", ` ] `
+      # user:jose@example.com" ] `, ` "log_type": "DATA_WRITE" ` ] `
       # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@
       # example.com from DATA_READ logging.
       class AuditLogConfig
@@ -2223,7 +2223,9 @@ module Google
         # UTILIZATION, RATE or CONNECTION). Default value is 1, which means the group
         # will serve up to 100% of its configured capacity (depending on balancingMode).
         # A setting of 0 means the group is completely drained, offering 0% of its
-        # available Capacity. Valid range is [0.0,1.0].
+        # available capacity. Valid range is 0.0 and [0.1,1.0]. You cannot configure a
+        # setting larger than 0 and smaller than 0.1. You cannot configure a setting of
+        # 0 when there is only one backend attached to the backend service.
         # This cannot be used for internal load balancing.
         # Corresponds to the JSON property `capacityScaler`
         # @return [Float]
@@ -2603,7 +2605,7 @@ module Google
       # scoped.
       # * [Global](/compute/docs/reference/rest/`$api_version`/backendServices) * [
       # Regional](/compute/docs/reference/rest/`$api_version`/regionBackendServices)
-      # For more information, read Backend Services.
+      # For more information, see Backend Services.
       # (== resource_for `$api_version`.backendService ==)
       class BackendService
         include Google::Apis::Core::Hashable
@@ -2739,8 +2741,8 @@ module Google
         # redirected to the load balancer.
         # - MAGLEV: used as a drop in replacement for the ring hash load balancer.
         # Maglev is not as stable as ring hash but has faster table lookup build times
-        # and host selection times. For more information about Maglev, refer to https://
-        # ai.google/research/pubs/pub44824
+        # and host selection times. For more information about Maglev, see https://ai.
+        # google/research/pubs/pub44824
         # This field is applicable to either:
         # - A regional backend service with the service_protocol set to HTTP, HTTPS, or
         # HTTP2, and load_balancing_scheme set to INTERNAL_MANAGED.
@@ -2842,8 +2844,8 @@ module Google
         attr_accessor :session_affinity
       
         # The backend service timeout has a different meaning depending on the type of
-        # load balancer. For more information read,  Backend service settings The
-        # default is 30 seconds.
+        # load balancer. For more information see,  Backend service settings The default
+        # is 30 seconds.
         # Corresponds to the JSON property `timeoutSec`
         # @return [Fixnum]
         attr_accessor :timeout_sec
@@ -3095,6 +3097,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`
@@ -3113,6 +3120,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
@@ -3122,18 +3130,22 @@ module Google
       class BackendServiceIap
         include Google::Apis::Core::Hashable
       
-        # 
+        # Whether the serving infrastructure will authenticate and authorize all
+        # incoming requests. If true, the oauth2ClientId and oauth2ClientSecret fields
+        # must be non-empty.
         # Corresponds to the JSON property `enabled`
         # @return [Boolean]
         attr_accessor :enabled
         alias_method :enabled?, :enabled
       
-        # 
+        # OAuth2 client ID to use for the authentication flow.
         # Corresponds to the JSON property `oauth2ClientId`
         # @return [String]
         attr_accessor :oauth2_client_id
       
-        # 
+        # OAuth2 client secret to use for the authentication flow. For security reasons,
+        # this value cannot be retrieved via the API. Instead, the SHA-256 hash of the
+        # value is returned in the oauth2ClientSecretSha256 field.
         # Corresponds to the JSON property `oauth2ClientSecret`
         # @return [String]
         attr_accessor :oauth2_client_secret
@@ -4545,6 +4557,24 @@ module Google
         # @return [Fixnum]
         attr_accessor :size_gb
       
+        # The source disk used to create this disk. You can provide this as a partial or
+        # full URL to the resource. For example, the following are valid values:
+        # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
+        # - projects/project/zones/zone/disks/disk
+        # - zones/zone/disks/disk
+        # Corresponds to the JSON property `sourceDisk`
+        # @return [String]
+        attr_accessor :source_disk
+      
+        # [Output Only] The unique ID of the disk used to create this disk. This value
+        # identifies the exact disk that was used to create this persistent disk. For
+        # example, if you created the persistent disk from a disk that was later deleted
+        # and recreated under the same name, the source disk ID would identify the exact
+        # version of the disk that was used.
+        # Corresponds to the JSON property `sourceDiskId`
+        # @return [String]
+        attr_accessor :source_disk_id
+      
         # The source image used to create this disk. If the source image is deleted,
         # this field will not be set.
         # To create a disk with one of the public operating system images, specify the
@@ -4656,6 +4686,8 @@ module Google
           @resource_policies = args[:resource_policies] if args.key?(:resource_policies)
           @self_link = args[:self_link] if args.key?(:self_link)
           @size_gb = args[:size_gb] if args.key?(:size_gb)
+          @source_disk = args[:source_disk] if args.key?(:source_disk)
+          @source_disk_id = args[:source_disk_id] if args.key?(:source_disk_id)
           @source_image = args[:source_image] if args.key?(:source_image)
           @source_image_encryption_key = args[:source_image_encryption_key] if args.key?(:source_image_encryption_key)
           @source_image_id = args[:source_image_id] if args.key?(:source_image_id)
@@ -7778,6 +7810,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::ComputeV1::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-
@@ -7844,6 +7882,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)
@@ -7972,6 +8011,28 @@ module Google
         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/
@@ -7996,6 +8057,270 @@ module Google
         end
       end
       
+      # Represents a Health-Check as a Service resource.
+      # (== resource_for `$api_version`.regionHealthCheckServices ==)
+      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
+      
+        # [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)
+          @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
+      
+      # A full or valid partial URL to a health check service. For example, the
+      # following are valid URLs:
+      # - https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/
+      # healthCheckServices/health-check-service
+      # - projects/project-id/regions/us-west1/healthCheckServices/health-check-
+      # service
+      # - regions/us-west1/healthCheckServices/health-check-service
+      class HealthCheckServiceReference
+        include Google::Apis::Core::Hashable
+      
+        # 
+        # Corresponds to the JSON property `healthCheckService`
+        # @return [String]
+        attr_accessor :health_check_service
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @health_check_service = args[:health_check_service] if args.key?(:health_check_service)
+        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::ComputeV1::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::ComputeV1::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::ComputeV1::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
@@ -8208,6 +8533,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]
@@ -8235,6 +8565,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)
@@ -8268,6 +8599,17 @@ module Google
         # @return [Google::Apis::ComputeV1::HealthCheckReference]
         attr_accessor :health_check
       
+        # A full or valid partial URL to a health check service. For example, the
+        # following are valid URLs:
+        # - https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/
+        # healthCheckServices/health-check-service
+        # - projects/project-id/regions/us-west1/healthCheckServices/health-check-
+        # service
+        # - regions/us-west1/healthCheckServices/health-check-service
+        # Corresponds to the JSON property `healthCheckService`
+        # @return [Google::Apis::ComputeV1::HealthCheckServiceReference]
+        attr_accessor :health_check_service
+      
         # Health state of the network endpoint determined based on the health checks
         # configured.
         # Corresponds to the JSON property `healthState`
@@ -8283,6 +8625,7 @@ module Google
           @backend_service = args[:backend_service] if args.key?(:backend_service)
           @forwarding_rule = args[:forwarding_rule] if args.key?(:forwarding_rule)
           @health_check = args[:health_check] if args.key?(:health_check)
+          @health_check_service = args[:health_check_service] if args.key?(:health_check_service)
           @health_state = args[:health_state] if args.key?(:health_state)
         end
       end
@@ -9597,11 +9940,13 @@ module Google
         # @return [String]
         attr_accessor :source_disk_id
       
-        # URL of the source image used to create this image. This can be a full or valid
-        # partial URL. You must provide exactly one of:
-        # - this property, or
-        # - the rawDisk.source property, or
-        # - the sourceDisk property   in order to create an image.
+        # URL of the source image used to create this image.
+        # In order to create an image, you must provide the full or partial URL of one
+        # of the following:
+        # - The selfLink URL
+        # - This property
+        # - The rawDisk.source URL
+        # - The sourceDisk URL
         # Corresponds to the JSON property `sourceImage`
         # @return [String]
         attr_accessor :source_image
@@ -9618,12 +9963,14 @@ module Google
         # @return [String]
         attr_accessor :source_image_id
       
-        # URL of the source snapshot used to create this image. This can be a full or
-        # valid partial URL. You must provide exactly one of:
-        # - this property, or
-        # - the sourceImage property, or
-        # - the rawDisk.source property, or
-        # - the sourceDisk property   in order to create an image.
+        # URL of the source snapshot used to create this image.
+        # In order to create an image, you must provide the full or partial URL of one
+        # of the following:
+        # - The selfLink URL
+        # - This property
+        # - The sourceImage URL
+        # - The rawDisk.source URL
+        # - The sourceDisk URL
         # Corresponds to the JSON property `sourceSnapshot`
         # @return [String]
         attr_accessor :source_snapshot
@@ -12320,9 +12667,9 @@ module Google
       class InstanceProperties
         include Google::Apis::Core::Hashable
       
-        # Enables instances created based on this template to send packets with source
-        # IP addresses other than their own and receive packets with destination IP
-        # addresses other than their own. If these instances will be used as an IP
+        # Enables instances created based on these properties to send packets with
+        # source IP addresses other than their own and receive packets with destination
+        # IP addresses other than their own. If these instances will be used as an IP
         # gateway or it will be set as the next-hop in a Route resource, specify true.
         # If unsure, leave this set to false. See the Enable IP forwarding documentation
         # for more information.
@@ -12331,30 +12678,30 @@ module Google
         attr_accessor :can_ip_forward
         alias_method :can_ip_forward?, :can_ip_forward
       
-        # An optional text description for the instances that are created from this
-        # instance template.
+        # An optional text description for the instances that are created from these
+        # properties.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
         # An array of disks that are associated with the instances that are created from
-        # this template.
+        # these properties.
         # Corresponds to the JSON property `disks`
         # @return [Array<Google::Apis::ComputeV1::AttachedDisk>]
         attr_accessor :disks
       
         # A list of guest accelerator cards' type and count to use for instances created
-        # from the instance template.
+        # from these properties.
         # Corresponds to the JSON property `guestAccelerators`
         # @return [Array<Google::Apis::ComputeV1::AcceleratorConfig>]
         attr_accessor :guest_accelerators
       
-        # Labels to apply to instances that are created from this template.
+        # Labels to apply to instances that are created from these properties.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # The machine type to use for instances that are created from this template.
+        # The machine type to use for instances that are created from these properties.
         # Corresponds to the JSON property `machineType`
         # @return [String]
         attr_accessor :machine_type
@@ -12364,11 +12711,11 @@ module Google
         # @return [Google::Apis::ComputeV1::Metadata]
         attr_accessor :metadata
       
-        # Minimum cpu/platform to be used by this instance. The instance may be
-        # scheduled on the specified or newer cpu/platform. Applicable values are the
-        # friendly names of CPU platforms, such as minCpuPlatform: "Intel Haswell" or
-        # minCpuPlatform: "Intel Sandy Bridge". For more information, read Specifying a
-        # Minimum CPU Platform.
+        # Minimum cpu/platform to be used by instances. The instance may be scheduled on
+        # the specified or newer cpu/platform. Applicable values are the friendly names
+        # of CPU platforms, such as minCpuPlatform: "Intel Haswell" or minCpuPlatform: "
+        # Intel Sandy Bridge". For more information, read Specifying a Minimum CPU
+        # Platform.
         # Corresponds to the JSON property `minCpuPlatform`
         # @return [String]
         attr_accessor :min_cpu_platform
@@ -12378,7 +12725,7 @@ module Google
         # @return [Array<Google::Apis::ComputeV1::NetworkInterface>]
         attr_accessor :network_interfaces
       
-        # The private IPv6 google access type for the VM. If not specified, use
+        # The private IPv6 google access type for VMs. If not specified, use
         # INHERIT_FROM_SUBNETWORK as default.
         # Corresponds to the JSON property `privateIpv6GoogleAccess`
         # @return [String]
@@ -12389,8 +12736,8 @@ module Google
         # @return [Google::Apis::ComputeV1::ReservationAffinity]
         attr_accessor :reservation_affinity
       
-        # Resource policies (names, not ULRs) applied to instances created from this
-        # template.
+        # Resource policies (names, not ULRs) applied to instances created from these
+        # properties.
         # Corresponds to the JSON property `resourcePolicies`
         # @return [Array<String>]
         attr_accessor :resource_policies
@@ -12401,8 +12748,9 @@ module Google
         attr_accessor :scheduling
       
         # A list of service accounts with specified scopes. Access tokens for these
-        # service accounts are available to the instances that are created from this
-        # template. Use metadata queries to obtain the access tokens for these instances.
+        # service accounts are available to the instances that are created from these
+        # properties. Use metadata queries to obtain the access tokens for these
+        # instances.
         # Corresponds to the JSON property `serviceAccounts`
         # @return [Array<Google::Apis::ComputeV1::ServiceAccount>]
         attr_accessor :service_accounts
@@ -13814,8 +14162,7 @@ module Google
       end
       
       # Describes a single physical circuit between the Customer and Google.
-      # CircuitInfo objects are created by Google, so all fields are output only. Next
-      # id: 4
+      # CircuitInfo objects are created by Google, so all fields are output only.
       class InterconnectCircuitInfo
         include Google::Apis::Core::Hashable
       
@@ -14423,7 +14770,7 @@ module Google
         end
       end
       
-      # Description of a planned outage on this Interconnect. Next id: 9
+      # Description of a planned outage on this Interconnect.
       class InterconnectOutageNotification
         include Google::Apis::Core::Hashable
       
@@ -15882,10 +16229,12 @@ module Google
         # @return [String]
         attr_accessor :i_pv4_range
       
-        # When set to true, the VPC network is created in "auto" mode. When set to false,
-        # the VPC network is created in "custom" mode.
+        # When set to true, the VPC network is created in auto mode. When set to false,
+        # the VPC network is created in custom mode.
         # An auto mode VPC network starts with one subnet per region. Each subnet has a
         # predetermined range as described in Auto mode VPC network IP ranges.
+        # For custom mode VPC networks, you can add subnets using the subnetworks insert
+        # method.
         # Corresponds to the JSON property `autoCreateSubnetworks`
         # @return [Boolean]
         attr_accessor :auto_create_subnetworks
@@ -15973,10 +16322,15 @@ module Google
         end
       end
       
-      # The network endpoint. Next ID: 7
+      # The network endpoint.
       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`
@@ -16013,6 +16367,7 @@ 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)
@@ -16029,6 +16384,11 @@ module Google
       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]
@@ -16106,6 +16466,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)
@@ -16631,7 +16992,7 @@ module Google
         # @return [Array<Google::Apis::ComputeV1::HealthStatusForNetworkEndpoint>]
         attr_accessor :healths
       
-        # The network endpoint. Next ID: 7
+        # The network endpoint.
         # Corresponds to the JSON property `networkEndpoint`
         # @return [Google::Apis::ComputeV1::NetworkEndpoint]
         attr_accessor :network_endpoint
@@ -17134,7 +17495,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The URL of the node template to which this node group belongs.
+        # URL of the node template to create the node group from.
         # Corresponds to the JSON property `nodeTemplate`
         # @return [String]
         attr_accessor :node_template
@@ -17768,7 +18129,7 @@ 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 `$
-      # api_version`.nodeTemplates ==) (== NextID: 19 ==)
+      # api_version`.nodeTemplates ==)
       class NodeTemplate
         include Google::Apis::Core::Hashable
       
@@ -18656,6 +19017,255 @@ module Google
         end
       end
       
+      # Represents a notification endpoint.
+      # A notification endpoint resource defines an endpoint to receive notifications
+      # when there are status changes detected by the associated health check service.
+      # For more information, see  Health checks overview. (== resource_for `$
+      # api_version`.notificationEndpoint ==) (== resource_for `$api_version`.
+      # regionNotificationEndpoints ==)
+      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::ComputeV1::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::ComputeV1::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::ComputeV1::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::ComputeV1::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::ComputeV1::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/`$api_version`/globalOperations) * [
@@ -20024,6 +20634,8 @@ module Google
         # defaultService must not be set. Conversely if defaultService is set,
         # defaultRouteAction cannot contain any  weightedBackendServices.
         # Only one of defaultRouteAction or defaultUrlRedirect must be set.
+        # UrlMaps for external HTTP(S) load balancers support only the urlRewrite action
+        # within a pathMatcher's defaultRouteAction.
         # Corresponds to the JSON property `defaultRouteAction`
         # @return [Google::Apis::ComputeV1::HttpRouteAction]
         attr_accessor :default_route_action
@@ -20127,6 +20739,8 @@ module Google
         # weightedBackendServices, service must not be set. Conversely if service is set,
         # routeAction cannot contain any  weightedBackendServices.
         # Only one of routeAction or urlRedirect must be set.
+        # UrlMaps for external HTTP(S) load balancers support only the urlRewrite action
+        # within a pathRule's routeAction.
         # Corresponds to the JSON property `routeAction`
         # @return [Google::Apis::ComputeV1::HttpRouteAction]
         attr_accessor :route_action
@@ -24357,7 +24971,7 @@ module Google
         end
       end
       
-      # Status of a NAT contained in this router. Next tag: 9
+      # Status of a NAT contained in this router.
       class RouterStatusNatStatus
         include Google::Apis::Core::Hashable
       
@@ -24715,8 +25329,9 @@ module Google
         attr_accessor :on_host_maintenance
       
         # Defines whether the instance is preemptible. This can only be set during
-        # instance creation, it cannot be set or changed after the instance has been
-        # created.
+        # instance creation or while the instance is stopped and therefore, in a `
+        # TERMINATED` state. See Instance Life Cycle for more information on the
+        # possible instance states.
         # Corresponds to the JSON property `preemptible`
         # @return [Boolean]
         attr_accessor :preemptible
@@ -26598,7 +27213,8 @@ module Google
         # The range of internal addresses that are owned by this subnetwork. Provide
         # this property when you create the subnetwork. For example, 10.0.0.0/8 or 192.
         # 168.0.0/16. Ranges must be unique and non-overlapping within a network. Only
-        # IPv4 is supported. This field can be set only at resource creation time.
+        # IPv4 is supported. This field is set at resource creation time. The range can
+        # be expanded after creation using expandIpCidrRange.
         # Corresponds to the JSON property `ipCidrRange`
         # @return [String]
         attr_accessor :ip_cidr_range
@@ -30131,6 +30747,8 @@ module Google
         # must not be set. Conversely if defaultService is set, defaultRouteAction
         # cannot contain any  weightedBackendServices.
         # Only one of defaultRouteAction or defaultUrlRedirect must be set.
+        # UrlMaps for external HTTP(S) load balancers support only the urlRewrite action
+        # within defaultRouteAction.
         # Corresponds to the JSON property `defaultRouteAction`
         # @return [Google::Apis::ComputeV1::HttpRouteAction]
         attr_accessor :default_route_action