google-api-client 0.9.1 → 0.9.2

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

@@ -390,6 +390,10 @@ module Google
         end
       end
       
+      class InstancesSetMachineTypeRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
       class License
         class Representation < Google::Apis::Core::JsonRepresentation; end
       end
@@ -574,6 +578,30 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation; end
       end
       
+      class Subnetwork
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class SubnetworkAggregatedList
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class SubnetworkList
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class SubnetworksScopedList
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+        
+        class Warning
+          class Representation < Google::Apis::Core::JsonRepresentation; end
+          
+          class Datum
+            class Representation < Google::Apis::Core::JsonRepresentation; end
+          end
+        end
+      end
+      
       class Tags
         class Representation < Google::Apis::Core::JsonRepresentation; end
       end
@@ -1492,6 +1520,7 @@ module Google
           property :network, as: 'network'
           property :self_link, as: 'selfLink'
           property :size, as: 'size'
+          property :subnetwork, as: 'subnetwork'
           property :zone, as: 'zone'
         end
       end
@@ -1836,6 +1865,13 @@ module Google
         end
       end
       
+      class InstancesSetMachineTypeRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :machine_type, as: 'machineType'
+        end
+      end
+      
       class License
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1994,6 +2030,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :i_pv4_range, as: 'IPv4Range'
+          property :auto_create_subnetworks, as: 'autoCreateSubnetworks'
           property :creation_timestamp, as: 'creationTimestamp'
           property :description, as: 'description'
           property :gateway_i_pv4, as: 'gatewayIPv4'
@@ -2001,6 +2038,7 @@ module Google
           property :kind, as: 'kind'
           property :name, as: 'name'
           property :self_link, as: 'selfLink'
+          collection :subnetworks, as: 'subnetworks'
         end
       end
       
@@ -2012,6 +2050,7 @@ module Google
           property :name, as: 'name'
           property :network, as: 'network'
           property :network_ip, as: 'networkIP'
+          property :subnetwork, as: 'subnetwork'
         end
       end
       
@@ -2365,6 +2404,74 @@ module Google
         end
       end
       
+      class Subnetwork
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :creation_timestamp, as: 'creationTimestamp'
+          property :description, as: 'description'
+          property :gateway_address, as: 'gatewayAddress'
+          property :id, as: 'id'
+          property :ip_cidr_range, as: 'ipCidrRange'
+          property :kind, as: 'kind'
+          property :name, as: 'name'
+          property :network, as: 'network'
+          property :region, as: 'region'
+          property :self_link, as: 'selfLink'
+        end
+      end
+      
+      class SubnetworkAggregatedList
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :id, as: 'id'
+          hash :items, as: 'items', class: Google::Apis::ComputeV1::SubnetworksScopedList, decorator: Google::Apis::ComputeV1::SubnetworksScopedList::Representation
+      
+          property :kind, as: 'kind'
+          property :next_page_token, as: 'nextPageToken'
+          property :self_link, as: 'selfLink'
+        end
+      end
+      
+      class SubnetworkList
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :id, as: 'id'
+          collection :items, as: 'items', class: Google::Apis::ComputeV1::Subnetwork, decorator: Google::Apis::ComputeV1::Subnetwork::Representation
+      
+          property :kind, as: 'kind'
+          property :next_page_token, as: 'nextPageToken'
+          property :self_link, as: 'selfLink'
+        end
+      end
+      
+      class SubnetworksScopedList
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :subnetworks, as: 'subnetworks', class: Google::Apis::ComputeV1::Subnetwork, decorator: Google::Apis::ComputeV1::Subnetwork::Representation
+      
+          property :warning, as: 'warning', class: Google::Apis::ComputeV1::SubnetworksScopedList::Warning, decorator: Google::Apis::ComputeV1::SubnetworksScopedList::Warning::Representation
+      
+        end
+        
+        class Warning
+          # @private
+          class Representation < Google::Apis::Core::JsonRepresentation
+            property :code, as: 'code'
+            collection :data, as: 'data', class: Google::Apis::ComputeV1::SubnetworksScopedList::Warning::Datum, decorator: Google::Apis::ComputeV1::SubnetworksScopedList::Warning::Datum::Representation
+        
+            property :message, as: 'message'
+          end
+          
+          class Datum
+            # @private
+            class Representation < Google::Apis::Core::JsonRepresentation
+              property :key, as: 'key'
+              property :value, as: 'value'
+            end
+          end
+        end
+      end
+      
       class Tags
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2788,6 +2895,7 @@ module Google
           property :id, as: 'id'
           property :ike_version, as: 'ikeVersion'
           property :kind, as: 'kind'
+          collection :local_traffic_selector, as: 'localTrafficSelector'
           property :name, as: 'name'
           property :peer_ip, as: 'peerIp'
           property :region, as: 'region'

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

@@ -66,7 +66,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -78,10 +79,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -244,7 +245,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves a list of address resources contained within the specified region.
+        # Retrieves a list of addresses contained within the specified region.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
@@ -260,7 +261,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -272,10 +274,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -329,7 +331,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -341,10 +344,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -523,7 +526,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -535,10 +539,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -840,7 +844,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -852,10 +857,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -981,7 +986,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves an aggregated list of disk type resources.
+        # Retrieves an aggregated list of disk types.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -995,7 +1000,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -1007,10 +1013,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -1049,13 +1055,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the specified disk type resource.
+        # Returns the specified disk type.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
         #   The name of the zone for this request.
         # @param [String] disk_type
-        #   Name of the disk type resource to return.
+        #   Name of the disk type to return.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1090,7 +1096,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves a list of disk type resources available to the specified project.
+        # Retrieves a list of disk types available to the specified project.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
@@ -1106,7 +1112,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -1118,10 +1125,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -1175,7 +1182,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -1187,10 +1195,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -1357,8 +1365,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a persistent disk in the specified project using the data included in
-        # the request.
+        # Creates a persistent disk in the specified project using the data in the
+        # request. You can create a disk with a sourceImage, a sourceSnapshot, or create
+        # an empty 200 GB data disk by omitting all properties. You can also create a
+        # disk that is larger than the default size by specifying the sizeGb property.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
@@ -1418,7 +1428,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -1430,10 +1441,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -1473,11 +1484,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified firewall resource.
+        # Deletes the specified firewall.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] firewall
-        #   Name of the firewall resource to delete.
+        #   Name of the firewall rule to delete.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1511,11 +1522,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the specified firewall resource.
+        # Returns the specified firewall.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] firewall
-        #   Name of the firewall resource to return.
+        #   Name of the firewall rule to return.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1549,8 +1560,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a firewall resource in the specified project using the data included
-        # in the request.
+        # Creates a firewall rule in the specified project using the data included in
+        # the request.
         # @param [String] project
         #   Project ID for this request.
         # @param [Google::Apis::ComputeV1::Firewall] firewall_object
@@ -1588,7 +1599,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of firewall resources available to the specified project.
+        # Retrieves the list of firewall rules available to the specified project.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -1602,7 +1613,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -1614,10 +1626,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -1656,12 +1668,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the specified firewall resource with the data included in the request.
+        # Updates the specified firewall rule with the data included in the request.
         # This method supports patch semantics.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] firewall
-        #   Name of the firewall resource to update.
+        #   Name of the firewall rule to update.
         # @param [Google::Apis::ComputeV1::Firewall] firewall_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1698,11 +1710,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the specified firewall resource with the data included in the request.
+        # Updates the specified firewall rule with the data included in the request.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] firewall
-        #   Name of the firewall resource to update.
+        #   Name of the firewall rule to update.
         # @param [Google::Apis::ComputeV1::Firewall] firewall_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1753,7 +1765,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -1765,10 +1778,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -1948,7 +1961,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -1960,10 +1974,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -2163,7 +2177,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves a list of global address resources.
+        # Retrieves a list of global addresses.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -2177,7 +2191,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -2189,10 +2204,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -2361,7 +2376,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -2373,10 +2389,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -2471,7 +2487,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -2483,10 +2500,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -2613,7 +2630,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -2625,10 +2643,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -2797,7 +2815,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -2809,10 +2828,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -3065,7 +3084,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -3077,10 +3097,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -3203,7 +3223,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified image resource.
+        # Deletes the specified image.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] image
@@ -3283,7 +3303,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the specified image resource.
+        # Returns the specified image.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] image
@@ -3321,8 +3341,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates an image resource in the specified project using the data included in
-        # the request.
+        # Creates an image in the specified project using the data included in the
+        # request.
         # @param [String] project
         #   Project ID for this request.
         # @param [Google::Apis::ComputeV1::Image] image_object
@@ -3380,7 +3400,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -3392,10 +3413,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -3499,7 +3520,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -3511,10 +3533,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -3750,7 +3772,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -3762,10 +3785,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -4045,7 +4068,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Adds a list of instances to the specified instance group. Read  Adding
+        # Adds a list of instances to the specified instance group. All of the instances
+        # in the instance group must be in the same network/subnetwork. Read  Adding
         # instances for more information.
         # @param [String] project
         #   Project ID for this request.
@@ -4104,7 +4128,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -4116,10 +4141,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -4301,7 +4326,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -4313,10 +4339,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -4376,7 +4402,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -4388,10 +4415,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -4523,7 +4550,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified instance template.
+        # Deletes the specified instance template. If you delete an instance template
+        # that is being referenced from another instance group, the instance group will
+        # not be able to create or recreate virtual machine instances. Deleting an
+        # instance template is permanent and cannot be undone.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] instance_template
@@ -4655,7 +4685,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -4667,10 +4698,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -4756,7 +4787,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves aggregated list of instance resources.
+        # Retrieves aggregated list of instances.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -4770,7 +4801,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -4782,10 +4814,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -4830,7 +4862,7 @@ module Google
         # @param [String] zone
         #   The name of the zone for this request.
         # @param [String] instance
-        #   Instance name.
+        #   The instance name for this request.
         # @param [Google::Apis::ComputeV1::AttachedDisk] attached_disk_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -5001,7 +5033,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the specified instance resource.
+        # Returns the specified Instance resource.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
@@ -5128,7 +5160,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of instance resources contained within the specified zone.
+        # Retrieves the list of instances contained within the specified zone.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
@@ -5144,7 +5176,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -5156,10 +5189,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -5287,6 +5320,51 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Changes the machine type for a stopped instance to the machine type specified
+        # in the request.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] zone
+        #   The name of the zone for this request.
+        # @param [String] instance
+        #   Name of the instance scoping this request.
+        # @param [Google::Apis::ComputeV1::InstancesSetMachineTypeRequest] instances_set_machine_type_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.
+        #   Overrides userIp if both are provided.
+        # @param [String] user_ip
+        #   IP address of the site where the request originates. Use this if you want to
+        #   enforce per-user limits.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeV1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def set_instance_machine_type(project, zone, instance, instances_set_machine_type_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:post, '{project}/zones/{zone}/instances/{instance}/setMachineType', options)
+          command.request_representation = Google::Apis::ComputeV1::InstancesSetMachineTypeRequest::Representation
+          command.request_object = instances_set_machine_type_request_object
+          command.response_representation = Google::Apis::ComputeV1::Operation::Representation
+          command.response_class = Google::Apis::ComputeV1::Operation
+          command.params['project'] = project unless project.nil?
+          command.params['zone'] = zone unless zone.nil?
+          command.params['instance'] = instance unless instance.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Sets metadata for the specified instance to the data included in the request.
         # @param [String] project
         #   Project ID for this request.
@@ -5511,7 +5589,7 @@ module Google
         # @param [String] project
         #   Project ID for this request.
         # @param [String] license
-        #   Name of the license resource to return.
+        #   Name of the License resource to return.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -5545,7 +5623,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves an aggregated list of machine type resources.
+        # Retrieves an aggregated list of machine types.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -5559,7 +5637,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -5571,10 +5650,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -5613,13 +5692,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the specified machine type resource.
+        # Returns the specified machine type.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
         #   The name of the zone for this request.
         # @param [String] machine_type
-        #   Name of the machine type resource to return.
+        #   Name of the machine type to return.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -5654,7 +5733,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves a list of machine type resources available to the specified project.
+        # Retrieves a list of machine types available to the specified project.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
@@ -5670,7 +5749,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -5682,10 +5762,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -5725,11 +5805,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified network resource.
+        # Deletes the specified network.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] network
-        #   Name of the network resource to delete.
+        #   Name of the network to delete.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -5763,11 +5843,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the specified network resource.
+        # Returns the specified network.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] network
-        #   Name of the network resource to return.
+        #   Name of the network to return.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -5801,8 +5881,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a network resource in the specified project using the data included in
-        # the request.
+        # Creates a network in the specified project using the data included in the
+        # request.
         # @param [String] project
         #   Project ID for this request.
         # @param [Google::Apis::ComputeV1::Network] network_object
@@ -5840,7 +5920,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of network resources available to the specified project.
+        # Retrieves the list of networks available to the specified project.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -5854,7 +5934,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -5866,10 +5947,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -6102,7 +6183,7 @@ module Google
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
-        #   Name of the region scoping this request.
+        #   Name of the region for this request.
         # @param [String] operation
         #   Name of the Operations resource to delete.
         # @param [String] fields
@@ -6141,7 +6222,7 @@ module Google
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
-        #   Name of the region scoping this request.
+        #   Name of the region for this request.
         # @param [String] operation
         #   Name of the Operations resource to return.
         # @param [String] fields
@@ -6182,7 +6263,7 @@ module Google
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
-        #   Name of the region scoping this request.
+        #   Name of the region for this request.
         # @param [String] filter
         #   Sets a filter expression for filtering listed resources, in the form filter=`
         #   expression`. Your `expression` must be in the format: field_name
@@ -6194,7 +6275,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -6206,10 +6288,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -6301,7 +6383,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -6313,10 +6396,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -6484,7 +6567,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -6496,10 +6580,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -6633,7 +6717,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -6645,10 +6730,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -6817,7 +6902,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -6829,10 +6915,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -6871,6 +6957,271 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Retrieves an aggregated list of subnetworks.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] filter
+        #   Sets a filter expression for filtering listed resources, in the form filter=`
+        #   expression`. Your `expression` must be in the format: field_name
+        #   comparison_string literal_string.
+        #   The field_name is the name of the field you want to compare. Only atomic field
+        #   types are supported (string, number, boolean). The comparison_string must be
+        #   either eq (equals) or ne (not equals). The literal_string is the string value
+        #   to filter to. The literal value must be valid for the type of field you are
+        #   filtering by (string, number, boolean). For string fields, the literal value
+        #   is interpreted as a regular expression using RE2 syntax. The literal value
+        #   must match the entire field.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
+        #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
+        #   also filter on nested fields. For example, you could filter on instances that
+        #   have set the scheduling.automaticRestart field to true. In particular, use
+        #   filtering on nested fields to take advantage of instance labels to organize
+        #   and filter results based on label values.
+        #   The Beta API also supports filtering on multiple expressions by providing each
+        #   separate expression within parentheses. For example, (scheduling.
+        #   automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are
+        #   treated as AND expressions meaning that resources must match all expressions
+        #   to pass the filters.
+        # @param [Fixnum] max_results
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
+        # @param [String] page_token
+        #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
+        #   a previous list request to get the next page of results.
+        # @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.
+        #   Overrides userIp if both are provided.
+        # @param [String] user_ip
+        #   IP address of the site where the request originates. Use this if you want to
+        #   enforce per-user limits.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeV1::SubnetworkAggregatedList] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeV1::SubnetworkAggregatedList]
+        #
+        # @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 aggregated_subnetwork_list(project, filter: nil, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:get, '{project}/aggregated/subnetworks', options)
+          command.response_representation = Google::Apis::ComputeV1::SubnetworkAggregatedList::Representation
+          command.response_class = Google::Apis::ComputeV1::SubnetworkAggregatedList
+          command.params['project'] = project unless project.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['maxResults'] = max_results unless max_results.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes the specified subnetwork.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] region
+        #   Name of the region scoping this request.
+        # @param [String] subnetwork
+        #   Name of the Subnetwork resource to delete.
+        # @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.
+        #   Overrides userIp if both are provided.
+        # @param [String] user_ip
+        #   IP address of the site where the request originates. Use this if you want to
+        #   enforce per-user limits.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeV1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def delete_subnetwork(project, region, subnetwork, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:delete, '{project}/regions/{region}/subnetworks/{subnetwork}', options)
+          command.response_representation = Google::Apis::ComputeV1::Operation::Representation
+          command.response_class = Google::Apis::ComputeV1::Operation
+          command.params['project'] = project unless project.nil?
+          command.params['region'] = region unless region.nil?
+          command.params['subnetwork'] = subnetwork unless subnetwork.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Returns the specified subnetwork.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] region
+        #   Name of the region scoping this request.
+        # @param [String] subnetwork
+        #   Name of the Subnetwork resource to return.
+        # @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.
+        #   Overrides userIp if both are provided.
+        # @param [String] user_ip
+        #   IP address of the site where the request originates. Use this if you want to
+        #   enforce per-user limits.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeV1::Subnetwork] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeV1::Subnetwork]
+        #
+        # @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 get_subnetwork(project, region, subnetwork, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:get, '{project}/regions/{region}/subnetworks/{subnetwork}', options)
+          command.response_representation = Google::Apis::ComputeV1::Subnetwork::Representation
+          command.response_class = Google::Apis::ComputeV1::Subnetwork
+          command.params['project'] = project unless project.nil?
+          command.params['region'] = region unless region.nil?
+          command.params['subnetwork'] = subnetwork unless subnetwork.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Creates a subnetwork in the specified project using the data included in the
+        # request.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] region
+        #   Name of the region scoping this request.
+        # @param [Google::Apis::ComputeV1::Subnetwork] subnetwork_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.
+        #   Overrides userIp if both are provided.
+        # @param [String] user_ip
+        #   IP address of the site where the request originates. Use this if you want to
+        #   enforce per-user limits.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeV1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def insert_subnetwork(project, region, subnetwork_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:post, '{project}/regions/{region}/subnetworks', options)
+          command.request_representation = Google::Apis::ComputeV1::Subnetwork::Representation
+          command.request_object = subnetwork_object
+          command.response_representation = Google::Apis::ComputeV1::Operation::Representation
+          command.response_class = Google::Apis::ComputeV1::Operation
+          command.params['project'] = project unless project.nil?
+          command.params['region'] = region unless region.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Retrieves a list of subnetworks available to the specified project.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] region
+        #   Name of the region scoping this request.
+        # @param [String] filter
+        #   Sets a filter expression for filtering listed resources, in the form filter=`
+        #   expression`. Your `expression` must be in the format: field_name
+        #   comparison_string literal_string.
+        #   The field_name is the name of the field you want to compare. Only atomic field
+        #   types are supported (string, number, boolean). The comparison_string must be
+        #   either eq (equals) or ne (not equals). The literal_string is the string value
+        #   to filter to. The literal value must be valid for the type of field you are
+        #   filtering by (string, number, boolean). For string fields, the literal value
+        #   is interpreted as a regular expression using RE2 syntax. The literal value
+        #   must match the entire field.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
+        #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
+        #   also filter on nested fields. For example, you could filter on instances that
+        #   have set the scheduling.automaticRestart field to true. In particular, use
+        #   filtering on nested fields to take advantage of instance labels to organize
+        #   and filter results based on label values.
+        #   The Beta API also supports filtering on multiple expressions by providing each
+        #   separate expression within parentheses. For example, (scheduling.
+        #   automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are
+        #   treated as AND expressions meaning that resources must match all expressions
+        #   to pass the filters.
+        # @param [Fixnum] max_results
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
+        # @param [String] page_token
+        #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
+        #   a previous list request to get the next page of results.
+        # @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.
+        #   Overrides userIp if both are provided.
+        # @param [String] user_ip
+        #   IP address of the site where the request originates. Use this if you want to
+        #   enforce per-user limits.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeV1::SubnetworkList] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeV1::SubnetworkList]
+        #
+        # @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_subnetworks(project, region, filter: nil, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:get, '{project}/regions/{region}/subnetworks', options)
+          command.response_representation = Google::Apis::ComputeV1::SubnetworkList::Representation
+          command.response_class = Google::Apis::ComputeV1::SubnetworkList
+          command.params['project'] = project unless project.nil?
+          command.params['region'] = region unless region.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['maxResults'] = max_results unless max_results.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Deletes the specified TargetHttpProxy resource.
         # @param [String] project
         #   Project ID for this request.
@@ -7001,7 +7352,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -7013,10 +7365,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -7059,7 +7411,7 @@ module Google
         # @param [String] project
         #   Project ID for this request.
         # @param [String] target_http_proxy
-        #   Name of the TargetHttpProxy resource whose URL map is to be set.
+        #   The name of the TargetHttpProxy resource to set a URL map for.
         # @param [Google::Apis::ComputeV1::UrlMapReference] url_map_reference_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -7226,7 +7578,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -7238,10 +7591,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -7284,7 +7637,7 @@ module Google
         # @param [String] project
         #   Project ID for this request.
         # @param [String] target_https_proxy
-        #   Name of the TargetHttpsProxy resource whose SSLCertificate is to be set.
+        #   Name of the TargetHttpsProxy resource to set an SSL certificate for.
         # @param [Google::Apis::ComputeV1::TargetHttpsProxiesSetSslCertificatesRequest] target_https_proxies_set_ssl_certificates_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -7376,7 +7729,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -7388,10 +7742,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -7571,7 +7925,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -7583,10 +7938,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -7626,12 +7981,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Adds health check URL to targetPool.
+        # Adds health check URLs to a target pool.
         # @param [String] project
+        #   Project ID for this request.
         # @param [String] region
         #   Name of the region scoping this request.
         # @param [String] target_pool
-        #   Name of the TargetPool resource to which health_check_url is to be added.
+        #   Name of the target pool to add a health check to.
         # @param [Google::Apis::ComputeV1::AddTargetPoolsHealthCheckRequest] add_target_pools_health_check_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -7669,12 +8025,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Adds instance URL to targetPool.
+        # Adds an instance to a target pool.
         # @param [String] project
+        #   Project ID for this request.
         # @param [String] region
         #   Name of the region scoping this request.
         # @param [String] target_pool
-        #   Name of the TargetPool resource to which instance_url is to be added.
+        #   Name of the TargetPool resource to add instances to.
         # @param [Google::Apis::ComputeV1::AddTargetPoolsInstanceRequest] add_target_pools_instance_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -7726,7 +8083,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -7738,10 +8096,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -7780,7 +8138,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified TargetPool resource.
+        # Deletes the specified target pool.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
@@ -7821,7 +8179,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the specified TargetPool resource.
+        # Returns the specified target pool.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
@@ -7862,9 +8220,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the most recent health check results for each IP for the given instance
-        # that is referenced by the given TargetPool.
+        # Gets the most recent health check results for each IP for the instance that is
+        # referenced by the given target pool.
         # @param [String] project
+        #   Project ID for this request.
         # @param [String] region
         #   Name of the region scoping this request.
         # @param [String] target_pool
@@ -7906,8 +8265,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a TargetPool resource in the specified project and region using the
-        # data included in the request.
+        # Creates a target pool in the specified project and region using the data
+        # included in the request.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
@@ -7948,8 +8307,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves a list of TargetPool resources available to the specified project
-        # and region.
+        # Retrieves a list of target pools available to the specified project and region.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
@@ -7965,7 +8323,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -7977,10 +8336,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -8020,12 +8379,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Removes health check URL from targetPool.
+        # Removes health check URL from a target pool.
         # @param [String] project
+        #   Project ID for this request.
         # @param [String] region
-        #   Name of the region scoping this request.
+        #   Name of the region for this request.
         # @param [String] target_pool
-        #   Name of the TargetPool resource to which health_check_url is to be removed.
+        #   Name of the target pool to remove health checks from.
         # @param [Google::Apis::ComputeV1::RemoveTargetPoolsHealthCheckRequest] remove_target_pools_health_check_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -8063,12 +8423,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Removes instance URL from targetPool.
+        # Removes instance URL from a target pool.
         # @param [String] project
+        #   Project ID for this request.
         # @param [String] region
         #   Name of the region scoping this request.
         # @param [String] target_pool
-        #   Name of the TargetPool resource to which instance_url is to be removed.
+        #   Name of the TargetPool resource to remove instances from.
         # @param [Google::Apis::ComputeV1::RemoveTargetPoolsInstanceRequest] remove_target_pools_instance_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -8106,16 +8467,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Changes backup pool configurations.
+        # Changes a backup target pool's configurations.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
         #   Name of the region scoping this request.
         # @param [String] target_pool
-        #   Name of the TargetPool resource for which the backup is to be set.
+        #   Name of the TargetPool resource to set a backup pool for.
         # @param [Google::Apis::ComputeV1::TargetReference] target_reference_object
         # @param [Float] failover_ratio
-        #   New failoverRatio value for the containing target pool.
+        #   New failoverRatio value for the target pool.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -8153,7 +8514,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves an aggregated list of target VPN gateways .
+        # Retrieves an aggregated list of target VPN gateways.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -8167,7 +8528,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -8179,10 +8541,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -8221,13 +8583,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified TargetVpnGateway resource.
+        # Deletes the specified target VPN gateway.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
         #   The name of the region for this request.
         # @param [String] target_vpn_gateway
-        #   Name of the TargetVpnGateway resource to delete.
+        #   Name of the target VPN gateway to delete.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -8262,13 +8624,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the specified TargetVpnGateway resource.
+        # Returns the specified target VPN gateway.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
         #   The name of the region for this request.
         # @param [String] target_vpn_gateway
-        #   Name of the TargetVpnGateway resource to return.
+        #   Name of the target VPN gateway to return.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -8303,8 +8665,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a TargetVpnGateway resource in the specified project and region using
-        # the data included in the request.
+        # Creates a target VPN gateway in the specified project and region using the
+        # data included in the request.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
@@ -8345,8 +8707,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves a list of TargetVpnGateway resources available to the specified
-        # project and region.
+        # Retrieves a list of target VPN gateways available to the specified project and
+        # region.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
@@ -8362,7 +8724,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -8374,10 +8737,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -8546,7 +8909,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -8558,10 +8922,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -8739,7 +9103,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -8751,10 +9116,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -8934,7 +9299,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -8946,10 +9312,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -8993,7 +9359,7 @@ module Google
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
-        #   Name of the zone scoping this request.
+        #   Name of the zone for this request.
         # @param [String] operation
         #   Name of the Operations resource to delete.
         # @param [String] fields
@@ -9032,7 +9398,7 @@ module Google
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
-        #   Name of the zone scoping this request.
+        #   Name of the zone for this request.
         # @param [String] operation
         #   Name of the Operations resource to return.
         # @param [String] fields
@@ -9073,7 +9439,7 @@ module Google
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
-        #   Name of the zone scoping this request.
+        #   Name of the zone for request.
         # @param [String] filter
         #   Sets a filter expression for filtering listed resources, in the form filter=`
         #   expression`. Your `expression` must be in the format: field_name
@@ -9085,7 +9451,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -9097,10 +9464,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.
@@ -9192,7 +9559,8 @@ module Google
         #   filtering by (string, number, boolean). For string fields, the literal value
         #   is interpreted as a regular expression using RE2 syntax. The literal value
         #   must match the entire field.
-        #   For example, filter=name ne example-instance.
+        #   For example, to filter for instances whose name is not equal to example-
+        #   instance, you would use filter=name ne example-instance.
         #   Compute Engine Beta API Only: If you use filtering in the Beta API, you can
         #   also filter on nested fields. For example, you could filter on instances that
         #   have set the scheduling.automaticRestart field to true. In particular, use
@@ -9204,10 +9572,10 @@ module Google
         #   treated as AND expressions meaning that resources must match all expressions
         #   to pass the filters.
         # @param [Fixnum] max_results
-        #   The maximum number of results per page that Compute Engine should return. If
-        #   the number of available results is larger than maxResults, Compute Engine
-        #   returns a nextPageToken that can be used to get the next page of results in
-        #   subsequent list requests.
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than maxResults, Compute Engine returns a
+        #   nextPageToken that can be used to get the next page of results in subsequent
+        #   list requests.
         # @param [String] page_token
         #   Specifies a page token to use. Set pageToken to the nextPageToken returned by
         #   a previous list request to get the next page of results.