google-api-client 0.25.0 → 0.26.0

data/generated/google/apis/cloudsearch_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://gsuite.google.com/products/cloud-search/
     module CloudsearchV1
       VERSION = 'V1'
-      REVISION = '20181029'
+      REVISION = '20181203'
 
       # Index and serve your organization's data with Cloud Search
       AUTH_CLOUD_SEARCH = 'https://www.googleapis.com/auth/cloud_search'

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

@@ -73,6 +73,26 @@ module Google
         end
       end
       
+      # 
+      class CheckAccessResponse
+        include Google::Apis::Core::Hashable
+      
+        # Returns true if principal has access.  Returns false otherwise.
+        # Corresponds to the JSON property `hasAccess`
+        # @return [Boolean]
+        attr_accessor :has_access
+        alias_method :has_access?, :has_access
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @has_access = args[:has_access] if args.key?(:has_access)
+        end
+      end
+      
       # 
       class CompositeFilter
         include Google::Apis::Core::Hashable
@@ -1059,7 +1079,7 @@ module Google
       
         # This property indicates the freshness level of the object in the index.
         # If set, this property must be a top-level property within the
-        # PropertyDefinitions
+        # property definitions
         # and it must be a
         # timestamp type
         # or
@@ -3583,6 +3603,64 @@ module Google
         end
       end
       
+      # 
+      class SearchItemsByViewUrlRequest
+        include Google::Apis::Core::Hashable
+      
+        # Shared request debug options for all cloudsearch RPC methods.
+        # Corresponds to the JSON property `debugOptions`
+        # @return [Google::Apis::CloudsearchV1::DebugOptions]
+        attr_accessor :debug_options
+      
+        # The next_page_token value returned from a previous request, if any.
+        # Corresponds to the JSON property `pageToken`
+        # @return [String]
+        attr_accessor :page_token
+      
+        # Specify the full view URL to find the corresponding item.
+        # The maximum length is 2048 characters.
+        # Corresponds to the JSON property `viewUrl`
+        # @return [String]
+        attr_accessor :view_url
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @debug_options = args[:debug_options] if args.key?(:debug_options)
+          @page_token = args[:page_token] if args.key?(:page_token)
+          @view_url = args[:view_url] if args.key?(:view_url)
+        end
+      end
+      
+      # 
+      class SearchItemsByViewUrlResponse
+        include Google::Apis::Core::Hashable
+      
+        # 
+        # Corresponds to the JSON property `items`
+        # @return [Array<Google::Apis::CloudsearchV1::Item>]
+        attr_accessor :items
+      
+        # Token to retrieve the next page of results, or empty if there are no
+        # more results in the list.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @items = args[:items] if args.key?(:items)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # Additional search quality metadata of the item.
       class SearchQualityMetadata
         include Google::Apis::Core::Hashable

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

@@ -34,6 +34,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CheckAccessResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class CompositeFilter
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -634,6 +640,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class SearchItemsByViewUrlRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class SearchItemsByViewUrlResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class SearchQualityMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -841,6 +859,13 @@ module Google
         end
       end
       
+      class CheckAccessResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :has_access, as: 'hasAccess'
+        end
+      end
+      
       class CompositeFilter
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1824,6 +1849,25 @@ module Google
         end
       end
       
+      class SearchItemsByViewUrlRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :debug_options, as: 'debugOptions', class: Google::Apis::CloudsearchV1::DebugOptions, decorator: Google::Apis::CloudsearchV1::DebugOptions::Representation
+      
+          property :page_token, as: 'pageToken'
+          property :view_url, as: 'viewUrl'
+        end
+      end
+      
+      class SearchItemsByViewUrlResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :items, as: 'items', class: Google::Apis::CloudsearchV1::Item, decorator: Google::Apis::CloudsearchV1::Item::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
       class SearchQualityMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -48,10 +48,86 @@ module Google
           @batch_path = 'batch'
         end
         
+        # Checks whether an item is accessible by specified principal.
+        # @param [String] name
+        #   Item name, format:
+        #   datasources/`source_id`/items/`item_id`
+        # @param [Google::Apis::CloudsearchV1::Principal] principal_object
+        # @param [Boolean] debug_options_enable_debugging
+        #   If set, the request will enable debugging features of Cloud Search.
+        #   Only turn on this field, if asked by Google to help with debugging.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudsearchV1::CheckAccessResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudsearchV1::CheckAccessResponse]
+        #
+        # @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 check_debug_datasource_item_access(name, principal_object = nil, debug_options_enable_debugging: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/debug/{+name}:checkAccess', options)
+          command.request_representation = Google::Apis::CloudsearchV1::Principal::Representation
+          command.request_object = principal_object
+          command.response_representation = Google::Apis::CloudsearchV1::CheckAccessResponse::Representation
+          command.response_class = Google::Apis::CloudsearchV1::CheckAccessResponse
+          command.params['name'] = name unless name.nil?
+          command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Fetches the item whose viewUrl exactly matches that of the URL provided
+        # in the request.
+        # @param [String] name
+        #   Source name, format:
+        #   datasources/`source_id`
+        # @param [Google::Apis::CloudsearchV1::SearchItemsByViewUrlRequest] search_items_by_view_url_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudsearchV1::SearchItemsByViewUrlResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudsearchV1::SearchItemsByViewUrlResponse]
+        #
+        # @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 search_debug_datasource_item_by_view_url(name, search_items_by_view_url_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/debug/{+name}/items:searchByViewUrl', options)
+          command.request_representation = Google::Apis::CloudsearchV1::SearchItemsByViewUrlRequest::Representation
+          command.request_object = search_items_by_view_url_request_object
+          command.response_representation = Google::Apis::CloudsearchV1::SearchItemsByViewUrlResponse::Representation
+          command.response_class = Google::Apis::CloudsearchV1::SearchItemsByViewUrlResponse
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # List all unmapped identities for a specific item.
         # @param [String] parent
         #   The name of the item, in the following format:
         #   datasources/`source_id`/items/`ID`
+        # @param [Boolean] debug_options_enable_debugging
+        #   If set, the request will enable debugging features of Cloud Search.
+        #   Only turn on this field, if asked by Google to help with debugging.
         # @param [Fixnum] page_size
         #   Maximum number of items to fetch in a request.
         #   Defaults to 100.
@@ -74,11 +150,12 @@ module Google
         # @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 list_debug_datasource_item_unmappedids(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_debug_datasource_item_unmappedids(parent, debug_options_enable_debugging: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
           command =  make_simple_command(:get, 'v1/debug/{+parent}/unmappedids', options)
           command.response_representation = Google::Apis::CloudsearchV1::ListUnmappedIdentitiesResponse::Representation
           command.response_class = Google::Apis::CloudsearchV1::ListUnmappedIdentitiesResponse
           command.params['parent'] = parent unless parent.nil?
+          command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
           command.query['fields'] = fields unless fields.nil?
@@ -90,6 +167,9 @@ module Google
         # @param [String] parent
         #   The name of the identity source, in the following format:
         #   identitysources/`source_id``
+        # @param [Boolean] debug_options_enable_debugging
+        #   If set, the request will enable debugging features of Cloud Search.
+        #   Only turn on this field, if asked by Google to help with debugging.
         # @param [String] group_resource_name
         # @param [Fixnum] page_size
         #   Maximum number of items to fetch in a request.
@@ -114,11 +194,12 @@ module Google
         # @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 list_debug_identitysource_item_forunmappedidentity(parent, group_resource_name: nil, page_size: nil, page_token: nil, user_resource_name: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_debug_identitysource_item_forunmappedidentity(parent, debug_options_enable_debugging: nil, group_resource_name: nil, page_size: nil, page_token: nil, user_resource_name: nil, fields: nil, quota_user: nil, options: nil, &block)
           command =  make_simple_command(:get, 'v1/debug/{+parent}/items:forunmappedidentity', options)
           command.response_representation = Google::Apis::CloudsearchV1::ListItemNamesForUnmappedIdentityResponse::Representation
           command.response_class = Google::Apis::CloudsearchV1::ListItemNamesForUnmappedIdentityResponse
           command.params['parent'] = parent unless parent.nil?
+          command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil?
           command.query['groupResourceName'] = group_resource_name unless group_resource_name.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
@@ -132,6 +213,9 @@ module Google
         # @param [String] parent
         #   The name of the identity source, in the following format:
         #   identitysources/`source_id`
+        # @param [Boolean] debug_options_enable_debugging
+        #   If set, the request will enable debugging features of Cloud Search.
+        #   Only turn on this field, if asked by Google to help with debugging.
         # @param [Fixnum] page_size
         #   Maximum number of items to fetch in a request.
         #   Defaults to 100.
@@ -156,11 +240,12 @@ module Google
         # @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 list_debug_identitysource_unmappedids(parent, page_size: nil, page_token: nil, resolution_status_code: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_debug_identitysource_unmappedids(parent, debug_options_enable_debugging: nil, page_size: nil, page_token: nil, resolution_status_code: nil, fields: nil, quota_user: nil, options: nil, &block)
           command =  make_simple_command(:get, 'v1/debug/{+parent}/unmappedids', options)
           command.response_representation = Google::Apis::CloudsearchV1::ListUnmappedIdentitiesResponse::Representation
           command.response_class = Google::Apis::CloudsearchV1::ListUnmappedIdentitiesResponse
           command.params['parent'] = parent unless parent.nil?
+          command.query['debugOptions.enableDebugging'] = debug_options_enable_debugging unless debug_options_enable_debugging.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
           command.query['resolutionStatusCode'] = resolution_status_code unless resolution_status_code.nil?

data/generated/google/apis/composer_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/composer/
     module ComposerV1
       VERSION = 'V1'
-      REVISION = '20181001'
+      REVISION = '20181120'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -552,6 +552,14 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :pypi_packages
       
+        # Optional. The major version of Python used to run the Apache Airflow
+        # scheduler, worker, and webserver processes.
+        # Can be set to '2' or '3'. If not specified, the default is '2'. Cannot be
+        # updated.
+        # Corresponds to the JSON property `pythonVersion`
+        # @return [String]
+        attr_accessor :python_version
+      
         def initialize(**args)
            update!(**args)
         end
@@ -562,6 +570,7 @@ module Google
           @env_variables = args[:env_variables] if args.key?(:env_variables)
           @image_version = args[:image_version] if args.key?(:image_version)
           @pypi_packages = args[:pypi_packages] if args.key?(:pypi_packages)
+          @python_version = args[:python_version] if args.key?(:python_version)
         end
       end
       

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

@@ -179,6 +179,7 @@ module Google
           hash :env_variables, as: 'envVariables'
           property :image_version, as: 'imageVersion'
           hash :pypi_packages, as: 'pypiPackages'
+          property :python_version, as: 'pythonVersion'
         end
       end
       

data/generated/google/apis/compute_alpha.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/compute/docs/reference/latest/
     module ComputeAlpha
       VERSION = 'Alpha'
-      REVISION = '20181017'
+      REVISION = '20181128'
 
       # 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_alpha/classes.rb

@@ -584,7 +584,8 @@ module Google
         # essentially a hash of the labels set used for optimistic locking. The
         # fingerprint is initially generated by Compute Engine and changes after every
         # request to modify or update labels. You must always provide an up-to-date
-        # fingerprint hash in order to update or change labels.
+        # fingerprint hash in order to update or change labels, otherwise the request
+        # will fail with error 412 conditionNotMet.
         # To see the latest fingerprint, make a get() request to retrieve an Address.
         # Corresponds to the JSON property `labelFingerprint`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
@@ -615,7 +616,11 @@ module Google
         attr_accessor :network
       
         # This signifies the networking tier used for configuring this Address and can
-        # only take the following values: PREMIUM , STANDARD.
+        # only take the following values: PREMIUM, STANDARD. Global forwarding rules can
+        # only be Premium Tier. Regional forwarding rules can be either Premium or
+        # Standard Tier. Standard Tier addresses applied to regional forwarding rules
+        # can be used with any external load balancer. Regional forwarding rules in
+        # Premium Tier can only be used with a Network load balancer.
         # If this field is not specified, it is assumed to be PREMIUM.
         # Corresponds to the JSON property `networkTier`
         # @return [String]
@@ -1102,7 +1107,7 @@ module Google
         # @return [Google::Apis::ComputeAlpha::AllocationSpecificSkuAllocation]
         attr_accessor :specific_allocation
       
-        # Indicates whether the allocation can be consumed by VMs with ?any allocation?
+        # Indicates whether the allocation can be consumed by VMs with "any allocation"
         # defined. If the field is set, then only VMs that target the allocation by name
         # using --allocation-affinity can consume this allocation.
         # Corresponds to the JSON property `specificAllocationRequired`
@@ -2597,8 +2602,7 @@ module Google
         attr_accessor :utilization_target
       
         # Defines how target utilization value is expressed for a Stackdriver Monitoring
-        # metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. If not specified,
-        # the default is GAUGE.
+        # metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE.
         # Corresponds to the JSON property `utilizationTargetType`
         # @return [String]
         attr_accessor :utilization_target_type
@@ -2741,15 +2745,21 @@ module Google
         attr_accessor :failover
         alias_method :failover?, :failover
       
-        # The fully-qualified URL of a Instance Group resource. This instance group
-        # defines the list of instances that serve traffic. Member virtual machine
-        # instances from each instance group must live in the same zone as the instance
-        # group itself. No two backends in a backend service are allowed to use same
-        # Instance Group resource.
-        # Note that you must specify an Instance Group resource using the fully-
-        # qualified URL, rather than a partial URL.
+        # The fully-qualified URL of an Instance Group or Network Endpoint Group
+        # resource. In case of instance group this defines the list of instances that
+        # serve traffic. Member virtual machine instances from each instance group must
+        # live in the same zone as the instance group itself. No two backends in a
+        # backend service are allowed to use same Instance Group resource.
+        # For Network Endpoint Groups this defines list of endpoints. All endpoints of
+        # Network Endpoint Group must be hosted on instances located in the same zone as
+        # the Network Endpoint Group.
+        # Backend service can not contain mix of Instance Group and Network Endpoint
+        # Group backends.
+        # Note that you must specify an Instance Group or Network Endpoint Group
+        # resource using the fully-qualified URL, rather than a partial URL.
         # When the BackendService has load balancing scheme INTERNAL, the instance group
-        # must be within the same region as the BackendService.
+        # must be within the same region as the BackendService. Network Endpoint Groups
+        # are not supported for INTERNAL load balancing scheme.
         # Corresponds to the JSON property `group`
         # @return [String]
         attr_accessor :group
@@ -2916,7 +2926,7 @@ module Google
         # considered fresh. After this time period, the response will be revalidated
         # before being served. Defaults to 1hr (3600s). When serving responses to signed
         # URL requests, Cloud CDN will internally behave as though all responses from
-        # this backend had a ?Cache-Control: public, max-age=[TTL]? header, regardless
+        # this backend had a "Cache-Control: public, max-age=[TTL]" header, regardless
         # of any existing Cache-Control header. The actual headers served in responses
         # will not be altered.
         # Corresponds to the JSON property `signedUrlCacheMaxAgeSec`
@@ -3126,7 +3136,8 @@ module Google
         # 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 BackendService. An up-to-date fingerprint must be provided in
-        # order to update the BackendService.
+        # order to update the BackendService, otherwise the request will fail with error
+        # 412 conditionNotMet.
         # To see the latest fingerprint, make a get() request to retrieve a
         # BackendService.
         # Corresponds to the JSON property `fingerprint`
@@ -3169,6 +3180,12 @@ module Google
         # @return [String]
         attr_accessor :load_balancing_scheme
       
+        # The available logging options for the load balancer traffic served by this
+        # backend service.
+        # Corresponds to the JSON property `logConfig`
+        # @return [Google::Apis::ComputeAlpha::BackendServiceLogConfig]
+        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-
@@ -3260,6 +3277,7 @@ module Google
           @id = args[:id] if args.key?(:id)
           @kind = args[:kind] if args.key?(:kind)
           @load_balancing_scheme = args[:load_balancing_scheme] if args.key?(:load_balancing_scheme)
+          @log_config = args[:log_config] if args.key?(:log_config)
           @name = args[:name] if args.key?(:name)
           @port = args[:port] if args.key?(:port)
           @port_name = args[:port_name] if args.key?(:port_name)
@@ -3436,7 +3454,7 @@ module Google
         # considered fresh. After this time period, the response will be revalidated
         # before being served. Defaults to 1hr (3600s). When serving responses to signed
         # URL requests, Cloud CDN will internally behave as though all responses from
-        # this backend had a ?Cache-Control: public, max-age=[TTL]? header, regardless
+        # this backend had a "Cache-Control: public, max-age=[TTL]" header, regardless
         # of any existing Cache-Control header. The actual headers served in responses
         # will not be altered.
         # Corresponds to the JSON property `signedUrlCacheMaxAgeSec`
@@ -3539,7 +3557,13 @@ 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`
         # @return [Array<Google::Apis::ComputeAlpha::HealthStatus>]
         attr_accessor :health_status
@@ -3556,6 +3580,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
@@ -3756,6 +3781,38 @@ module Google
         end
       end
       
+      # The available logging options for the load balancer traffic served by this
+      # backend service.
+      class BackendServiceLogConfig
+        include Google::Apis::Core::Hashable
+      
+        # This field denotes whether to enable logging for the load balancer traffic
+        # served by this backend service.
+        # Corresponds to the JSON property `enable`
+        # @return [Boolean]
+        attr_accessor :enable
+        alias_method :enable?, :enable
+      
+        # This field can only be specified if logging is enabled for this backend
+        # service. The value of the field must be in [0, 1]. This configures the
+        # sampling rate of requests to the load balancer where 1.0 means all logged
+        # requests are reported and 0.0 means no logged requests are reported. The
+        # default value is 1.0.
+        # Corresponds to the JSON property `sampleRate`
+        # @return [Float]
+        attr_accessor :sample_rate
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @enable = args[:enable] if args.key?(:enable)
+          @sample_rate = args[:sample_rate] if args.key?(:sample_rate)
+        end
+      end
+      
       # 
       class BackendServiceReference
         include Google::Apis::Core::Hashable
@@ -4687,7 +4744,8 @@ module Google
         # a hash of the labels set used for optimistic locking. The fingerprint is
         # initially generated by Compute Engine and changes after every request to
         # modify or update labels. You must always provide an up-to-date fingerprint
-        # hash in order to update or change labels.
+        # hash in order to update or change labels, otherwise the request will fail with
+        # error 412 conditionNotMet.
         # To see the latest fingerprint, make a get() request to retrieve a disk.
         # Corresponds to the JSON property `labelFingerprint`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
@@ -4736,10 +4794,9 @@ module Google
         attr_accessor :options
       
         # Physical block size of the persistent disk, in bytes. If not present in a
-        # request, a default value is used. Initially only 4096 is supported, but other
-        # powers of two may be added. If an unsupported value is requested, the error
-        # message will list the supported values, but even a supported value may be
-        # allowed for only some projects.
+        # request, a default value is used. Currently supported sizes are 4096 and 16384,
+        # other sizes may be added in the future. If an unsupported value is requested,
+        # the error message will list the supported values for the caller's project.
         # Corresponds to the JSON property `physicalBlockSizeBytes`
         # @return [Fixnum]
         attr_accessor :physical_block_size_bytes
@@ -5785,6 +5842,26 @@ module Google
         end
       end
       
+      # A set of Display Device options
+      class DisplayDevice
+        include Google::Apis::Core::Hashable
+      
+        # Defines whether the instance has Display enabled.
+        # Corresponds to the JSON property `enableDisplay`
+        # @return [Boolean]
+        attr_accessor :enable_display
+        alias_method :enable_display?, :enable_display
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @enable_display = args[:enable_display] if args.key?(:enable_display)
+        end
+      end
+      
       # 
       class DistributionPolicy
         include Google::Apis::Core::Hashable
@@ -5825,6 +5902,168 @@ module Google
         end
       end
       
+      # 
+      class ExchangedPeeringRoute
+        include Google::Apis::Core::Hashable
+      
+        # The destination range of the route.
+        # Corresponds to the JSON property `destRange`
+        # @return [String]
+        attr_accessor :dest_range
+      
+        # If the peering route is imported if there is no confliction.
+        # Corresponds to the JSON property `imported`
+        # @return [Boolean]
+        attr_accessor :imported
+        alias_method :imported?, :imported
+      
+        # The region of peering route next hop, only applies to dynamic routes.
+        # Corresponds to the JSON property `nextHopRegion`
+        # @return [String]
+        attr_accessor :next_hop_region
+      
+        # The priority of the peering route.
+        # Corresponds to the JSON property `priority`
+        # @return [Fixnum]
+        attr_accessor :priority
+      
+        # The type of the peering route.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @dest_range = args[:dest_range] if args.key?(:dest_range)
+          @imported = args[:imported] if args.key?(:imported)
+          @next_hop_region = args[:next_hop_region] if args.key?(:next_hop_region)
+          @priority = args[:priority] if args.key?(:priority)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
+      # 
+      class ExchangedPeeringRoutesList
+        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 ExchangedPeeringRoute resources.
+        # Corresponds to the JSON property `items`
+        # @return [Array<Google::Apis::ComputeAlpha::ExchangedPeeringRoute>]
+        attr_accessor :items
+      
+        # [Output Only] Type of resource. Always compute#exchangedPeeringRoutesList for
+        # exchanged peering routes lists.
+        # 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::ComputeAlpha::ExchangedPeeringRoutesList::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::ComputeAlpha::ExchangedPeeringRoutesList::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 expression text. Example:
       # title: "User account presence" description: "Determines whether the request
       # has a user account" expression: "size(request.user) > 0"
@@ -5919,8 +6158,9 @@ module Google
         attr_accessor :disabled
         alias_method :disabled?, :disabled
       
-        # This field denotes whether to enable logging for a particular firewall rule.
-        # If logging is enabled, logs will be exported to Stackdriver.
+        # Deprecated in favor of enable in LogConfig. This field denotes whether to
+        # enable logging for a particular firewall rule. If logging is enabled, logs
+        # will be exported to Stackdriver.
         # Corresponds to the JSON property `enableLogging`
         # @return [Boolean]
         attr_accessor :enable_logging
@@ -5937,6 +6177,11 @@ module Google
         # @return [String]
         attr_accessor :kind
       
+        # The available logging options for a firewall rule.
+        # Corresponds to the JSON property `logConfig`
+        # @return [Google::Apis::ComputeAlpha::FirewallLogConfig]
+        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-
@@ -6047,6 +6292,7 @@ module Google
           @enable_logging = args[:enable_logging] if args.key?(:enable_logging)
           @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)
           @network = args[:network] if args.key?(:network)
           @priority = args[:priority] if args.key?(:priority)
@@ -6239,6 +6485,26 @@ module Google
         end
       end
       
+      # The available logging options for a firewall rule.
+      class FirewallLogConfig
+        include Google::Apis::Core::Hashable
+      
+        # This field denotes whether to enable logging for a particular firewall rule.
+        # 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
+      
       # Encapsulates numeric value that can be either absolute or relative.
       class FixedOrPercent
         include Google::Apis::Core::Hashable
@@ -6399,7 +6665,8 @@ module Google
         # essentially a hash of the labels set used for optimistic locking. The
         # fingerprint is initially generated by Compute Engine and changes after every
         # request to modify or update labels. You must always provide an up-to-date
-        # fingerprint hash in order to update or change labels.
+        # fingerprint hash in order to update or change labels, otherwise the request
+        # will fail with error 412 conditionNotMet.
         # To see the latest fingerprint, make a get() request to retrieve a
         # ForwardingRule.
         # Corresponds to the JSON property `labelFingerprint`
@@ -6472,9 +6739,9 @@ module Google
       
         # This field is used along with the backend_service field for internal load
         # balancing.
-        # When the load balancing scheme is INTERNAL, a single port or a comma separated
-        # list of ports can be configured. Only packets addressed to these ports will be
-        # forwarded to the backends configured with this forwarding rule.
+        # When the load balancing scheme is INTERNAL, a list of ports can be configured,
+        # for example, ['80'], ['8000','9000'] etc. Only packets addressed to these
+        # ports will be forwarded to the backends configured with this forwarding rule.
         # You may specify a maximum of up to 5 ports.
         # Corresponds to the JSON property `ports`
         # @return [Array<String>]
@@ -6918,8 +7185,9 @@ module Google
         # The fingerprint of the previous set of labels for this resource, used to
         # detect conflicts. The fingerprint is initially generated by Compute Engine and
         # changes after every request to modify or update labels. You must always
-        # provide an up-to-date fingerprint hash when updating or changing labels. Make
-        # a get() request to the resource to get the latest fingerprint.
+        # provide an up-to-date fingerprint hash when updating or changing labels,
+        # otherwise the request will fail with error 412 conditionNotMet. Make a get()
+        # request to the resource to get the latest fingerprint.
         # Corresponds to the JSON property `labelFingerprint`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -6951,7 +7219,7 @@ module Google
       class GlobalSetPolicyRequest
         include Google::Apis::Core::Hashable
       
-        # Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use '
+        # Flatten Policy to create a backward compatible wire-format. Deprecated. Use '
         # policy' to specify bindings.
         # Corresponds to the JSON property `bindings`
         # @return [Array<Google::Apis::ComputeAlpha::Binding>]
@@ -7839,6 +8107,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]
@@ -7865,6 +8138,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)
@@ -8465,7 +8739,8 @@ module Google
         # a hash of the labels used for optimistic locking. The fingerprint is initially
         # generated by Compute Engine and changes after every request to modify or
         # update labels. You must always provide an up-to-date fingerprint hash in order
-        # to update or change labels.
+        # to update or change labels, otherwise the request will fail with error 412
+        # conditionNotMet.
         # To see the latest fingerprint, make a get() request to retrieve an image.
         # Corresponds to the JSON property `labelFingerprint`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
@@ -8824,6 +9099,11 @@ module Google
         # @return [Array<Google::Apis::ComputeAlpha::AttachedDisk>]
         attr_accessor :disks
       
+        # A set of Display Device options
+        # Corresponds to the JSON property `displayDevice`
+        # @return [Google::Apis::ComputeAlpha::DisplayDevice]
+        attr_accessor :display_device
+      
         # A list of the type and count of accelerator cards attached to the instance.
         # Corresponds to the JSON property `guestAccelerators`
         # @return [Array<Google::Apis::ComputeAlpha::AcceleratorConfig>]
@@ -9003,6 +9283,7 @@ module Google
           @deletion_protection = args[:deletion_protection] if args.key?(:deletion_protection)
           @description = args[:description] if args.key?(:description)
           @disks = args[:disks] if args.key?(:disks)
+          @display_device = args[:display_device] if args.key?(:display_device)
           @guest_accelerators = args[:guest_accelerators] if args.key?(:guest_accelerators)
           @hostname = args[:hostname] if args.key?(:hostname)
           @id = args[:id] if args.key?(:id)
@@ -9546,7 +9827,8 @@ module Google
       
         # Fingerprint of this resource. This field may be used in optimistic locking. It
         # will be ignored when inserting an InstanceGroupManager. An up-to-date
-        # fingerprint must be provided in order to update the InstanceGroupManager.
+        # fingerprint must be provided in order to update the InstanceGroupManager,
+        # otherwise the request will fail with error 412 conditionNotMet.
         # To see the latest fingerprint, make a get() request to retrieve an
         # InstanceGroupManager.
         # Corresponds to the JSON property `fingerprint`
@@ -10301,6 +10583,25 @@ module Google
         end
       end
       
+      # InstanceGroupManagers.createInstances
+      class InstanceGroupManagersCreateInstancesRequest
+        include Google::Apis::Core::Hashable
+      
+        # [Required] List of specifications of per-instance configs.
+        # Corresponds to the JSON property `instances`
+        # @return [Array<Google::Apis::ComputeAlpha::PerInstanceConfig>]
+        attr_accessor :instances
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @instances = args[:instances] if args.key?(:instances)
+        end
+      end
+      
       # 
       class InstanceGroupManagersDeleteInstancesRequest
         include Google::Apis::Core::Hashable
@@ -10331,6 +10632,12 @@ module Google
         # @return [Array<String>]
         attr_accessor :instances
       
+        # The list of instance names for which we want to delete per-instance configs on
+        # this managed instance group.
+        # Corresponds to the JSON property `names`
+        # @return [Array<String>]
+        attr_accessor :names
+      
         def initialize(**args)
            update!(**args)
         end
@@ -10338,6 +10645,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @instances = args[:instances] if args.key?(:instances)
+          @names = args[:names] if args.key?(:names)
         end
       end
       
@@ -10497,7 +10805,7 @@ module Google
         # instances initiated by this resize request only once. If there is an error
         # during creation, the managed instance group does not retry create this
         # instance, and we will decrease the targetSize of the request instead. If the
-        # flag is false, the group attemps to recreate each instance continuously until
+        # flag is false, the group attempts to recreate each instance continuously until
         # it succeeds.
         # This flag matters only in the first attempt of creation of an instance. After
         # an instance is successfully created while this flag is enabled, the instance
@@ -10995,7 +11303,8 @@ module Google
         # named ports settings concurrently. Obtain the fingerprint with the
         # instanceGroups.get method. Then, include the fingerprint in your request to
         # ensure that you do not overwrite changes that were applied from another
-        # concurrent request.
+        # concurrent request. A request with an incorrect fingerprint will fail with
+        # error 412 conditionNotMet.
         # Corresponds to the JSON property `fingerprint`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -12036,7 +12345,8 @@ module Google
         # essentially a hash of the labels set used for optimistic locking. The
         # fingerprint is initially generated by Compute Engine and changes after every
         # request to modify or update labels. You must always provide an up-to-date
-        # fingerprint hash in order to update or change labels.
+        # fingerprint hash in order to update or change labels, otherwise the request
+        # will fail with error 412 conditionNotMet.
         # To see the latest fingerprint, make a get() request to retrieve an
         # Interconnect.
         # Corresponds to the JSON property `labelFingerprint`
@@ -12163,14 +12473,9 @@ module Google
         attr_accessor :admin_enabled
         alias_method :admin_enabled?, :admin_enabled
       
-        # [Deprecated] Replaced by edge_availability_domain.
-        # Corresponds to the JSON property `availabilityZone`
-        # @return [String]
-        attr_accessor :availability_zone
-      
         # Provisioned bandwidth capacity for the interconnectAttachment. Can be set by
         # the partner to update the customer's provisioned bandwidth. Output only for
-        # for PARTNER type, mutable for PARTNER_PROVIDER, not available for DEDICATED.
+        # PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED.
         # Corresponds to the JSON property `bandwidth`
         # @return [String]
         attr_accessor :bandwidth
@@ -12246,7 +12551,8 @@ module Google
         # which is essentially a hash of the labels set used for optimistic locking. The
         # fingerprint is initially generated by Compute Engine and changes after every
         # request to modify or update labels. You must always provide an up-to-date
-        # fingerprint hash in order to update or change labels.
+        # fingerprint hash in order to update or change labels, otherwise the request
+        # will fail with error 412 conditionNotMet.
         # To see the latest fingerprint, make a get() request to retrieve an
         # InterconnectAttachment.
         # Corresponds to the JSON property `labelFingerprint`
@@ -12312,7 +12618,7 @@ module Google
         # @return [String]
         attr_accessor :region
       
-        # URL of the cloud router to be used for dynamic routing. This router must be in
+        # URL of the Cloud Router to be used for dynamic routing. This router must be in
         # the same region as this InterconnectAttachment. The InterconnectAttachment
         # will automatically connect the Interconnect to the network & region within
         # which the Cloud Router is configured.
@@ -12335,9 +12641,8 @@ module Google
         # @return [String]
         attr_accessor :type
       
-        # Available only for DEDICATED and PARTNER_PROVIDER. Desired VLAN tag for this
-        # attachment, in the range 2-4094. This field refers to 802.1q VLAN tag, also
-        # known as IEEE 802.1Q Only specified at creation time.
+        # The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4094. Only
+        # specified at creation time.
         # Corresponds to the JSON property `vlanTag8021q`
         # @return [Fixnum]
         attr_accessor :vlan_tag8021q
@@ -12349,7 +12654,6 @@ module Google
         # Update properties of this object
         def update!(**args)
           @admin_enabled = args[:admin_enabled] if args.key?(:admin_enabled)
-          @availability_zone = args[:availability_zone] if args.key?(:availability_zone)
           @bandwidth = args[:bandwidth] if args.key?(:bandwidth)
           @candidate_subnets = args[:candidate_subnets] if args.key?(:candidate_subnets)
           @cloud_router_ip_address = args[:cloud_router_ip_address] if args.key?(:cloud_router_ip_address)
@@ -12622,7 +12926,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]
@@ -12899,7 +13203,10 @@ module Google
         # @return [String]
         attr_accessor :state
       
-        # Value of the current optical power, read in dBm.
+        # Value of the current optical power, read in dBm. Take a known good optical
+        # value, give it a 10% margin and trigger warnings relative to that value. In
+        # general, a -7dBm warning and a -11dBm alarm are good optical value estimates
+        # for most links.
         # Corresponds to the JSON property `value`
         # @return [Float]
         attr_accessor :value
@@ -14180,6 +14487,10 @@ module Google
       
         # Whether Gin logging should happen in a fail-closed manner at the caller. This
         # is relevant only in the LocalIAM implementation, for now.
+        # NOTE: Logging to Gin in a fail-closed manner is currently unsupported while
+        # work is being done to satisfy the requirements of go/345. Currently, setting
+        # LOG_FAIL_CLOSED mode will have no effect, but still exists because there is
+        # active work being done to support it (b/115874152).
         # Corresponds to the JSON property `logMode`
         # @return [String]
         attr_accessor :log_mode
@@ -14870,6 +15181,11 @@ module Google
         # @return [String]
         attr_accessor :instance
       
+        # [Output Only] Health state of the instance per health-check.
+        # Corresponds to the JSON property `instanceHealth`
+        # @return [Array<Google::Apis::ComputeAlpha::ManagedInstanceInstanceHealth>]
+        attr_accessor :instance_health
+      
         # [Output Only] The status of the instance. This field is empty when the
         # instance does not exist.
         # Corresponds to the JSON property `instanceStatus`
@@ -14893,6 +15209,16 @@ module Google
         # @return [Google::Apis::ComputeAlpha::ManagedInstanceOverride]
         attr_accessor :override
       
+        # Preserved state for a given instance.
+        # Corresponds to the JSON property `preservedStateFromConfig`
+        # @return [Google::Apis::ComputeAlpha::PreservedState]
+        attr_accessor :preserved_state_from_config
+      
+        # Preserved state for a given instance.
+        # Corresponds to the JSON property `preservedStateFromPolicy`
+        # @return [Google::Apis::ComputeAlpha::PreservedState]
+        attr_accessor :preserved_state_from_policy
+      
         # [Output Only] Tag describing the version.
         # Corresponds to the JSON property `tag`
         # @return [String]
@@ -14912,15 +15238,44 @@ module Google
           @current_action = args[:current_action] if args.key?(:current_action)
           @id = args[:id] if args.key?(:id)
           @instance = args[:instance] if args.key?(:instance)
+          @instance_health = args[:instance_health] if args.key?(:instance_health)
           @instance_status = args[:instance_status] if args.key?(:instance_status)
           @instance_template = args[:instance_template] if args.key?(:instance_template)
           @last_attempt = args[:last_attempt] if args.key?(:last_attempt)
           @override = args[:override] if args.key?(:override)
+          @preserved_state_from_config = args[:preserved_state_from_config] if args.key?(:preserved_state_from_config)
+          @preserved_state_from_policy = args[:preserved_state_from_policy] if args.key?(:preserved_state_from_policy)
           @tag = args[:tag] if args.key?(:tag)
           @version = args[:version] if args.key?(:version)
         end
       end
       
+      # 
+      class ManagedInstanceInstanceHealth
+        include Google::Apis::Core::Hashable
+      
+        # [Output Only] The URL for the health check that verifies whether the instance
+        # is healthy.
+        # Corresponds to the JSON property `healthCheck`
+        # @return [String]
+        attr_accessor :health_check
+      
+        # [Output Only] The current instance health state.
+        # Corresponds to the JSON property `healthState`
+        # @return [String]
+        attr_accessor :health_state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @health_check = args[:health_check] if args.key?(:health_check)
+          @health_state = args[:health_state] if args.key?(:health_state)
+        end
+      end
+      
       # 
       class ManagedInstanceLastAttempt
         include Google::Apis::Core::Hashable
@@ -15125,7 +15480,8 @@ module Google
         # metadata's contents and used for optimistic locking. The fingerprint is
         # initially generated by Compute Engine and changes after every request to
         # modify or update metadata. You must always provide an up-to-date fingerprint
-        # hash in order to update or change metadata.
+        # hash in order to update or change metadata, otherwise the request will fail
+        # with error 412 conditionNotMet.
         # To see the latest fingerprint, make a get() request to retrieve the resource.
         # Corresponds to the JSON property `fingerprint`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
@@ -15332,6 +15688,11 @@ 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
+      
         # 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.
@@ -15361,6 +15722,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @annotations = args[:annotations] if args.key?(:annotations)
           @instance = args[:instance] if args.key?(:instance)
           @ip_address = args[:ip_address] if args.key?(:ip_address)
           @port = args[:port] if args.key?(:port)
@@ -15371,6 +15733,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]
@@ -15460,6 +15827,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)
@@ -16063,7 +16431,8 @@ module Google
       
         # Fingerprint hash of contents stored in this network interface. This field will
         # be ignored when inserting an Instance or adding a NetworkInterface. An up-to-
-        # date fingerprint must be provided in order to update the NetworkInterface.
+        # date fingerprint must be provided in order to update the NetworkInterface,
+        # otherwise the request will fail with error 412 conditionNotMet.
         # Corresponds to the JSON property `fingerprint`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -16258,15 +16627,31 @@ module Google
       class NetworkPeering
         include Google::Apis::Core::Hashable
       
-        # Whether full mesh connectivity is created and managed automatically. When it
-        # is set to true, Google Compute Engine will automatically create and manage the
-        # routes between two networks when the state is ACTIVE. Otherwise, user needs to
-        # create routes manually to route packets to peer network.
-        # Corresponds to the JSON property `autoCreateRoutes`
+        # Whether Cloud Routers in this network can automatically advertise subnets from
+        # the peer network.
+        # Corresponds to the JSON property `advertisePeerSubnetsViaRouters`
+        # @return [Boolean]
+        attr_accessor :advertise_peer_subnets_via_routers
+        alias_method :advertise_peer_subnets_via_routers?, :advertise_peer_subnets_via_routers
+      
+        # Indicates whether full mesh connectivity is created and managed automatically.
+        # When it is set to true, Google Compute Engine will automatically create and
+        # manage the routes between two networks when the state is ACTIVE. Otherwise,
+        # user needs to create routes manually to route packets to peer network.
+        # Corresponds to the JSON property `autoCreateRoutes`
         # @return [Boolean]
         attr_accessor :auto_create_routes
         alias_method :auto_create_routes?, :auto_create_routes
       
+        # Whether full mesh connectivity is created and managed automatically. When it
+        # is set to true, Google Compute Engine will automatically create and manage the
+        # routes between two networks when the peering state is ACTIVE. Otherwise, user
+        # needs to create routes manually to route packets to peer network.
+        # Corresponds to the JSON property `exchangeSubnetRoutes`
+        # @return [Boolean]
+        attr_accessor :exchange_subnet_routes
+        alias_method :exchange_subnet_routes?, :exchange_subnet_routes
+      
         # Whether to export the custom routes to peer network.
         # Corresponds to the JSON property `exportCustomRoutes`
         # @return [Boolean]
@@ -16313,7 +16698,9 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @advertise_peer_subnets_via_routers = args[:advertise_peer_subnets_via_routers] if args.key?(:advertise_peer_subnets_via_routers)
           @auto_create_routes = args[:auto_create_routes] if args.key?(:auto_create_routes)
+          @exchange_subnet_routes = args[:exchange_subnet_routes] if args.key?(:exchange_subnet_routes)
           @export_custom_routes = args[:export_custom_routes] if args.key?(:export_custom_routes)
           @import_custom_routes = args[:import_custom_routes] if args.key?(:import_custom_routes)
           @name = args[:name] if args.key?(:name)
@@ -16357,13 +16744,15 @@ module Google
         attr_accessor :auto_create_routes
         alias_method :auto_create_routes?, :auto_create_routes
       
-        # Whether to export the custom routes to peer network.
+        # This field will be deprecated soon. Prefer using export_custom_routes in
+        # network_peering instead. Whether to export the custom routes to peer network.
         # Corresponds to the JSON property `exportCustomRoutes`
         # @return [Boolean]
         attr_accessor :export_custom_routes
         alias_method :export_custom_routes?, :export_custom_routes
       
-        # Whether to import the custom routes from peer network.
+        # This field will be deprecated soon. Prefer using import_custom_routes in
+        # network_peering instead. Whether to import the custom routes from peer network.
         # Corresponds to the JSON property `importCustomRoutes`
         # @return [Boolean]
         attr_accessor :import_custom_routes
@@ -16374,6 +16763,13 @@ module Google
         # @return [String]
         attr_accessor :name
       
+        # A network peering attached to a network resource. The message includes the
+        # peering name, peer network, peering state, and a flag indicating whether
+        # Google Compute Engine should automatically create routes for the peering.
+        # Corresponds to the JSON property `networkPeering`
+        # @return [Google::Apis::ComputeAlpha::NetworkPeering]
+        attr_accessor :network_peering
+      
         # URL of the peer network. It can be either full URL or partial URL. The peer
         # network may belong to a different project. If the partial URL does not contain
         # project, it is assumed that the peer network is in the same project as the
@@ -16392,6 +16788,7 @@ module Google
           @export_custom_routes = args[:export_custom_routes] if args.key?(:export_custom_routes)
           @import_custom_routes = args[:import_custom_routes] if args.key?(:import_custom_routes)
           @name = args[:name] if args.key?(:name)
+          @network_peering = args[:network_peering] if args.key?(:network_peering)
           @peer_network = args[:peer_network] if args.key?(:peer_network)
         end
       end
@@ -16440,6 +16837,11 @@ module Google
       class NodeGroup
         include Google::Apis::Core::Hashable
       
+        # 
+        # Corresponds to the JSON property `autoscalingPolicy`
+        # @return [Google::Apis::ComputeAlpha::NodeGroupAutoscalingPolicy]
+        attr_accessor :autoscaling_policy
+      
         # [Output Only] Creation timestamp in RFC3339 text format.
         # Corresponds to the JSON property `creationTimestamp`
         # @return [String]
@@ -16506,6 +16908,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @autoscaling_policy = args[:autoscaling_policy] if args.key?(:autoscaling_policy)
           @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp)
           @description = args[:description] if args.key?(:description)
           @id = args[:id] if args.key?(:id)
@@ -16637,6 +17040,31 @@ module Google
         end
       end
       
+      # 
+      class NodeGroupAutoscalingPolicy
+        include Google::Apis::Core::Hashable
+      
+        # 
+        # Corresponds to the JSON property `maxSize`
+        # @return [Fixnum]
+        attr_accessor :max_size
+      
+        # 
+        # Corresponds to the JSON property `minSize`
+        # @return [Fixnum]
+        attr_accessor :min_size
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @max_size = args[:max_size] if args.key?(:max_size)
+          @min_size = args[:min_size] if args.key?(:min_size)
+        end
+      end
+      
       # Contains a list of nodeGroups.
       class NodeGroupList
         include Google::Apis::Core::Hashable
@@ -17097,8 +17525,8 @@ module Google
         # 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 charaicter, which cannot be
-        # a dash.
+        # 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
@@ -18576,13 +19004,21 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The full or partial URL to the BackendService resource. This will be used if
-        # none of the pathRules defined by this PathMatcher is matched by the URL's path
-        # portion. For example, the following are all valid URLs to a BackendService
-        # resource:
+        # none of the pathRules or routeRules defined by this PathMatcher are matched.
+        # For example, the following are all valid URLs to a BackendService resource:
         # - https://www.googleapis.com/compute/v1/projects/project/global/
         # backendServices/backendService
         # - compute/v1/projects/project/global/backendServices/backendService
         # - global/backendServices/backendService
+        # Use defaultService instead of defaultRouteAction when simple routing to a
+        # backend service is desired and other advanced capabilities like traffic
+        # splitting and URL rewrites are not required.
+        # Only one of defaultService, defaultRouteAction or defaultUrlRedirect must be
+        # set.
+        # Authorization requires one or more of the following Google IAM permissions on
+        # the specified resource default_service:
+        # - compute.backendBuckets.use
+        # - compute.backendServices.use
         # Corresponds to the JSON property `defaultService`
         # @return [String]
         attr_accessor :default_service
@@ -18598,7 +19034,13 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The list of path rules.
+        # The list of path rules. Use this list instead of routeRules when routing based
+        # on simple path matching is all that's required. The order by which path rules
+        # are specified does not matter. Matches are always done on the longest-path-
+        # first basis.
+        # For example: a pathRule with a path /a/b/c/* will match before /a/b/*
+        # irrespective of the order in which those paths appear in this list.
+        # Only one of pathRules or routeRules must be set.
         # Corresponds to the JSON property `pathRules`
         # @return [Array<Google::Apis::ComputeAlpha::PathRule>]
         attr_accessor :path_rules
@@ -18629,7 +19071,11 @@ module Google
         # @return [Array<String>]
         attr_accessor :paths
       
-        # The URL of the BackendService resource if this rule is matched.
+        # The URL of the backend service resource if this rule is matched.
+        # Use service instead of routeAction when simple routing to a backend service is
+        # desired and other advanced capabilities like traffic splitting and rewrites
+        # are not required.
+        # Only one of service, routeAction or urlRedirect should must be set.
         # Corresponds to the JSON property `service`
         # @return [String]
         attr_accessor :service
@@ -18665,11 +19111,26 @@ module Google
         # @return [String]
         attr_accessor :instance
       
+        # The name of the per-instance config and the corresponding instance. Serves as
+        # a merge key during UpdatePerInstanceConfigs operation, i.e. if per-instance
+        # config with the same name exists then it will be updated, otherwise a new one
+        # will be created for the VM instance with the same name. An attempt to create a
+        # per-instance config for a VM instance that either doesn't exist or is not part
+        # of the group will result in a failure.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
         # Overrides of stateful properties for a given instance
         # Corresponds to the JSON property `override`
         # @return [Google::Apis::ComputeAlpha::ManagedInstanceOverride]
         attr_accessor :override
       
+        # Preserved state for a given instance.
+        # Corresponds to the JSON property `preservedState`
+        # @return [Google::Apis::ComputeAlpha::PreservedState]
+        attr_accessor :preserved_state
+      
         def initialize(**args)
            update!(**args)
         end
@@ -18678,7 +19139,9 @@ module Google
         def update!(**args)
           @fingerprint = args[:fingerprint] if args.key?(:fingerprint)
           @instance = args[:instance] if args.key?(:instance)
+          @name = args[:name] if args.key?(:name)
           @override = args[:override] if args.key?(:override)
+          @preserved_state = args[:preserved_state] if args.key?(:preserved_state)
         end
       end
       
@@ -18783,6 +19246,69 @@ module Google
         end
       end
       
+      # Preserved state for a given instance.
+      class PreservedState
+        include Google::Apis::Core::Hashable
+      
+        # Preserved disks defined for this instance. This map is keyed with the device
+        # names of the disks.
+        # Corresponds to the JSON property `disks`
+        # @return [Hash<String,Google::Apis::ComputeAlpha::PreservedStatePreservedDisk>]
+        attr_accessor :disks
+      
+        # Preserved metadata defined for this instance.
+        # Corresponds to the JSON property `metadata`
+        # @return [Hash<String,String>]
+        attr_accessor :metadata
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @disks = args[:disks] if args.key?(:disks)
+          @metadata = args[:metadata] if args.key?(:metadata)
+        end
+      end
+      
+      # 
+      class PreservedStatePreservedDisk
+        include Google::Apis::Core::Hashable
+      
+        # These stateful disks will never be deleted during autohealing, update,
+        # instance recreate operations. This flag is used to configure if the disk
+        # should be deleted after it is no longer used by the group, e.g. when the given
+        # instance or the whole MIG is deleted. Note: disks attached in READ_ONLY mode
+        # cannot be auto-deleted.
+        # Corresponds to the JSON property `autoDelete`
+        # @return [String]
+        attr_accessor :auto_delete
+      
+        # The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not
+        # specified, the default is to attach the disk in READ_WRITE mode.
+        # Corresponds to the JSON property `mode`
+        # @return [String]
+        attr_accessor :mode
+      
+        # The URL of the disk resource that is stateful and should be attached to the VM
+        # instance.
+        # Corresponds to the JSON property `source`
+        # @return [String]
+        attr_accessor :source
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @auto_delete = args[:auto_delete] if args.key?(:auto_delete)
+          @mode = args[:mode] if args.key?(:mode)
+          @source = args[:source] if args.key?(:source)
+        end
+      end
+      
       # A Project resource. For an overview of projects, see  Cloud Platform Resource
       # Hierarchy. (== resource_for v1.projects ==) (== resource_for beta.projects ==)
       class Project
@@ -19581,6 +20107,12 @@ module Google
         # @return [Array<String>]
         attr_accessor :instances
       
+        # The list of instance names for which we want to delete per-instance configs on
+        # this managed instance group.
+        # Corresponds to the JSON property `names`
+        # @return [Array<String>]
+        attr_accessor :names
+      
         def initialize(**args)
            update!(**args)
         end
@@ -19588,6 +20120,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @instances = args[:instances] if args.key?(:instances)
+          @names = args[:names] if args.key?(:names)
         end
       end
       
@@ -20439,6 +20972,12 @@ module Google
       class ResourceCommitment
         include Google::Apis::Core::Hashable
       
+        # Name of the accelerator type resource. Applicable only when the type is
+        # ACCELERATOR.
+        # Corresponds to the JSON property `acceleratorType`
+        # @return [String]
+        attr_accessor :accelerator_type
+      
         # The amount of the resource purchased (in a type-dependent unit, such as bytes).
         # For vCPUs, this can just be an integer. For memory, this must be provided in
         # MB. Memory must be a multiple of 256 MB, with up to 6.5GB of memory per every
@@ -20459,6 +20998,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @accelerator_type = args[:accelerator_type] if args.key?(:accelerator_type)
           @amount = args[:amount] if args.key?(:amount)
           @type = args[:type] if args.key?(:type)
         end
@@ -20468,7 +21008,8 @@ module Google
       class ResourceGroupReference
         include Google::Apis::Core::Hashable
       
-        # A URI referencing one of the instance groups listed in the backend service.
+        # A URI referencing one of the instance groups or network endpoint groups listed
+        # in the backend service.
         # Corresponds to the JSON property `group`
         # @return [String]
         attr_accessor :group
@@ -20580,7 +21121,7 @@ module Google
       
         # A backup schedule policy specifies when and how frequently snapshots are to be
         # created for the target disk. Also specifies how many and how long these
-        # automatically created snapshot should be retained.
+        # scheduled snapshots should be retained.
         # Corresponds to the JSON property `backupSchedulePolicy`
         # @return [Google::Apis::ComputeAlpha::ResourcePolicyBackupSchedulePolicy]
         attr_accessor :backup_schedule_policy
@@ -20776,11 +21317,11 @@ module Google
       
       # A backup schedule policy specifies when and how frequently snapshots are to be
       # created for the target disk. Also specifies how many and how long these
-      # automatically created snapshot should be retained.
+      # scheduled snapshots should be retained.
       class ResourcePolicyBackupSchedulePolicy
         include Google::Apis::Core::Hashable
       
-        # Policy for retention of automatically created snapshots.
+        # Policy for retention of scheduled snapshots.
         # Corresponds to the JSON property `retentionPolicy`
         # @return [Google::Apis::ComputeAlpha::ResourcePolicyBackupSchedulePolicyRetentionPolicy]
         attr_accessor :retention_policy
@@ -20790,7 +21331,7 @@ module Google
         # @return [Google::Apis::ComputeAlpha::ResourcePolicyBackupSchedulePolicySchedule]
         attr_accessor :schedule
       
-        # Specified snapshot properties for automatic snapshots created by this policy.
+        # Specified snapshot properties for scheduled snapshots created by this policy.
         # Corresponds to the JSON property `snapshotProperties`
         # @return [Google::Apis::ComputeAlpha::ResourcePolicyBackupSchedulePolicySnapshotProperties]
         attr_accessor :snapshot_properties
@@ -20807,7 +21348,7 @@ module Google
         end
       end
       
-      # Policy for retention of automatically created snapshots.
+      # Policy for retention of scheduled snapshots.
       class ResourcePolicyBackupSchedulePolicyRetentionPolicy
         include Google::Apis::Core::Hashable
       
@@ -20816,6 +21357,18 @@ module Google
         # @return [Fixnum]
         attr_accessor :max_retention_days
       
+        # Specifies the behavior to apply to existing, scheduled snapshots snapshots if
+        # the policy is changed.
+        # Corresponds to the JSON property `onPolicySwitch`
+        # @return [String]
+        attr_accessor :on_policy_switch
+      
+        # Specifies the behavior to apply to scheduled snapshots when the source disk is
+        # deleted.
+        # Corresponds to the JSON property `onSourceDiskDelete`
+        # @return [String]
+        attr_accessor :on_source_disk_delete
+      
         def initialize(**args)
            update!(**args)
         end
@@ -20823,6 +21376,8 @@ module Google
         # Update properties of this object
         def update!(**args)
           @max_retention_days = args[:max_retention_days] if args.key?(:max_retention_days)
+          @on_policy_switch = args[:on_policy_switch] if args.key?(:on_policy_switch)
+          @on_source_disk_delete = args[:on_source_disk_delete] if args.key?(:on_source_disk_delete)
         end
       end
       
@@ -20857,7 +21412,7 @@ module Google
         end
       end
       
-      # Specified snapshot properties for automatic snapshots created by this policy.
+      # Specified snapshot properties for scheduled snapshots created by this policy.
       class ResourcePolicyBackupSchedulePolicySnapshotProperties
         include Google::Apis::Core::Hashable
       
@@ -20867,7 +21422,7 @@ module Google
         attr_accessor :guest_flush
         alias_method :guest_flush?, :guest_flush
       
-        # Labels to apply to automatic snapshots. These can be later modified by the
+        # Labels to apply to scheduled snapshots. These can be later modified by the
         # setLabels method. Label values may be empty.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
@@ -20905,8 +21460,8 @@ module Google
         # @return [String]
         attr_accessor :duration
       
-        # Time within the window to start the operations. It must be in format "HH:MM?,
-        # where HH : [00-23] and MM : [00-59] GMT.
+        # Time within the window to start the operations. It must be in format "HH:MM",
+        # where HH : [00-23] and MM : [00-00] GMT.
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
@@ -20938,8 +21493,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :hours_in_cycle
       
-        # Time within the window to start the operations. It must be in format "HH:MM?,
-        # where HH : [00-23] and MM : [00-59] GMT.
+        # Time within the window to start the operations. It must be in format "HH:MM",
+        # where HH : [00-23] and MM : [00-00] GMT.
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
@@ -21155,8 +21710,8 @@ module Google
         # @return [String]
         attr_accessor :duration
       
-        # Time within the window to start the operations. It must be in format "HH:MM?,
-        # where HH : [00-23] and MM : [00-59] GMT.
+        # Time within the window to start the operations. It must be in format "HH:MM",
+        # where HH : [00-23] and MM : [00-00] GMT.
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
@@ -21841,11 +22396,12 @@ module Google
         # @return [String]
         attr_accessor :ip_address
       
-        # [Output Only] Type of how the resource/configuration of the BGP peer is
-        # managed. MANAGED_BY_USER is the default value; MANAGED_BY_ATTACHMENT
-        # represents an BGP peer that is automatically created for PARTNER
-        # interconnectAttachment, Google will automatically create/delete this type of
-        # BGP peer when the PARTNER interconnectAttachment is created/deleted.
+        # [Output Only] The resource that configures and manages this BGP peer.
+        # MANAGED_BY_USER is the default value and can be managed by you or other users;
+        # MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed by Cloud
+        # Interconnect, specifically by an InterconnectAttachment of type PARTNER.
+        # Google will automatically create, update, and delete this type of BGP peer
+        # when the PARTNER InterconnectAttachment is created, updated, or deleted.
         # Corresponds to the JSON property `managementType`
         # @return [String]
         attr_accessor :management_type
@@ -21912,12 +22468,12 @@ module Google
         # @return [String]
         attr_accessor :linked_vpn_tunnel
       
-        # [Output Only] Type of how the resource/configuration of the interface is
-        # managed. MANAGED_BY_USER is the default value; MANAGED_BY_ATTACHMENT
-        # represents an interface that is automatically created for PARTNER type
-        # interconnectAttachment, Google will automatically create/update/delete this
-        # type of interface when the PARTNER interconnectAttachment is created/
-        # provisioned/deleted.
+        # [Output Only] The resource that configures and manages this interface.
+        # MANAGED_BY_USER is the default value and can be managed by you or other users;
+        # MANAGED_BY_ATTACHMENT is an interface that is configured and managed by Cloud
+        # Interconnect, specifically by an InterconnectAttachment of type PARTNER.
+        # Google will automatically create, update, and delete this type of interface
+        # when the PARTNER InterconnectAttachment is created, updated, or deleted.
         # Corresponds to the JSON property `managementType`
         # @return [String]
         attr_accessor :management_type
@@ -22072,6 +22628,11 @@ module Google
         # @return [Fixnum]
         attr_accessor :icmp_idle_timeout_sec
       
+        # Configuration of logging on a NAT.
+        # Corresponds to the JSON property `logConfig`
+        # @return [Google::Apis::ComputeAlpha::RouterNatLogConfig]
+        attr_accessor :log_config
+      
         # Minimum number of ports allocated to a VM from this NAT config. If not set, a
         # default number of ports is allocated to a VM. This gets rounded up to the
         # nearest power of 2. Eg. if the value of this field is 50, at least 64 ports
@@ -22137,6 +22698,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @icmp_idle_timeout_sec = args[:icmp_idle_timeout_sec] if args.key?(:icmp_idle_timeout_sec)
+          @log_config = args[:log_config] if args.key?(:log_config)
           @min_ports_per_vm = args[:min_ports_per_vm] if args.key?(:min_ports_per_vm)
           @name = args[:name] if args.key?(:name)
           @nat_ip_allocate_option = args[:nat_ip_allocate_option] if args.key?(:nat_ip_allocate_option)
@@ -22149,6 +22711,33 @@ module Google
         end
       end
       
+      # Configuration of logging on a NAT.
+      class RouterNatLogConfig
+        include Google::Apis::Core::Hashable
+      
+        # Indicates whether or not to export logs. This is false by default.
+        # Corresponds to the JSON property `enabled`
+        # @return [Boolean]
+        attr_accessor :enabled
+        alias_method :enabled?, :enabled
+      
+        # Specifies the desired filtering of logs on this NAT. If unspecified, logs are
+        # exported for all connections handled by this NAT.
+        # Corresponds to the JSON property `filter`
+        # @return [String]
+        attr_accessor :filter
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @enabled = args[:enabled] if args.key?(:enabled)
+          @filter = args[:filter] if args.key?(:filter)
+        end
+      end
+      
       # Defines the IP ranges that want to use NAT for a subnetwork.
       class RouterNatSubnetworkToNat
         include Google::Apis::Core::Hashable
@@ -22790,6 +23379,12 @@ module Google
         attr_accessor :automatic_restart
         alias_method :automatic_restart?, :automatic_restart
       
+        # The minimum number of virtual CPUs this instance will consume when running on
+        # a sole-tenant node.
+        # Corresponds to the JSON property `minNodeCpus`
+        # @return [Float]
+        attr_accessor :min_node_cpus
+      
         # A set of node affinity and anti-affinity.
         # Corresponds to the JSON property `nodeAffinities`
         # @return [Array<Google::Apis::ComputeAlpha::SchedulingNodeAffinity>]
@@ -22818,6 +23413,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @automatic_restart = args[:automatic_restart] if args.key?(:automatic_restart)
+          @min_node_cpus = args[:min_node_cpus] if args.key?(:min_node_cpus)
           @node_affinities = args[:node_affinities] if args.key?(:node_affinities)
           @on_host_maintenance = args[:on_host_maintenance] if args.key?(:on_host_maintenance)
           @preemptible = args[:preemptible] if args.key?(:preemptible)
@@ -22900,6 +23496,11 @@ module Google
       class SecurityPolicy
         include Google::Apis::Core::Hashable
       
+        # A list of assocations that belong to this policy.
+        # Corresponds to the JSON property `associations`
+        # @return [Array<Google::Apis::ComputeAlpha::SecurityPolicyAssociation>]
+        attr_accessor :associations
+      
         # [Output Only] Creation timestamp in RFC3339 text format.
         # Corresponds to the JSON property `creationTimestamp`
         # @return [String]
@@ -22915,7 +23516,8 @@ module Google
         # metadata's contents and used for optimistic locking. The fingerprint is
         # initially generated by Compute Engine and changes after every request to
         # modify or update metadata. You must always provide an up-to-date fingerprint
-        # hash in order to update or change metadata.
+        # hash in order to update or change metadata, otherwise the request will fail
+        # with error 412 conditionNotMet.
         # To see the latest fingerprint, make get() request to the security policy.
         # Corresponds to the JSON property `fingerprint`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
@@ -22975,12 +23577,19 @@ module Google
         # @return [String]
         attr_accessor :self_link
       
+        # The type indicates the intended use of the security policy. CLOUD_ARMOR
+        # policies apply to backend services. FIREWALL policies apply to organizations.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
         def initialize(**args)
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
+          @associations = args[:associations] if args.key?(:associations)
           @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp)
           @description = args[:description] if args.key?(:description)
           @fingerprint = args[:fingerprint] if args.key?(:fingerprint)
@@ -22991,6 +23600,32 @@ module Google
           @name = args[:name] if args.key?(:name)
           @rules = args[:rules] if args.key?(:rules)
           @self_link = args[:self_link] if args.key?(:self_link)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
+      # 
+      class SecurityPolicyAssociation
+        include Google::Apis::Core::Hashable
+      
+        # The resource that the security policy is attached to.
+        # Corresponds to the JSON property `attachmentId`
+        # @return [String]
+        attr_accessor :attachment_id
+      
+        # The name for an association.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @attachment_id = args[:attachment_id] if args.key?(:attachment_id)
+          @name = args[:name] if args.key?(:name)
         end
       end
       
@@ -23143,6 +23778,22 @@ module Google
         # @return [String]
         attr_accessor :description
       
+        # The direction in which this rule applies. This field may only be specified
+        # when versioned_expr is set to FIREWALL.
+        # Corresponds to the JSON property `direction`
+        # @return [String]
+        attr_accessor :direction
+      
+        # Denotes whether to enable logging for a particular rule. If logging is enabled,
+        # logs will be exported to the configured export destination in Stackdriver.
+        # Logs may be exported to BigQuery or Pub/Sub. Note: you cannot enable logging
+        # on "goto_next" rules.
+        # This field may only be specified when the versioned_expr is set to FIREWALL.
+        # Corresponds to the JSON property `enableLogging`
+        # @return [Boolean]
+        attr_accessor :enable_logging
+        alias_method :enable_logging?, :enable_logging
+      
         # [Output only] Type of the resource. Always compute#securityPolicyRule for
         # security policy rules
         # Corresponds to the JSON property `kind`
@@ -23162,12 +23813,21 @@ module Google
         alias_method :preview?, :preview
       
         # An integer indicating the priority of a rule in the list. The priority must be
-        # a positive value between 0 and 2147483647. Rules are evaluated in the
-        # increasing order of priority.
+        # a positive value between 0 and 2147483647. Rules are evaluated from highest to
+        # lowest priority where 0 is the highest priority and 2147483647 is the lowest
+        # prority.
         # Corresponds to the JSON property `priority`
         # @return [Fixnum]
         attr_accessor :priority
       
+        # A list of network resource URLs to which this rule applies. This field allows
+        # you to control which network?s VMs get this rule. If this field is left blank,
+        # all VMs within the organization will receive the rule.
+        # This field may only be specified when versioned_expr is set to FIREWALL.
+        # Corresponds to the JSON property `targetResources`
+        # @return [Array<String>]
+        attr_accessor :target_resources
+      
         def initialize(**args)
            update!(**args)
         end
@@ -23176,10 +23836,13 @@ module Google
         def update!(**args)
           @action = args[:action] if args.key?(:action)
           @description = args[:description] if args.key?(:description)
+          @direction = args[:direction] if args.key?(:direction)
+          @enable_logging = args[:enable_logging] if args.key?(:enable_logging)
           @kind = args[:kind] if args.key?(:kind)
           @match = args[:match] if args.key?(:match)
           @preview = args[:preview] if args.key?(:preview)
           @priority = args[:priority] if args.key?(:priority)
+          @target_resources = args[:target_resources] if args.key?(:target_resources)
         end
       end
       
@@ -23202,11 +23865,6 @@ module Google
         # @return [Google::Apis::ComputeAlpha::Expr]
         attr_accessor :expr
       
-        # CIDR IP address range.
-        # Corresponds to the JSON property `srcIpRanges`
-        # @return [Array<String>]
-        attr_accessor :src_ip_ranges
-      
         # Preconfigured versioned expression. If this field is specified, config must
         # also be specified. Available preconfigured expressions along with their
         # requirements are: SRC_IPS_V1 - must specify the corresponding src_ip_range
@@ -23223,7 +23881,6 @@ module Google
         def update!(**args)
           @config = args[:config] if args.key?(:config)
           @expr = args[:expr] if args.key?(:expr)
-          @src_ip_ranges = args[:src_ip_ranges] if args.key?(:src_ip_ranges)
           @versioned_expr = args[:versioned_expr] if args.key?(:versioned_expr)
         end
       end
@@ -23232,6 +23889,18 @@ module Google
       class SecurityPolicyRuleMatcherConfig
         include Google::Apis::Core::Hashable
       
+        # CIDR IP address range.
+        # This field may only be specified when versioned_expr is set to FIREWALL.
+        # Corresponds to the JSON property `destIpRanges`
+        # @return [Array<String>]
+        attr_accessor :dest_ip_ranges
+      
+        # Pairs of IP protocols and ports that the rule should match.
+        # This field may only be specified when versioned_expr is set to FIREWALL.
+        # Corresponds to the JSON property `destPorts`
+        # @return [Array<Google::Apis::ComputeAlpha::SecurityPolicyRuleMatcherConfigDestinationPort>]
+        attr_accessor :dest_ports
+      
         # CIDR IP address range.
         # Corresponds to the JSON property `srcIpRanges`
         # @return [Array<String>]
@@ -23243,10 +23912,44 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @dest_ip_ranges = args[:dest_ip_ranges] if args.key?(:dest_ip_ranges)
+          @dest_ports = args[:dest_ports] if args.key?(:dest_ports)
           @src_ip_ranges = args[:src_ip_ranges] if args.key?(:src_ip_ranges)
         end
       end
       
+      # 
+      class SecurityPolicyRuleMatcherConfigDestinationPort
+        include Google::Apis::Core::Hashable
+      
+        # The IP protocol to which this rule applies. The protocol type is required when
+        # creating a firewall rule. This value can either be one of the following well
+        # known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp), or the IP
+        # protocol number.
+        # Corresponds to the JSON property `ipProtocol`
+        # @return [String]
+        attr_accessor :ip_protocol
+      
+        # An optional list of ports to which this rule applies. This field is only
+        # applicable for UDP or TCP protocol. Each entry must be either an integer or a
+        # range. If not specified, this rule applies to connections through any port.
+        # Example inputs include: ["22"], ["80","443"], and ["12345-12349"].
+        # This field may only be specified when versioned_expr is set to FIREWALL.
+        # Corresponds to the JSON property `ports`
+        # @return [Array<String>]
+        attr_accessor :ports
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @ip_protocol = args[:ip_protocol] if args.key?(:ip_protocol)
+          @ports = args[:ports] if args.key?(:ports)
+        end
+      end
+      
       # An instance's serial console output.
       class SerialPortOutput
         include Google::Apis::Core::Hashable
@@ -23409,12 +24112,12 @@ module Google
       class ShieldedVmIdentityEntry
         include Google::Apis::Core::Hashable
       
-        # 
+        # A PEM-encoded X.509 certificate. This field can be empty.
         # Corresponds to the JSON property `ekCert`
         # @return [String]
         attr_accessor :ek_cert
       
-        # 
+        # A PEM-encoded public key.
         # Corresponds to the JSON property `ekPub`
         # @return [String]
         attr_accessor :ek_pub
@@ -23488,7 +24191,7 @@ module Google
       class Snapshot
         include Google::Apis::Core::Hashable
       
-        # [Output Only] Set to true if snapshots are autoamtically by applying resource
+        # [Output Only] Set to true if snapshots are automatically by applying resource
         # policy on the target disk.
         # Corresponds to the JSON property `autoCreated`
         # @return [Boolean]
@@ -23534,7 +24237,8 @@ module Google
         # essentially a hash of the labels set used for optimistic locking. The
         # fingerprint is initially generated by Compute Engine and changes after every
         # request to modify or update labels. You must always provide an up-to-date
-        # fingerprint hash in order to update or change labels.
+        # fingerprint hash in order to update or change labels, otherwise the request
+        # will fail with error 412 conditionNotMet.
         # To see the latest fingerprint, make a get() request to retrieve a snapshot.
         # Corresponds to the JSON property `labelFingerprint`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
@@ -24573,7 +25277,8 @@ module Google
         # 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 SslPolicy. An up-to-date fingerprint must be provided in order to
-        # update the SslPolicy.
+        # update the SslPolicy, otherwise the request will fail with error 412
+        # conditionNotMet.
         # To see the latest fingerprint, make a get() request to retrieve an SslPolicy.
         # Corresponds to the JSON property `fingerprint`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
@@ -24741,6 +25446,11 @@ module Google
         # @return [Google::Apis::ComputeAlpha::StatefulPolicyPreservedResources]
         attr_accessor :preserved_resources
       
+        # Configuration of preserved resources.
+        # Corresponds to the JSON property `preservedState`
+        # @return [Google::Apis::ComputeAlpha::StatefulPolicyPreservedState]
+        attr_accessor :preserved_state
+      
         def initialize(**args)
            update!(**args)
         end
@@ -24748,6 +25458,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @preserved_resources = args[:preserved_resources] if args.key?(:preserved_resources)
+          @preserved_state = args[:preserved_state] if args.key?(:preserved_state)
         end
       end
       
@@ -24790,6 +25501,49 @@ module Google
         end
       end
       
+      # Configuration of preserved resources.
+      class StatefulPolicyPreservedState
+        include Google::Apis::Core::Hashable
+      
+        # Disks created on the instances that will be preserved on instance delete,
+        # resize down, etc. This map is keyed with the device names of the disks.
+        # Corresponds to the JSON property `disks`
+        # @return [Hash<String,Google::Apis::ComputeAlpha::StatefulPolicyPreservedStateDiskDevice>]
+        attr_accessor :disks
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @disks = args[:disks] if args.key?(:disks)
+        end
+      end
+      
+      # 
+      class StatefulPolicyPreservedStateDiskDevice
+        include Google::Apis::Core::Hashable
+      
+        # These stateful disks will never be deleted during autohealing, update or VM
+        # instance recreate operations. This flag is used to configure if the disk
+        # should be deleted after it is no longer used by the group, e.g. when the given
+        # instance or the whole group is deleted. Note: disks attached in READ_ONLY mode
+        # cannot be auto-deleted.
+        # Corresponds to the JSON property `autoDelete`
+        # @return [String]
+        attr_accessor :auto_delete
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @auto_delete = args[:auto_delete] if args.key?(:auto_delete)
+        end
+      end
+      
       # A Subnetwork resource. (== resource_for beta.subnetworks ==) (== resource_for
       # v1.subnetworks ==)
       class Subnetwork
@@ -24849,7 +25603,8 @@ module Google
         # 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 Subnetwork. An up-to-date fingerprint must be provided in order to
-        # update the Subnetwork.
+        # update the Subnetwork, otherwise the request will fail with error 412
+        # conditionNotMet.
         # To see the latest fingerprint, make a get() request to retrieve a Subnetwork.
         # Corresponds to the JSON property `fingerprint`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
@@ -24897,6 +25652,11 @@ module Google
         # @return [String]
         attr_accessor :kind
       
+        # The available logging options for this subnetwork.
+        # Corresponds to the JSON property `logConfig`
+        # @return [Google::Apis::ComputeAlpha::SubnetworkLogConfig]
+        attr_accessor :log_config
+      
         # Can only be specified if VPC flow logging for this subnetwork is enabled.
         # Configures whether metadata fields should be added to the reported VPC flow
         # logs. Default is INCLUDE_ALL_METADATA.
@@ -24949,7 +25709,8 @@ module Google
         # INTERNAL_HTTPS_LOAD_BALANCER. The value can be set to ACTIVE or BACKUP. An
         # ACTIVE subnetwork is one that is currently being used for Internal HTTP(S)
         # Load Balancing. A BACKUP subnetwork is one that is ready to be promoted to
-        # ACTIVE or is currently draining.
+        # ACTIVE or is currently draining. This field can be updated with a patch
+        # request.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -24957,7 +25718,7 @@ module Google
         # An array of configurations for secondary IP ranges for VM instances contained
         # in this subnetwork. The primary IP of such VM must belong to the primary
         # ipCidrRange of the subnetwork. The alias IPs may belong to either primary or
-        # secondary ranges.
+        # secondary ranges. This field can be updated with a patch request.
         # Corresponds to the JSON property `secondaryIpRanges`
         # @return [Array<Google::Apis::ComputeAlpha::SubnetworkSecondaryRange>]
         attr_accessor :secondary_ip_ranges
@@ -24996,6 +25757,7 @@ module Google
           @ip_cidr_range = args[:ip_cidr_range] if args.key?(:ip_cidr_range)
           @ipv6_cidr_range = args[:ipv6_cidr_range] if args.key?(:ipv6_cidr_range)
           @kind = args[:kind] if args.key?(:kind)
+          @log_config = args[:log_config] if args.key?(:log_config)
           @metadata = args[:metadata] if args.key?(:metadata)
           @name = args[:name] if args.key?(:name)
           @network = args[:network] if args.key?(:network)
@@ -25245,6 +26007,55 @@ module Google
         end
       end
       
+      # The available logging options for this subnetwork.
+      class SubnetworkLogConfig
+        include Google::Apis::Core::Hashable
+      
+        # Can only be specified if VPC flow logging for this subnetwork is enabled.
+        # Toggles the aggregation interval for collecting flow logs. Increasing the
+        # interval time will reduce the amount of generated flow logs for long lasting
+        # connections. Default is an interval of 5 seconds per connection.
+        # Corresponds to the JSON property `aggregationInterval`
+        # @return [String]
+        attr_accessor :aggregation_interval
+      
+        # Whether to enable flow logging for this subnetwork. If this field is not
+        # explicitly set, it will not appear in get listings. If not set the default
+        # behavior is to disable flow logging.
+        # Corresponds to the JSON property `enable`
+        # @return [Boolean]
+        attr_accessor :enable
+        alias_method :enable?, :enable
+      
+        # Can only be specified if VPC flow logging for this subnetwork is enabled. The
+        # value of the field must be in [0, 1]. Set the sampling rate of VPC flow logs
+        # within the subnetwork where 1.0 means all collected logs are reported and 0.0
+        # means no logs are reported. Default is 0.5 which means half of all collected
+        # logs are reported.
+        # Corresponds to the JSON property `flowSampling`
+        # @return [Float]
+        attr_accessor :flow_sampling
+      
+        # Can only be specified if VPC flow logging for this subnetwork is enabled.
+        # Configures whether metadata fields should be added to the reported VPC flow
+        # logs. Default is INCLUDE_ALL_METADATA.
+        # Corresponds to the JSON property `metadata`
+        # @return [String]
+        attr_accessor :metadata
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @aggregation_interval = args[:aggregation_interval] if args.key?(:aggregation_interval)
+          @enable = args[:enable] if args.key?(:enable)
+          @flow_sampling = args[:flow_sampling] if args.key?(:flow_sampling)
+          @metadata = args[:metadata] if args.key?(:metadata)
+        end
+      end
+      
       # Represents a secondary IP range of a subnetwork.
       class SubnetworkSecondaryRange
         include Google::Apis::Core::Hashable
@@ -26102,8 +26913,8 @@ module Google
         attr_accessor :self_link
       
         # URLs to SslCertificate resources that are used to authenticate connections
-        # between users and the load balancer. Currently, exactly one SSL certificate
-        # must be specified.
+        # between users and the load balancer. At least one SSL certificate must be
+        # specified. Currently, you may specify up to 15 SSL certificates.
         # Corresponds to the JSON property `sslCertificates`
         # @return [Array<String>]
         attr_accessor :ssl_certificates
@@ -26886,7 +27697,7 @@ module Google
         # @return [String]
         attr_accessor :self_link
       
-        # Sesssion affinity option, must be one of the following values:
+        # Session affinity option, must be one of the following values:
         # NONE: Connections from the same client IP may go to any instance in the pool.
         # CLIENT_IP: Connections from the same client IP will go to the same instance in
         # the pool while that instance remains healthy.
@@ -27489,7 +28300,8 @@ module Google
         attr_accessor :service
       
         # URLs to SslCertificate resources that are used to authenticate connections to
-        # Backends. Currently exactly one SSL certificate must be specified.
+        # Backends. At least one SSL certificate must be specified. Currently, you may
+        # specify up to 15 SSL certificates.
         # Corresponds to the JSON property `sslCertificates`
         # @return [Array<String>]
         attr_accessor :ssl_certificates
@@ -27903,7 +28715,8 @@ module Google
         # essentially a hash of the labels set used for optimistic locking. The
         # fingerprint is initially generated by Compute Engine and changes after every
         # request to modify or update labels. You must always provide an up-to-date
-        # fingerprint hash in order to update or change labels.
+        # fingerprint hash in order to update or change labels, otherwise the request
+        # will fail with error 412 conditionNotMet.
         # To see the latest fingerprint, make a get() request to retrieve a
         # TargetVpnGateway.
         # Corresponds to the JSON property `labelFingerprint`
@@ -28434,7 +29247,12 @@ module Google
         # @return [String]
         attr_accessor :creation_timestamp
       
-        # The URL of the BackendService resource if none of the hostRules match.
+        # The URL of the backendService resource if none of the hostRules match.
+        # Use defaultService instead of defaultRouteAction when simple routing to a
+        # backendService is desired and other advanced capabilities like traffic
+        # splitting and rewrites are not required.
+        # Only one of defaultService, defaultRouteAction or defaultUrlRedirect should
+        # must be set.
         # Corresponds to the JSON property `defaultService`
         # @return [String]
         attr_accessor :default_service
@@ -28448,7 +29266,8 @@ module Google
         # 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 UrlMap. An up-to-date fingerprint must be provided in order to
-        # update the UrlMap.
+        # update the UrlMap, otherwise the request will fail with error 412
+        # conditionNotMet.
         # To see the latest fingerprint, make a get() request to retrieve a UrlMap.
         # Corresponds to the JSON property `fingerprint`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
@@ -29420,7 +30239,8 @@ module Google
         # essentially a hash of the labels set used for optimistic locking. The
         # fingerprint is initially generated by Compute Engine and changes after every
         # request to modify or update labels. You must always provide an up-to-date
-        # fingerprint hash in order to update or change labels.
+        # fingerprint hash in order to update or change labels, otherwise the request
+        # will fail with error 412 conditionNotMet.
         # To see the latest fingerprint, make a get() request to retrieve an VpnGateway.
         # Corresponds to the JSON property `labelFingerprint`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
@@ -29877,7 +30697,8 @@ module Google
         # essentially a hash of the labels set used for optimistic locking. The
         # fingerprint is initially generated by Compute Engine and changes after every
         # request to modify or update labels. You must always provide an up-to-date
-        # fingerprint hash in order to update or change labels.
+        # fingerprint hash in order to update or change labels, otherwise the request
+        # will fail with error 412 conditionNotMet.
         # To see the latest fingerprint, make a get() request to retrieve a VpnTunnel.
         # Corresponds to the JSON property `labelFingerprint`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.